Pour créer une aide associée à notre application nous avons besoin de :
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".
Donnons le nom de notre application à notre aide.
Notez, la connexion à l'action "showHelp" est déjà là, implicitement créé dans les menus par xCode.
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.
Sélectionnez "showHelp", et faite "Save".
Il n'y a aucune information à donner dans les menus "Attributes" et "AppleScript" de l'inspecteur.
Faisons glisser ce dossier html "MonLogiciel Help" vers xCode, et déposons le dans Resources.
Ou choisissez par un click droit sur "Resources" "Add" > "Existing Files...".
Choisissez impérativement "Create Folder References for any added folders". J'ai jamais réussi avec recurcively l'option usuelle.
Cliquez sur "Add".
Notez la différence entre "Recursively...." et "Create Folder References ....".
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.
Préparons la future localisation en plusieurs langues.
Sélectionnez votre dossier d'aide dans xCode, et faite Cd+I pour avoir les informations.
Cliquez sur "Make File Localizable".
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".
Pendant mon apprentissage, j'ai eu plusieurs fois ce message.
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...".
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".
Merci de votre visite
