French   English
Mac Java!

Comment créer un programme d’installation pour une Application Java (.jar) sur Mac OS X


Traduit par Pierre Toret, le 5/03/2006

En quelques étapes simples vous pouvez transformer votre programme Swing Java en une application Mac avec programme d’installation intégré.  Les instructions ci-dessous expliquent en détail les étapes du processus à partir d'un exemple simple, une application appelée "Showtime", (Montretemps), qui
Screen
Shot Icons
↓ 
affiche la date, le mois et l'heure.  Lorsque vous aurez terminé le tutorial avec l’exemple proposé, il ne vous restera plus qu’à en modifier les étapes pour qu’elles correspondent à votre programme Java.

1) Installer Xcode

La suite Xcode d’Apple comprend des outils de développement qu’il est nécessaire de posséder pour pouvoir préparer et packager un programme java.  Le CD d’installation "Mac OS X Xcode Tools" est compris dans les CDs "Mac OS X".  Lancer le fichier "XcodeTools.mpkg" contenu dans le CD Xcode pour démarrer l’installation.

Avant de continuer, c’est une bonne idée de faire une mise à jour système et logicielle pour être sûr que tous les fichiers sont correctement actualisés.

2) Lancer le Terminal Unix

Utiliser le "Finder" pour aller dans le dossier "Applications" puis ouvrir le dossier "Utilitaires".  Descendre dans l'affichage de l’arborescence du contenu du dossier jusqu’à ce que vous puissiez voir le programme Terminal.  Lancer alors celui-ci en double-cliquant dessus.  Vous voyez alors apparaître la fenêtre de Terminal avec le prompt d’Unix.

3) Construire le dossier du projet

Après le prompt d’Unix, entrez ces deux commandes:
mkdir ItsShowtime
cd ItsShowtime
La première instruction crée un dossier appelé "ShowTime", (MontreTemps), la seconde vous situe à l’intérieur de ce nouveau dossier.

4) Écrire du Code Java

Mac OS X dispose d’un simple mais efficace éditeur de texte appelé Pico.  Utilisez la commande suivante pour créer et éditer un nouveau fichier Java:
pico ShowTime.java
Puis entrez le code suivant:

ShowTime.java

import java.util.Calendar; import javax.swing.*; public class ShowTime { public static void main(String[] args) { JFrame f = new JFrame(); f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); f.setTitle("It's Showtime!"); f.getContentPane().add(new JLabel( Calendar.getInstance().getTime().toString())); f.pack(); f.setVisible(true); } }

Utilisez <ctrl-x> pour sortir de Pico.

5) Compiler votre Programme Java

De retour au prompt d’Unix, compilez alors votre programme Java dans un fichier class avec les deux commandes suivantes:
javac ShowTime.java
ls -la
Nous pouvons alors lancer directement le fichier class obtenu, mais cette procédure à partir d’un fichier class est habituelle.  A la place de celle-ci, nous allons créer un fichier exécutable JAR.

6) Création du fichier exécutable JAR

Avant de créer le fichier executable JAR, nous avons besoin d'un fichier indicateur qui montre quelle est la classe qui contient la fonction "Main".  Pour cela, nous allons encore utiliser Pico avec l’instruction suivante:
pico MainClass.txt
Le fichier indicateur ne va contenir qu’une ligne:

MainClass.txt

Main-Class: ShowTime

Sortez alors de Pico et utilisez la commande "jar" pour créer le fichier "ShowTime.jar":
jar cmf MainClass.txt ShowTime.jar *.class
ls -la
Maintenant, testez votre fichier exécutable JAR avec la commande:
java -jar ShowTime.jar
La fenêtre "It's Showtime!" avec l’affichage de la date, du mois et de l’heure doit apparaître dans le coin supérieur gauche de votre écran.  Cliquer sur le point rouge pour sortir du programme.

Remarque : Même si les commandes manuelles fonctionnent bien pour les étapes 4 et 5, vous pouvez les automatiser en utilisant Ant avec ce fichier xml : build.xml.

7) Créer l’icone de l’application

L’icone par défaut d’une application JAR est une tasse de café.  Pour ajouter une nouvelle icone, il faut utiliser "Icon Composer".

Premièrement, télécharger et enregistrer (<ctrl-click>) cet exemple d’image au format PNG sur votre "Desktop", (Bureau):  ShowTime.png

