Outils pour utilisateurs

Outils du site


Panneau latéral

public:preparation_env_dev_manuel

Ceci est une ancienne révision du document !


[Nouvelle version en cours de rédaction] Tutoriel de préparation de l’environnement de développement de TXM

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

- installer Eclipse for RCP and RAP Developers (Version: Oxygen.3a Release (4.7.3a), 64bit) depuis : https://www.eclipse.org/downloads/packages/release/oxygen/3a/eclipse-rcp-and-rap-developers

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

- installer “Dali Java Persistence Tools - EclipseLink JPA Support” depuis le repository “Oxygen - http://download.eclipse.org/releases/oxygen

- installer les outils Groovy (“Eclipse Groovy Development Tools” et “Groovy Compiler 2.5”) depuis le repository : “http://dist.springsource.org/release/GRECLIPSE/e4.7” à ajouter manuellement

- installer “Subversive SVN Teeam Provider” depuis le repository “Oxygen - http://download.eclipse.org/releases/oxygen

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

- aller dans “Window\Preferences\SVN” onglet “SVN Connector\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, lancer un clean dans “Project\Clean…” puis “Clean all projects”

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

- 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”

3.2) Charger un corpus d'exemple

Les corpus d'exemple sont situés dans [Eclipse Workspace]\org.txm.setup\shared\all\samples

———– 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)

4.4) Build multi-plateformes Delta pack ?

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

[Ancienne version] Tutoriel de préparation de l’environnement de développement de TXM

Téléchargements

Eclipse for RCP and RAP Developers

Version: Oxygen.3a Release (4.7.3a)

Manipulations de fichiers

  • Extraire Eclipse, Babel et DeltaPack dans $HOME/Eclipse, les dossiers “eclipse”, “eclipse_babel” et “eclipse_deltapack” ont été créés
  • Lancer Eclipse
  • Ajouter les dossier “eclipse_babel” et “eclipse_deltapack” dans les targets de la page de préférence “Plug-in-development > Target Platform”, sélectionner “Running platform”

Installer les plugins dont dépendent les projets TBX et RCP

Pour installer les plugins, deux solutions :

  • soit besoin en amont de récupérer l'URL, depuis le site du provider du plugin
  • soit parmi le site d'Eclipse correspondant à notre version (ex: Luna), et filtrer avec le nom de ce que l'on cherche (ex: “SVN”)

Dans le menu “Help” > “Install New Software” :

Accepter la licence pour que l'installation se lance enfin

Attendre la fin de l'installation

Plugin What's the use Update Site Site Remarques
SVN pour récupérer les projets TXM (URL du dépôt ?) chercher “SVN” parmi les plugin fournis directement avec Eclipse (ex: http://download.eclipse.org/releases/luna) doc d'installation pour Subversive il faudra installer le connector SVN par la suite lors du premier checkout (connector : SVN 1.5)
JPA pour la persistence dans TXM chercher “eclipselink” parmi les plugins fournis directement avec Eclipse Luna) doc Sélectionner “EclipseLink Target Components”
Groovy pour écrire des scripts http://dist.springsource.org/release/GRECLIPSE/e4.4 https://github.com/groovy/groovy-eclipse/wiki
eTools couche de compatibilité eclipse 3.7 avec eclipse 4+ http://download.vogella.com/luna/e4tools http://e4tools.vogella.com ou voir la page du blog sur le sujet
GWT pour développer le portail https://dl.google.com/eclipse/plugin/4.4 https://developers.google.com/eclipse/docs/getting_started  Il ne faut installer que le compiler utilisé par TXM sinon Eclipse Oxygen ne démarre pas correctement (bug hot swapping) → VERSION 2.5

Les étapes suivantes peuvent être zappées en utilisant une version TXM déjà préparé (voir la page à propos du SDK).

Réglages d'Eclipse

  • API baseline: il faut régler un API baseline par défaut dans les préférences d'Eclipse
  • encodage des fichiers du workspace : UTF-8
  • saut de ligne des fichiers : unix

