JMRI: Integration with CATS
Author: Bob Jacobsen
Keywords: JMRI technical code Java CATS

# Integration avec CATS

Le Crandic Automated Traffic System (CATS) est une application basée sur JMRI crée par Rodney Black pour la commande et l'exploitation d'un chemin de fer miniature. Il y a plus d'informations sur le site web CATS .

JMRI est une bibliothèque, et CATS est une grande application maintenue séparément qui utilise la bibliothèque. En tant que tel, CATS constitue un important scénario de référence pour les développeurs JMRI car ils peuvent étendre et adapter leur code. CATS doit continuer à travailler pour ses utilisateurs, avec un minimum d' effort pour les développeurs de CATS!

### Intégration pour test

CATS a deux paquets d'arbres, "cats.*" et "developper.*", correspondant à peu près aux deux applications CATS.

Le développement de CATS n'utilise pas un code de référentiel public et le code n'est généralement pas disponible pendant qu'il est en cours de développement. Rodney Black communique régulièrement les disponibilités , y compris le code source, et les archives file.zip sur le site web CATS . voir le lien de téléchargementen bas dela page de la licence CATS.

Au début de 2016, la distribution actuelle de CATS ( 2038 ) oeuvres avec JMRI 4.0.1 au travers des versions test actuelle ( 4.3 ) A partir de cette base, nous voulons garder les compilation CATS au cours du développement continu de JMRI. Les changements qui cassent CATS devraient être traitées par la mise au rencart, au moins pour une version de production JMRI

### Compiler CATS avec JMRI

Téléchargez la source CATS et dépaquetez la. Vous devez obtenir un répertoire "cats" et "designer". ( Desidgner est destiné à être indépendant de JMRI, mais nous compilons ensemble juste au cas où ) Selon la faùon dont vous avez décompressé, vous pourriez trouver ceux-ci dupliqués: cats/cats. Prendre les répertoire "cats" et "designer" du niveau le plus bas et déplacez les directement dans le répertoire JMRI java/src, exemple; aux côtés des applications existantes et répertoires JMRI:

    % ls java/src/

    META-INF   apps   cats   designer   jmri

CATS n'a aucune unité de test, donc il n'y a rien à faire dans le "test" arbre source.

Les règles de compilation Ant compileront ensuite CATS chaque fois que vous compilerezr JMRI lui-même. Cela va vous montrer des erreurs, des avertissements relatifs à l'obsolescence, etc.

Pour simplifier le travail du répertoire JMRI, Les deux répertoires lieés CATS sont ignorés lorsque vous faites des opérations sur le répertoire.

Notez que cela inclut la source CATS au sein de la construction, ainsi n'importe quels fichiers jar que vous créez incluentt aussi CATS. N'utilisez pas les fichier jar à partir d'une construction comme celui-ci à des fins JMRI.

JMRI lui-même a beaucoup d'avertissements d'obsolescence, si vous voulez voir seulement ceux de CATS:

- ant nettoie la compil
- rm -rf java/classes/cats java/classes/designer
- ant -Ddeprecation="on" compile

La première compilation compilera tout. La seconde compilera seulement les sources CATS, ainsi elle vous donnera seulement les avertissement pour cces classes.

### Exécution de CATS depuis une construction JMRI locale

Téléchargez la version la plus récente de CATS dans le bas de la page de la licence CATS. A ce jour (février 2016), c'est le "paquet CATS et concepteur (compatible avec JMRI 4.0.1 à la plus récente - 2,53 Mo)" lien qui donne la version 2038 du CATS.

Déplacez le contenu, incluant les scripts de démarrage "cats.csh" (Linux, Mac OS X) et "cats.bat" (Windows) et autre fichiers associés, dans votre répertoire JMRI de plus haut-niveau.

Si vous avez compilé CATS localement, vous n'avez pas besoin des fichiers cats.jar ou designer.jar.

Puis exécutez le script approprié "cats.csh" (Linux, Mac OS X) et "cats.bat" (Windows)