Deuxièmement, déplacez ce fichier dans le dossier "ItsShowTime" avec la commande suivante:
mv ../Desktop/ShowTime.png .
Troisièmement, utilisez le finder pour naviguer jusqu’au dossier Utilities, (utilitaires), (chemin : Developer/Application/Utilities) et double cliquez sur l’application "Icon Composer".

Une fois le logiciel lancé, allez dans le menu "File", (Fichier), selectionner "Import Image", (Importer Image).  Localisez ensuite, dans l’arborescence de votre disque, le dossier "ItsShowTime", il se trouve normalement dans votre dossier d’utilisateur, puis sélectionnez le fichier "ShowTime.png".  En ce qui concerne le menu déroulant "Import To", (Importer Pour), choisissez "Small 32bit data", (Petite donnée 32bit) puis cliquez sur "Open", (Ouvrir).  Sélectionnez la version à l’échelle "Use scaled version", (Utiliser la version à l’échelle).  Un nouveau choix vous est alors proposé concernant le masque de l’image : "Extract Mask", (extraire un masque) ou "Don’t extract", (non extraire).  Une fois ce choix effectué, l’image, avec ou sans masque, apparaît ensuite dans les carrés correspondant à sa taille dans la fenêtre principale de l’utilitaire.

Pour être sûr que votre icone s’affichera bien dans toutes les configurations, recommencez le procédé pour "Large 32bit data", (Grande donnée 32bit), "Huge 32bit data", (Très grande donnée 32bit) et "Thumbnail 32bit data", (Miniature donnée 32bit).

Retournez alors au menu "File", (Fichier), choisissez "Save", (Enregistrer) avec comme nom "ShowTime.icns".  Quittez ensuite "Icon Composer".

8) Compresser le fichier JAR

Nous allons créer une application Mac.  En utilisant le "Finder", naviguez jusqu’au dossier "Java Tools", (Outils Java), par le chemin : Developer/Application/Java Tools et double cliquez sur l’application "Jar Bundler".

Suivez alors les dix étapes suivantes:
  1. Pour "Main Class", utiliser le bouton "Choose...", (Choisir...), et en parcourant l’arborescence, choisissez le fichier "ShowTime.jar".
  2. Cochez la première case pour valider l’option "Use Macintosh Menu Bar", (Utiliser la Barre de Menu Macintosh).
  3. Utilisez le bouton "Choose icon", (Choisir icone), puis en parcourant l’arborescence localisez dans votre dossier utilisateur, le dossier "ItsShowTime".
  4. Cliquez sur l’onglet "properties", (propriétés) et entrez 1.0 dans le champ de texte correspondant à la version.
  5. Toujours dans le même onglet des propriétés, entrez également 1.0 dans le champ de texte "Get Info String", (Obtention Chaine d’Info).
  6. Cliquez sur le bouton "Create Application...", (Créer Application...).
  7. Dans le champ de texte correspondant au nom, entrez "Show Time".
  8. Placez-vous dans le dossier "ItsShowTime".
  9. Utilisez le bouton "New Folder", (Nouveau Dossier) pour créer un dossier appelé "Show Time Mac App".
  10. Cliquez sur le bouton "Create", (Créer).
Quit "Jar Bundler".

9) Création du programme d’installation Mac

Nous allons créer un programme d’installation pour l’application Mac.  En utilisant le "Finder", naviguez jusqu’au dossier "PackageMaker", (Préparateur d’Installation), par le chemin : Developer/Application/Utilities et double cliquez sur l’application "PackageMaker".  Remarque : les noms des champs, le nom des onglets et les noms des menus peuvent être légèrement différents pour les versions antérieures à celle de Mac OS X Panther 10.4 mais elles effectuent les mêmes actions.

Suivez alors les neuf étapes suivantes:
  1. Sur le premier écran, sélectionnez "Single Package Project", (Installation Seule pour Projet), et cliquez sur "OK".
  2. Dans le champ "Title:", (Titre:), entrez "Show Time".
  3. Cliquez sur l’onglet "Contents", (Contenu). Utilisez alors le bouton "Root:", (Racine), pour localiser le dossier "Show Time Mac App" et ouvrez-le.
  4. Dans l’onglet "Configuration", (Configuration) et dans le champ "Default Location:", (Localisation par défaut) entrez "/Applications".
  5. Cochez les options "Allow Revert to Previous Version", (Autoriser le retour version précédente) et "Relocatable", (réalouable).
  6. Au niveau de l’onglet "Version", (Version), remplissez les champs suivant:
    Identifier:  com.centerkey.showtime
    Get Info String:  Show Time 1.0
    Version:  1.0
  7. Dans le menu "File", (Fichier), cliquez deux fois sur "Create Package", (Créer Préparateur d’Installation).
  8. Dans le menu "File", (Fichier), cliquez deux fois sur "Save As...", (Enregistrer Sous...), dans le champ texte entrez : "ShowTimeInstaller.pkg".
  9. Naviguez jusqu’au dossier "ItsShowtime", cliquez alors sur le bouton "Save", (Enregistrer).
