Différences
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
|
tutoriel:comment_publier_une_application_java [Le 01/10/2014, 21:46] ladeche |
tutoriel:comment_publier_une_application_java [Le 11/09/2022, 12:25] (Version actuelle) moths-art Suppression des espaces en fin de ligne (détecté et corrigé via le bot wiki-corrector (https://forum.ubuntu-fr.org/viewtopic.php?id=2067892) |
||
|---|---|---|---|
| Ligne 1: | Ligne 1: | ||
| - | {{tag>wiki wiki:modèle comment_participer}} | + | {{tag>tutoriel java publier application ppa launchpad}} |
| - | ---- | + | ====== Comment publier une application java ====== |
| - | ====== Modèle : page tutoriel ====== | + | ===== Introduction ===== |
| + | Ce tutoriel décrit une méthode pour publier une application java et la rendre installable via un ppa. | ||
| - | <note help>Cette page présente un méthode pour publier une application java pour la rendre installable à partir d'un ppa.</note> | + | A noter que cette méthode peut également être utilisée pour publier une application réalisée dans un autre langage et dont l'installation ne requiert pas une re-compilation des sources. |
| - | <note important> | + | ===== Pré-requis ===== |
| - | </note> | + | |
| + | ===== Compte launchpad et ppa ===== | ||
| + | Il est indispensable de créer un ppa sur launchpad.net. Cette [[http://developer.ubuntu.com/publish/apps/other-forms-of-submitting-apps/ppa/|page]] vous y aidera. | ||
| + | Pour ce faire il faut : | ||
| + | * Se créer un compte sur launchpad.net | ||
| + | * Se créer une clef gpg (à l'aide de SeaHorse ou Kgpg) | ||
| + | * Créer le ppa et le configurer. | ||
| - | ---[ le modèle commence ICI ]--- | + | Pour la suite nous considérons que le launchpad créé est "monlaunchpad" et le ppa "monppa". |
| + | L'email associé est moi@email.com. | ||
| + | ===== Préparation en local ===== | ||
| + | * Créer un répertoire local ou seront construits les builds. Par exemple /home/user/ppa. Appelons le $PPA_HOME. | ||
| + | * Dans $PPA_HOME, créer un sous-répertoire avec le nom de l'application (monappli) | ||
| + | * Puis dans ce dernier répertoire un sous-répertoire avec la version de l'application. A noter que le nom de ce sous-répertoire est formaté : nomappli-version. Ici par exemple monappli-0.1.0. | ||
| + | A l'arrivée on a : | ||
| - | {{tag>Lucid Oneiric tutoriel système gestionnaire_de_paquets BROUILLON}} | + | /home/user/ppa |
| + | |__ monappli | ||
| + | | |___monappli-0.1.0 | ||
| + | | |___monappli-0.2.0 | ||
| + | |__ monapplibis | ||
| - | ---- | ||
| - | <note tip>Les [[:wiki:tags|tags]] d'une page "tutoriel" sont à introduire dans l'ordre suivant :\\ ''Versions((versions d'Ubuntu pour lesquelles la page est valide)) tutoriel autres_tags((facultatif, à choisir parmi les [[:thesaurus|tags existants]])) BROUILLON''\\ | + | Pour la suite nous allons essayer de packager monappli. |
| - | //Pour en savoir plus sur l'usage des tags : [[:wiki:tags|voir ici]].// | + | |
| - | </note> | + | |
| - | ====== Comment faire le café avec Ubuntu? ====== | + | ===== dh_make : initialisation des fichiers debian ===== |
| - | <note important>Il est important de mettre **un et un seul titre de niveau 1** (H1) à toutes vos pages. Ainsi, si une page liste toutes les pages contenant un des tags de cette page, alors cette page pourra être inclue à la liste. Dans le cas contraire, elle ne le pourra pas (et dans ce cas-là, les tags ne servent à rien). :-( | + | Dans le répertoire $PPA_HOME/monappli/monappli-0.1.0 : |
| - | </note> | + | <code> |
| + | dh_make --single --native --copyright apache --email moi@email.com | ||
| + | </code> | ||
| + | A noter que le paramètre "copyright" indique la licence sous laquelle vous souhaitez publier votre oeuvre (ici apache). Pour plus de détails : [[http://developer.ubuntu.com/publish/apps/choosing-a-license/|ici]] | ||
| + | Il est également important que l'email soit le même que celui avec lequel vous avez la clef GPG. | ||
| + | Ceci va créer un sous-répertoire debian contenant différents fichiers. Les fichiers avec les extensions .ex et .EX sont sans intérêts. Donc sous $PPA_HOME/monappli/monappli-0.1.0 : | ||
| + | <code> | ||
| + | rm debian/*.ex debian/*.EX | ||
| + | </code> | ||
| - | <note tip>Rédigez ici une courte introduction à propos du tutoriel.</note> | + | Voyons maintenant les fichiers importants sous $PPA_HOME/monappli/monappli-0.1.0/debian. |
| + | ==== Fichier changelog ==== | ||
| + | Ce fichier contient les informations décrivant les changements opérés depuis la dernière version. Vous devez avoir cela : | ||
| + | <code> | ||
| + | monappli (0.1.0) unstable; urgency=low | ||
| - | Ce tutoriel décrit les logiciels à installer et la démarche à suivre pour faire du café avec Ubuntu. Avec un ordinateur récent cela vous prendra environ 15 minutes. | + | * Initial Release. |
| - | <note important>Chaque section aura **un titre de niveau 2** (H2) puis ses sous-sections, **un titre de niveau 3** (H3) et ainsi de suite… Remarque : il n'y a que 5 niveaux de titre, ce qui devrait être amplement suffisant.</note> | + | -- Moi <moi@email.com> Sat, 04 Oct 2014 19:07:31 +0200 |
| + | </code> | ||
| + | A modifier pour obtenir quelque chose de plus pertinent : | ||
| + | * Remplacer "unstable" par une version d'ubuntu ("trusty" par exemple pour la 14.04). | ||
| + | * Compléter les éléments de modification. | ||
| + | * Changer éventuellement la date en conservant le formalisme. | ||
| + | Finalement : | ||
| + | <code> | ||
| + | monappli (0.1.0) trusty; urgency=low | ||
| - | ===== Pré-requis ===== | + | * Initial Release. |
| + | * Ma première publication | ||
| - | <note tip>Si des pré-requis sont nécessaires pour la suite des opérations, indiquez-les. Citons quelques exemples :</note> | + | -- Moi <moi@email.com> Sun, 05 Oct 2014 21:00:00 +0200 |
| - | * Disposer des [[:sudo|droits d'administration]]. | + | </code> |
| - | * Disposer d'une connexion à Internet configurée et activée. | + | |
| - | * Avoir [[:tutoriel:comment_installer_un_paquet|installé le paquet]] **[[apt>//cafe|cafe]]**. | + | |
| - | ===== Première étape ===== | + | ==== Fichier control ==== |
| + | Ce fichier est un descriptif de l'application et ressemble à cela : | ||
| + | <code> | ||
| + | Source: monappli | ||
| + | Section: unknown | ||
| + | Priority: optional | ||
| + | Maintainer: Moi <moi@email.com> | ||
| + | Build-Depends: debhelper (>= 8.0.0) | ||
| + | Standards-Version: 3.9.4 | ||
| + | Homepage: <insert the upstream URL, if relevant> | ||
| + | #Vcs-Git: git://git.debian.org/collab-maint/test.git | ||
| + | #Vcs-Browser: http://git.debian.org/?p=collab-maint/test.git;a=summary | ||
| - | Tout d'abord, il vous faudra installer les logiciels Bidule et Machin, en faisant bien attention à respecter les consignes suivantes… | + | Package: test |
| + | Architecture: any | ||
| + | Depends: ${shlibs:Depends}, ${misc:Depends} | ||
| + | Description: <insert up to 60 chars description> | ||
| + | <insert long description, indented with spaces> | ||
| + | </code> | ||
| - | ===== Autres étapes ===== | + | Il convient de changer la section. Typiquement on peut mettre "utils". Plus de détails [[https://www.debian.org/doc/debian-policy/ch-archive.html#s-subsections|ici]]. |
| + | Le plus important est la zone "depends" qui décrit les dépendances d'autres paquets. Pour une application java, manifestement on doit dépendre du paquet java. | ||
| + | Au final on a quelque chose comme ça : | ||
| - | Puis... | + | <code> |
| + | Source: monappli | ||
| + | Section: utils | ||
| + | Priority: optional | ||
| + | Maintainer: Moi <moi@email.com> | ||
| + | Build-Depends: debhelper (>= 8.0.0) | ||
| + | Standards-Version: 3.9.4 | ||
| + | Homepage: <insert the upstream URL, if relevant> | ||
| + | #Vcs-Git: git://git.debian.org/collab-maint/test.git | ||
| + | #Vcs-Browser: http://git.debian.org/?p=collab-maint/test.git;a=summary | ||
| - | ===== Conclusion ===== | + | Package: test |
| + | Architecture: any | ||
| + | Depends: ${shlibs:Depends}, ${misc:Depends}, openjdk-7-jre (>=7) | ||
| + | Description: Simple tool. | ||
| + | Simple tool to do whatever you want. | ||
| + | </code> | ||
| - | Voila, vous savez maintenant faire le café avec Ubuntu ! | + | ==== Fichier install ==== |
| + | Ce fichier décrit la destination des différents fichiers composant le paquet lors de l'installation par apt-get install. S'il n'a pas été créé par dh_make il faut le créer. | ||
| + | A l'installation le shell lanceur devra se trouver dans /usr/bin, les autres élements nécessaires à l'exécution dans /usr/lib/monappli. | ||
| + | Typiquement pour une application java on va trouver un jar (monappli-0.1.0.jar) contenant le bytecode, un shell (monappli) pour lancer le programme, éventuellement des ressources comme des images (monappli.png). | ||
| - | ===== Problèmes connus===== | + | Egalement à l'installation on voudra créer un raccourci (monappli.desktop) dans le menu et y associer une icône (monappli_icon.png). |
| + | <code> | ||
| + | monappli /usr/bin | ||
| + | monappli-0.1.0.jar /usr/lib/monappli | ||
| + | monappli.png /usr/lib/monappli | ||
| + | monappli.desktop /usr/share/applications | ||
| + | monappli_icon.png /usr/share/pixmaps | ||
| + | </code> | ||
| - | Si votre café est trop fort, saisissez la commande suivante dans un [[:terminal]]: ... | + | Ci-dessous un exemple de fichier monappli.desktop |
| + | <code> | ||
| + | Version=0.1.0 | ||
| + | Name=monappli | ||
| + | Comment=Simple tool | ||
| + | Exec=monappli | ||
| + | Icon=monappli_icon | ||
| + | Terminal=false | ||
| + | Type=Application | ||
| + | Categories=Utility | ||
| + | Keywords=Utility | ||
| + | StartupNotify=true | ||
| + | </code> | ||
| - | ===== Voir aussi ===== | + | ==== Autres éléments ==== |
| + | Il reste à copier dans le répertoire $PPA_HOME/monappli/monappli-0.1.0 tous les fichiers nécessaires au fonctionnement de l'application (jar, shell, ressources, icône, .desktop, ...). | ||
| + | Vous pouvez également prévoir un répertoire src pour le source. | ||
| - | * **(en)** [[http://bidule.org/projects/bidule/|un autre tutoriel intéressant à propos du café sous linux]] | + | L'ensemble est désormais prêt à être packagé. |
| - | * **(fr, en)** [[http://www.bidule.org|Manuel d'utilisation du logiciel Bidule]] | + | |
| - | * [[http://forum.ubuntu-fr.org/viewtopic.php?id=64840|Discussion "Tutoriel pour faire le café"]] sur le forum ubuntu-fr | + | |
| - | ---- | ||
| - | <note help>Si vous considérez que votre contribution à la page de documentation est significative et/ou que vous souhaitez pouvoir être contacté par les lecteurs, vous avez la possibilité de la signer en ajoutant votre identifiant dans la ligne ci-dessous. Vous pouvez aussi vous abonner aux modifications de la page en cliquant sur "S'abonner à la page" (menu en haut à gauche). | + | ===== debuild : construction du package ===== |
| - | </note> | + | Sous $PPA_HOME/monappli/monappli-0.1.0 : |
| + | <code> | ||
| + | debuild -S | ||
| + | </code> | ||
| + | L'exécution de cette commande crée un ensemble de fichier sous $PPA_HOME/monappli : | ||
| + | * monappli_0.1.0.dsc : descriptif technique du paquet | ||
| + | * monappli_0.1.0_source.build : journal d'exécution du build | ||
| + | * monappli_0.1.0_source.changes : autre descriptif technique du paquet | ||
| + | * monappli_0.1.0.tar.gz : le package proprement dit | ||
| - | //Contributeurs principaux : [[:utilisateurs:votre_identifiant|votre nom ou pseudonyme]], [[:utilisateurs:autre_identifiant|nom ou pseudo autre]].// | + | A noter que lors de l'exécution le programme vous demandera la passphrase que vous avez utilisé pour créer la clef GPG. |
| - | <note help>Si vous vous êtes basé sur un document existant pour écrire votre article, citez la source originale ! Ceci est indispensable afin de respecter les droits d'auteur.</note> | + | ===== dput : upload sur launchpad ===== |
| + | Il ne reste plus qu'à uploader le package sur launchpad.net. Sous $PPA_HOME/monappli/monappli-0.1.0: | ||
| + | <code> | ||
| + | dput ppa:monlaunchpad/monppa ../monappli_0.1.0_source.changes | ||
| + | </code> | ||
| + | A la suite de cette commande, les fichiers (.tar.gz, .dsc, .changes) sont chargés sur launchpad.net. Un mail vous est envoyé sur moi@email.com pour vous indiquer que la paquet a été accepté dans launchpad.net. En vous connectant sur https://launchpad.net/~monlaunchpad/+archive/ubuntu/monppa vous devez voir votre package. | ||
| - | //Basé sur [[http://www.document_source.com|« Titre original de l'article »]] par Auteur Original.// | + | Par contre il n'est pas forcément directement opérationnel car des process en background sur launchpad vont construire des paquets .deb directement opérationnels (1 en amd64, 1 en i386) ce qui peut prendre un peu de temps (de quelques minutes à 1h). |
| + | Cliquer sur le lien "view package details". | ||
| - | ---[ Modèle à copier/coller ]--- | + | Une liste cliquable des paquets apparait. En cliquant sur le lien "monappli-0.1.1", vous voyez apparaitre le détail du package : au minimum un fichier .dsc et un .tar.gz. Si launchpad a déjà effectué son travail vous voyez également un fichier amd64.deb et un i386.deb, sinon il faut attendre. |
| + | ===== Installation du package par le gestionnaire de logiciel ===== | ||
| + | Pour pouvoir installer l'application monappli il faut ajouter le ppa à votre liste : | ||
| <code> | <code> | ||
| + | sudo add-apt-repository ppa:monlaunchpad/monppa | ||
| + | sudo apt-get update | ||
| + | </code> | ||
| + | Il reste à installer l'application via le gestionnaire de logiciel ou via la ligne de commande : | ||
| + | <code> | ||
| + | sudo apt-get install monappli | ||
| + | </code> | ||
| + | ===== Mise à jour des versions ===== | ||
| + | Si vous faites évoluer votre application, pour publier la version suivante, il suffit de copier le sous-répertoire de la dernière version, d'en actualiser le contenu (fichiers changelog, control, install, ...) et de reprendre les commandes depuis l'étape "debuild : construction du package". | ||
| + | Par exemple sous $PPA_HOME/monappli : | ||
| + | <code> | ||
| + | cp -r monappli_0.1.0 monappli_0.2.0 | ||
| </code> | </code> | ||
| + | |||
| + | ===== Voir aussi ===== | ||
| + | |||
| + | * **(en)** [[http://developer.ubuntu.com/publish/apps/other-forms-of-submitting-apps/ppa/|sur le site des développeurs ubuntu]] | ||
| + | * **(en)** [[https://www.ebower.com/docs/ubuntu-ppa/|Tutoriel en anglais dont cette page est largement inspirée]] | ||
| + | |||
| + | ---- | ||
| + | |||
| + | //Contributeurs principaux : [[:utilisateurs:ladeche|ladeche]]// | ||
| + | |||
| + | |||