Cette partie détaille comment mettre à jour la distribution du portail de démonstration depuis les sources. Elle permet notamment de s'assurer que la configuration Maven est correcte.

Elle constitue donc un préalable au déploiement d'un nouveau portlet et à la mise en place des exemples de ce guide.

Procédure de build

L'installation depuis les sources requiert tout d'abord l'installation d'un jdk >= 1.7 et Maven 3 sur le poste de développement.

Téléchargement des sources de la démo

Les sources de la distribution de démonstration, que vous pourrez modifier dans le cadre de ce tutorial sont hébergées sur un serveur SVN public, accessible à l'adresse http://www.osivia.org/repos/osivia-demo/demo/tags/4.2.9 :

Configuration Maven

Afin de récupérer les dépendances nécessaires à la compilation des projets de personnalisation, l'utilitaire Maven doit être configuré.

Le fichier de configuration Maven a modifier se situe à l'emplacement ~/.m2/settings.xml.

Les dépôts supplémentaires peuvent être ajoutés à la configuration Maven à l'aide de profils :

<profile>
    <id>osivia</id>
    <repositories>
        <repository>
            <id>osivia-releases</id>
            <url>http://www.osivia.org/nexus/content/repositories/osivia-releases</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
        <repository>
            <id>osivia-snapshots</id>
            <url>http://www.osivia.org/nexus/content/repositories/osivia-snapshots</url>
            <releases>
                <enabled>false</enabled>
            </releases>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
        </repository>
        <repository>
            <id>osivia-thirdparty</id>
            <name>OSIVIA thirdparty</name>
            <url>http://www.osivia.org/nexus/content/repositories/thirdparty</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
    </repositories>
</profile>

<profile>
    <id>toutatice</id>
    <repositories>
        <repository>
            <id>toutatice-releases</id>
            <name>Toutatice releases</name>
            <url>http://projet.toutatice.fr/nexus/content/repositories/toutatice-releases</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
        <repository>
            <id>toutatice-snapshots</id>
            <name>Toutatice snapshots</name>
            <url>http://projet.toutatice.fr/nexus/content/repositories/toutatice-snapshots</url>
            <releases>
                <enabled>false</enabled>
            </releases>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
        </repository>
    </repositories>
</profile>

<profile>
    <id>nuxeo</id>
    <repositories>
        <repository>
            <id>nuxeo</id>
            <name>Nuxeo</name>
            <url>http://maven.nuxeo.org/public</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
    </repositories>
</profile>

Pour que ces profils soient actifs par défaut, il faut ajouter :

<activeProfiles>
    <activeProfile>osivia</activeProfile>
    <activeProfile>toutatice</activeProfile>
    <activeProfile>nuxeo</activeProfile>
</activeProfiles>

Premier build

La distribution de démonstration est construite depuis le répertoire demo à l'aide de la commande Maven suivante :

mvn clean install -Punpack,pack -Denv=dev

Le résultat se présente sous la forme d'une archive .zip placée dans le répertoire target du projet demo-distribution. Cette procédure permet d'initialiser votre repository maven et pourra vous servir, quand ce sera nécessaire à remettre à jour le portail de démo dans sont intégralité (Mise à jour de l'environnement)

Soyez patient, ce premier build peut prendre plusieurs minutes afin de peupler l'ensemble de votre repository maven à partir des dépendances. Les builds suivants et les exemples de ce guide seront exécutés en quelques secondes. Vous pourrez également compiler et déployer chaque module séparément.

.