Lorsque vous quittez l’application, on vous donne la possibilité de sauvegarder les paramètres et options choisies pour le préparateur d’installation que vous venez de créer.

10) Mettre le programme d’installation sur une page internet

Avant de pouvoir mettre à disposition le programme sur internet, nous avons besoin de créer un seul fichier zip du fichier "ShowTimeInstaller.pkg".  Utilisez le "Finder" pour naviguer jusqu'au dossier "ItsShowTime".  Créez alors un zip du fichier "ShowTimeInstaller.pkg" en utilisant l’option archive accessible au menu par <ctrl-click>.

De retour au prompt d’Unix, dans le Terminal, créez une page web de test:
pico download.html
Le code HTML pour cette page sera:

download.html

<html> <body> Download: <a href="ShowTimeInstaller.pkg.zip"> ShowTimeInstaller.pkg.zip</a> </body> </html>

Après avoir enregistré la page web dans un fichier HTML, copiez celle-ci avec le fichier zip dans le dossier de votre serveur web personnel avec la commande:
cp *.html *.zip ../Sites
Maintenant nous avons besoin d’activer le serveur Apache inclus dans le système Mac OS X.

Voici les étapes correspondantes:
  1. Allez dans le menu pomme (), choississez "Préférence Système..."
  2. Dans la section "Internet et réseau", cliquez sur "Partage"
  3. Sélectionnez le service "Partage Web Personnel" en cliquant sur la case à cocher
  4. Cliquez sur le bouton "Démarrer"
Lorsque la case à cocher apparaît juste devant le "Partage Web Personnel", le serveur web Apache est actif.

Lancez Safari et ouvrez l’adresse  http://localhost/~you/download.html  où "you" est le nom d’utilisateur.  Cliquez sur le lien "ShowTimeInstaller.pkg.zip" et l’installation doit démarrer automatiquement après un délai de quelques secondes.

Wrap-Up

Voici l’installateur dans sa version finale.  Vous pouvez l’essayer vous même:
Pour un example qui explique comment vous pouvez distribuer votre installateur, allez voir:
Comment faire si votre application requiert Java 5.0 (J2SE 1.5) pour fonctionner?  Tout va bien:
Si vous souhaitez ajouter un bouton d’accès à votre site internet dans votre application, des éléments de réponse ici:
C’est tout.

Commentaires or Questions

Envoyez un message MacJava
Message:
Nom:
E-Mail:

Powered by PERFECT
Tous les champs de texte sont facultatifs.  Mais si vous souhaitez vraiment une réponse, n’oubliez pas d’indiquer votre adresse d’E-mail.

Random

"Bonjour, information importante, merci beaucoup!  Est-il possible de traduire votre article en français?"   --  P.T., 21 Janvier, 2006

"Grand article!"   --  D., 9 Décembre, 2005

"Merci beaucoup.  Vos instructions sont très concises.  Il y a plein d’informations sur la programmation, mais pas assez sur l’installation et l’empaquetage.  Cette page est une bénédiction."   --  S.B., 21 Octobre, 2005

"C’est une importante information pour la construction des applications Mac"   --  S.S., 11 Octobre, 2005

"article extra!  l’un des plus clair et simple que j’ai eu l’occasion de lire et tout fonctionne à merveille!!"   --  J.B., 9 Septembre, 2005

"Amusant, je n’aurais jamais cru que cela était si facile...  Vous êtes vraiment le meilleur!"   --  M.F., 7 Septembre, 2005

"On ne peut pas être plus clair!"   --  M.H., 13 Août, 2005

"très THX - très utile et très bien organisé."   --  T.W., 9 Août, 2005

"Super! -- vous avez résolu le mystère!"   --  C.M., 27 Juin, 2005

 MacPro:   Skapa installationspaket för en Javaapplikation