Récupérer les projets TXM depuis SVN

Récupérer le projet de construction des setups de TXM

https://svn.code.sf.net/p/txm/code/trunk/installers organise les fichiers et propose des scripts Bash (Linux) pour construire les setups pour Linux 32bit, Linux 64bit, Windows 32bit, Windows 64bit et Mac OS X (64bit).

Récupérer les projets d'extension pour TXM

Chaque sous-dossier de https://svn.code.sf.net/p/txm/code/trunk/plugins contient une extension constituée de 2 projets

  • le plugin RCP
  • la feature RCP (à ajouter au projet d'update site)

Les extensions ne sont pas obligatoires pour développer dans TXM.

Utiliser le JRE embarqué de TXM sous Eclipse

Il est conseillé aux développeurs de TXM d'utiliser le JRE dédié à sa configuration dans les projets Eclipse afin de développer dans le même environnement que la cible finale.

  • Télécharger le JRE dédié à votre architecture jvm. Ce répertoire contient les JRE qui sont embarqués dans les différents builds/setups de TXM. Plus de détails ici : JRE embarqués

Démarrer TXM depuis Eclipse

  • Ouvrir le fichier rcpapplication.product
  • Sélectionner la flèche verte en haut à gauche
  • Le 1er lancement échouera car l'argument “-run” est absent
  • Ouvrir la fenêtre des configurations de lancement, menu “Run > Run configurations…”
  • Sélectionner la configuration “rcpapplication.product”
    • plugins
    • argument “-run”

Démarrer TXM portail depuis Eclipse

Utiliser la configuration de lancement “Web application”.

Modes de lancement :

  • Pour lancer en mode debug il faut utiliser le main : com.google.gwt.dev.DevMode
  • Pour lancer en mode host il faut utiliser le main : com.google.gwt.dev.HostedMode

Pour rendre disponible l'application sur le réseau local, il faut rajouter l'argument de lancement : -bindAddress (mon adresse locale)

Installations de CQP et R

Si TXM a été installé, cette section peut-être ignorée.

CQP

R

Pour que TXM puisse utiliser ses fonctionnalités statistiques, il faut au préalable avoir :

  • installer R
  • installer les packages nécéssaires (voir le code R à exécuter ci-dessous) : Rserve, textometry, FactoMineR.
  • indiquer à TXM ou est installer R en modifiant les chemins de préférences avancées : TXM > Avancé > Moteur de statistiques
  • Redémarrer TXM (ou ses moteurs) depuis le menu Fichier.
# FactoMineR dependancy libs
install.packages("MASS", dependencies=TRUE, repos="http://cran.rstudio.com/");
install.packages("nnet", dependencies=TRUE, repos="http://cran.rstudio.com/");
install.packages("car", dependencies=TRUE, repos="http://cran.rstudio.com/");
install.packages("ellipse", dependencies=TRUE, repos="http://cran.rstudio.com/");
install.packages("leaps", dependencies=TRUE, repos="http://cran.rstudio.com/");
install.packages("lattice", dependencies=TRUE, repos="http://cran.rstudio.com/");
install.packages("cluster", dependencies=TRUE, repos="http://cran.rstudio.com/");
install.packages("scatterplot3d", dependencies=TRUE, repos="http://cran.rstudio.com/");
# libs directly used by TXM
install.packages("FactoMineR", dependencies=TRUE, repos="http://cran.rstudio.com/");
install.packages("Rserve", dependencies=TRUE, repos="http://cran.rstudio.com/");
#install.packages("wordcloud", dependencies=TRUE, repos="http://cran.rstudio.com/");
install.packages("textometry", dependencies=TRUE, repos="http://cran.rstudio.com/");
q()
y
public/preparation_env_dev_manuel.1579276963.txt.gz · Dernière modification: 2020/01/17 17:02 par sebastien.jacquot@univ-fcomte.fr