Outils pour utilisateurs

Outils du site


public:preparation_env_dev_manuel

Ceci est une ancienne révision du document !


Tutoriel de préparation de l’environnement de développement de TXM

Nouvelle version en cours de rédaction

Ce tutorial temporaire n'est actuellement complet que pour Linux.

1) Pré-requis

Taille du SDK : environ 2Go

  • système 64bit
  • Linux : Ubuntu 18.04
  • Windows : Windows 7
  • Mac OS X :

2) Installation minimale

WIP: Le but de cette installation est de lancer un TXM dans des conditions très proches d'une installation de TXM depuis un setup livrable. Cette installation du SDK n'est pas suffisante pour builder TXM + Babel.

Le SDK contient :

  • tout ce qui est nécessaire au fonctionnement de TXM (Core, RCP, CQP, R, etc).
  • les extensions TXM
  • les projets liés à la publication de TXM (doc, setup, update site, tests automatisés, etc.)
  • des projets prototypes

Le SDK ne contient pas :

  • les JRE embarqués livrés avec TXM
  • les packs de translations Babel d'Eclipse

2.1) Eclipse et dépendances

2.1.1) Java

Le SDK nécessite Java 1.8. Les versions supérieures ne fonctionnent pas avec le SDK sans manipulations supplémentaires.

🖝 vérifier la version de Java :

  • Linux :
    java -version

Si la version n'est pas la 1.8 :

🖝 installer Java 1.8 :

  • Linux :
    sudo apt install openjdk-8-jdk

🖝 définir Java 1.8 par défaut s'il y a plusieurs versions d'installées

  • Linux :
    sudo update-alternatives --config java

2.1.1 bis) Eclipse

🖝 installer Eclipse for RCP and RAP Developers

2.1.2) Depuis Eclipse, dans "Help > Install New Software"

🖝 installer les 2 outils Groovy “Eclipse Groovy Development Tools” et “Groovy Compiler 2.5”

🖝 installer “Dali Java Persistence Tools - EclipseLink JPA Support”

🖝 installer “Subversive SVN Teeam Provider”

- une fois le plug-in SVN installé et Eclipse redémarré

🖝 aller dans “Window > Preferences > Team > SVN” onglet “SVN Connector” et cliquer sur le bouton “Get Connectors…”

🖝 installer SVN Kit 1.8.XX

2.1.3) Import des projets de TXM depuis le SVN

Durée : environ 20 minutes

🖝 aller dans “File > Import…” puis “Team > Team Project Set”

🖝 sélectionner le mode par URL et renseigner “http://forge.cbp.ens-lyon.fr/svn/txm/tmp/org.txm.core.tests/projectSet.psf

🖝 une fois tous les projets importés, il doit y avoir 45 erreurs (et 3425 warnings) → lancer un clean dans “Project > Clean…” puis “Clean all projects”

🖝 il doit rester 2 erreurs :

Description	Resource	Path	Location	Type
The project was not built since its build path is incomplete. Cannot find the class file for javafx.scene.Scene. Fix the build path then try building this project	org.txm.backtomedia.rcp		Unknown	Java Problem
The type javafx.scene.Scene cannot be resolved. It is indirectly referenced from required .class files	JFXPlayer.java	/org.txm.backtomedia.rcp/src/org/txm/backtomedia/editors/vlcplayer	line 1	Java Problem

3) Lancer TXM

3.1) Configuration

R

Linux

🖝 installer les dépendances de R :

sudo apt-get install libblas3 libgomp1 liblapack3 libpcre3 libgfortran3

🖝 aller dans le répertoire [Eclipse Workspace]/org.txm.statsengine.r.core.linux/res/linux64 et modifier les droits d'exécution :

chmod -R +x .

Création d'une configuration de base de lancement de TXM dans Eclipse

🖝 aller dans le projet “org.txm.rcp” et ouvrir le fichier “rcpapplication.product”

🖝 lancer TXM depuis le bouton vert en forme de flèche “Launch an Eclipse application” en haut à droite de l'onglet

- TXM s'amorce puis provoque une erreur

- fermer la fenêtre d'erreur

Configuration des paramètres de lancement

🖝 aller dans le menu “Run > Run Configurations…”

🖝 dans la configuration nommée “rcpapplication.product” :

🖝 dans “Arguments > Program arguments” ajouter à la fin et précédé d'un espace : -run

3.2) Lancement de TXM

🖝 dans “Plug-ins” cliquer sur “Add Required Plug-ins” pour ajouter automatiquement à la configuration les plug-ins Eclipse nécessaires et cliquer sur “Apply” puis “Run”

L'interface de TXM s'ouvre :

3.3) Chargement d'un corpus exemple

TXM ne peut pas installer les corpus exemples directement, il lui manque l'environnement d'installation complet.

Les corpus exemples sont situés dans [Eclipse Workspace]/org.txm.setups/shared/all/samples

Installation manuelle du corpus VOEUX :

  • dans TXM, charger le fichier [Eclipse Workspace]/org.txm.setups/shared/all/samples/VOEUX.txm avec la commande 'Fichier > Charger > un corpus binaire (.txm)…'

———– WIP: —————————————

4) Installations complémentaires

Ces étapes supplémentaires sont dédiées à pouvoir lancer TXM dans un état similaire à un setup (JRE embarqué, Babel translation pack). Elles sont également destinées à pouvoir builder des setup de TXM. NOTE : pour effectuer des commit sur le SVN de la Forge il faut avoir un compte. –

4.1) JRE embarqué

4.2) Babel

4.3) RessourceBundle Editor (depuis Eclipse Marketplace)

Build de setups & mises à jour

Préparation de la machine

Windows

Installer Ubuntu WSL (Windows Subsystem for Linux) depuis le Microsoft Store : https://ubuntu.com/wsl et https://aka.ms/wslinstall.

Dans bash :

  • régler le mask par défaut à 0022 : umask 0022

Effectuer les préparations Ubuntu suivantes.

Ubuntu

sudo apt install fakeroot

Récupérer les plugins RCP des architectures cibles

Voir A Brief Overview of Building at Eclipse

  • Ouvrir les préférences
  • Editer le target platform dans “Plugin Development > Target platform”
    • sélectionner “Running platform”
    • cliquer sur le bouton “edit…”
    • puis le bouton “add..” de la boite nouvellement ouverte
    • sélectionner “software site” puis “Next”
    • rentrer l'update site des updates Eclipse Oxygen (4.3) : http://download.eclipse.org/eclipse/updates/4.3
    • décocher “Include requiered software” et cocher “Include all environment”
    • sélectionner “Eclipse RCP Target Components” et “Equinox Target Components”
    • finaliser

TODO

  • faire plusieurs Team Set Project ? un pour le core, un pour la RCP et un pour les extensions ?
  • Exporter les Working Set dans le Team Set Project

Team Project Sets :

  • Trunk : Core + RCP
  • Extensions
  • Prototypes
  • Publication (corpus, websites, doc, update sites, setups)

Working Sets :

  • org.txm.core
  • org.txm.rcp
  • org.txm.features
  • org.txm.libs
  • product + update sites + setups + doc +corpus + websites
  • Prototypes

Archive

public/preparation_env_dev_manuel.1585303151.txt.gz · Dernière modification: 2020/03/27 10:59 par matthieu.decorde@ens-lyon.fr