Home

Tutorial AppleScript Studio

Partie 8 - Gestion du Bundle -

Etape 2 - Création de l'aide associée

Sous Léopard - xCode 3.0


Pour créer une aide associée à notre application nous avons besoin de :


  1. La création dans un dossier à part des pages html de l'aide.
  2. La connexion "showHelp" dans Interface builder pour le menu.
  3. Installation du dossier aide dans xCode.

La création dans un dossier à part des pages html

Vous créez la structure en html de votre aide dans un dossier à part avec votre logiciel habituelle. Créez autant de page html que vous voulez, avec index.html comme point d'entrée. J'ai appelé ce dossier "MonLogiciel Help" (nomDuProjet Help).


La page d'entrée "index.html" doit avoir impérativement le tag "AppleTitle". J'ai donné la valeur "MonLogiciel Help".


image
Menu Léopard - Photo 10




La connexion "showHelp" dans Interface builder pour le menu

Donnons le nom de notre application à notre aide.


image
Menu Léopard - Photo 20


Notez, la connexion à l'action "showHelp" est déjà là, implicitement créé dans les menus par xCode.

image
Menu Léopard - Photo 30


Si par une fausse manoeuvre il n'y est pas. Pour le remettre, relier votre menu "Help" à "First Responder" avec la touche ctrl enfonçèe.


image
Menu Léopard - Photo 31


Sélectionnez "showHelp", et faite "Save".


image
Menu Léopard - Photo 32


Il n'y a aucune information à donner dans les menus "Attributes" et "AppleScript" de l'inspecteur.




Installation du dossier aide dans xCode

Faisons glisser ce dossier html "MonLogiciel Help" vers xCode, et déposons le dans Resources.


image
Menu Léopard - Photo 42


Ou choisissez par un click droit sur "Resources" "Add" > "Existing Files...".


image
Menu Léopard - Photo 42a


Choisissez impérativement "Create Folder References for any added folders". J'ai jamais réussi avec recurcively l'option usuelle.


image
Menu Léopard - Photo 44


Cliquez sur "Add".


Notez la différence entre "Recursively...." et "Create Folder References ....".



Le résultat
image
Menu Léopard - Photo 46


Faisons le lien entre index.html et xCode en créant dans le fichier "InfoPlist.strings" de "English.Iproj" les paramètres CFBundleHelpBookFolder et CFBundleHelpBookName.


image
Menu Léopard - Photo 54



Localisation

Préparons la future localisation en plusieurs langues.


Sélectionnez votre dossier d'aide dans xCode, et faite Cd+I pour avoir les informations.


image
Menu Léopard - Photo 70


Cliquez sur "Make File Localizable".


image
Menu Léopard - Photo 72


Le résultat
image
Menu Léopard - Photo 74


L'autre solution, pour installer et localiser en une seule étape, c'est de mettre directement votre dossier html d'aide dans le dossier xCode "English.lproj", et faire "Add > Existing File..".



Faite un test en lançant xCode "Build & Go".


Le résultat
image
Menu Léopard - Photo 76


Problèmes potentiels

Pendant mon apprentissage, j'ai eu plusieurs fois ce message.


image
Menu xCode Léopard - Photo 60


Majoritairement cela indique que le dossier html n'a pas été pris en compte correctement par xCode. Il n'y a rien à chercher du côté de Interface Builder, tout est déjà en place à la création du projet. Seul "showHelp" action est nécessaire.


Donc, vérifiez que le bookName correspond bien au tab AppleTitle de index.html.


J'ai pas mal cafouillé. Probablement du à l'option "Copy" qui marche pas correctement pour l'aide. Je m'en suis tiré en repartant à zéro en supprimant le dossier html de xCode, vérifiè et corrigé AppleTitle dans index.html, réintroduit le dossier html avec l'option "Reference...", et tout rentra dans l'ordre.

Je reconnais que ce conseil n'est pas très scientifique, mais c'est comme cela que j'y suis arrivé plus rapidement, en installant à nouveau le dossier html, et surtout en utilisant l'option "Reference...".




Téléchargement

En téléchargement le projet MonLogiciel en version au niveau où nous en sommes du tutoriel MonLogiciel110.zip. Le dossier aide en html est dans "English.lproj".






La suite - Création d'un menu d'appel du site web


Page précédente

Page suivante


Merci de votre visite


UP