Outils pour utilisateurs

Outils du site


public:preparation_env_dev_manuel

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
public:preparation_env_dev_manuel [2020/01/08 10:36]
sebastien.jacquot@univ-fcomte.fr [Téléchargements]
public:preparation_env_dev_manuel [2020/01/17 17:03] (Version actuelle)
sebastien.jacquot@univ-fcomte.fr [3.1) Configuration]
Ligne 1: Ligne 1:
-====== Tutoriel de préparation de l’environnement de développement de TXM ======+====== ​[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"​ 
 + 
 +{{:​public:​txm_sdk..jpa.png?​800|}} 
 + 
 +- 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 
 + 
 +{{:​public:​txm_sdk..groovy.png?​800|}} 
 + 
 +- installer "​Subversive SVN Teeam Provider"​ depuis le repository "​Oxygen - http://​download.eclipse.org/​releases/​oxygen"​ 
 + 
 +{{:​public:​txm_sdk..svn.png?​800|}} 
 + 
 +- une fois le plug-in SVN installé et Eclipse redémarré 
 + 
 +- aller dans "​Window\Preferences\SVN"​ onglet "SVN Connector\Get Connectors..."​ 
 + 
 +{{:​public:​txm_sdk..svn_connectors_1.png?​800|}} 
 + 
 +- installer SVN Kit 1.8.XX 
 + 
 +{{:​public:​txm_sdk..svn_connectors_2.png?​800|}} 
 + 
 +=== 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"​ 
 + 
 +{{:​public:​txm_sdk..import_projects_from_team_set.png?​800|}} 
 + 
 +- 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 
 + 
 +{{:​public:​txm_sdk..launch_product.png?​1000|}} 
 + 
 +- TXM s'​amorce puis provoque une erreur 
 + 
 +{{:​public:​txm_sdk..launch_product_2.png?​600|}} 
 + 
 +- 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 
 + 
 +{{:​public:​txm_sdk..launch_product_3.png?​800|}} 
 + 
 +- 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"​ 
 + 
 +{{:​public:​txm_sdk..launch_product_4.png?​800|}} 
 + 
 +==== 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 ===== ===== Téléchargements =====
public/preparation_env_dev_manuel.1578476186.txt.gz · Dernière modification: 2020/01/08 10:36 par sebastien.jacquot@univ-fcomte.fr