Cedric Vincent de Pix’n Bits poursuit la série consacrée au développement iOS sur Mac. Pour l’article du mois de mars, nous allons aborder un sujet souvent problématique, la distribution Ad Hoc et App Store…
Niveau de l’article : Confirmé
Distribution Ad Hoc et App Store avec XCode
(Réalisé sous XCode 4.2.1)
Dans cet article nous allons voir ensemble comment compiler votre application pour la tester sur des iDevices (Ad Hoc). Nous verrons aussi comment soumettre votre application (App Store).
Nous allons admettre que vous connaissez le portail iOS qui permet de créer des profils de déploiement.
Je vous conseille d’utiliser Safari plutôt qu’un autre navigateur afin d’éviter des problèmes de compatibilité.
Nous allons considérer que vous avez déjà déclaré votre identifiant d’application.
Commençons tout de suite.
Première étape, créer le « provisionning » (ou profil)
Allons sur le portail de développement iOS à l’adresse : iOS dev Center
(Il faut ensuite aller dans le menu iOS Provisionning Portal)
Allez dans le menu « Provisionning » : c’est ici que vous allez pouvoir créer votre « provisionning » de distribution Ad Hoc et App Store.
Pour créer votre profil de test (Ad Hoc), il faut cliquer sur l’onglet « Distribution » puis utiliser le bouton [New Profil].
C’est à ce moment là que vous allez pouvoir choisir si vous voulez créer un « provisionning » pour les tests sur des iDevices (Ad Hoc) ou pour l’envoi sur l’App Store.
Dans un premier temps vous allez en créer un pour les tests, pour l’App Store, le seul paramètre qui change est la valeur à sélectionner dans la liste de choix.
- Choisir « Ad Hoc ».
- Saisir le nom du profil (le mieux étant de mettre le nom de l’application et du type de profil, par exemple : Jack Mystery Ad Hoc)
- Choisir dans la liste des appareils ceux qui seront autorisés à tester.
- Créer le profil à l’aide du bouton [Submit], voilà votre profil (ou provisionning ) et enfin prêt à être utilisé.
- Charger ce dernier à l’aide du bouton [Download] qui va apparaître (si ce dernier n’apparaît pas, cliquer à nouveau sur l’onglet « Distribution »)
Remarque : si vous ajoutez des appareils dans votre liste, il faudra éditer votre profil pour les ajouter, ce n’est pas automatique !
Prochaine étape, l’utilisation dans XCode
Prérequis : XCode 4.2.1 (ou ultérieur) est installé et vous avez vos certificats de développement dans XCode.
Il existe plusieurs façons d’arriver au même résultat, toutefois nous allons choisir la plus simple. L’idée et que les Distributions Ad Hoc ou App Store sont compilées de la même manière que la compilation Release, la différence et que l’on signe les exécutable avec notre profil selon le résultat souhaité.
Remarque : même si la compilation est basée sur la configuration « release » vous ne pouvez pas exécuter ( Run ) ces dernières via XCode et le debugger, pour cela il faudra continuer à utiliser la configuration « release ».
1 – Ajout du profil dans XCode
Il faut maintenant ajouter vos profils à XCode avant de pouvoir continuer, pour ce faire, il faut aller dans le menu « Window » puis « Organizer », là s’affichera la fenêtre qui va vous permettre d’effectuer l’ajout.
Cliquer ensuite sur « Devices » en partie haute :
Cliquez alors dans la partie gauche sur « Provisioning Profiles » (c’est là où vous pouvez voir tous vos profils de développement)
Normalement vous trouverez ici, votre profil de développeur. Pour ajouter votre profil Ad Hoc ou App Store, il suffit de glisser le fichier que vous avez précédemment chargé dans la liste de la fenêtre de « l’organizer ».
2 – Configuration de votre projet
Arrivé ici, il va falloir modifier votre projet pour pouvoir générer la fameuse archive de distribution (le fichier *.ipa à envoyer à vos testeurs ou à Apple)
Ouvrez votre projet : cliquez sur votre projet dans la liste de gauche, à droite vous allez avoir deux sections, « PROJECT » et « TARGETS ». Cliquez sur « PROJECT », puis dans le bandeau du haut choisissez « Info ».
Nous allons à présent créer une nouvelle configuration pour générer l’archive correctement.
Pour y arriver, il vous faudra sélectionner « Configurations » puis cliquer sur le petit bouton [+], pour faire apparaître le menu de choix. À ce niveau là vous allez choisir de dupliquer la configuration « Release » (utilisez donc le menu « Duplicate « Release » Configuration ») il faudra alors changer le nom de l’élément qui vient de s’ajouter dans la liste, vous l’appellerez « Distribution ».
Il va falloir maintenant indiquer à XCode de choisir cette configuration pour compiler votre archive. Pour cela allez dans le menu « Product » puis « Edit Scheme… ».
Vérifiez bien que dans les menus du haut vous êtes positionné sur « votre projet » et sur « iOS Device »
Sélectionnez ensuite dans la partie gauche la section « Archive », puis dans la partie de droite il faut alors sélectionner pour « Build Configuration » la configuration que vous avez créée plus haut et qui a été renommée en « Distribution ».
Arrivé ici il ne reste plus qu’à bien sélectionner la « signature » de votre archive pour enfin terminer la configuration de votre projet.
3 – Signer l’archive
Cliquez cette fois sur « Build Settings » dans la partie haute (toujours en étant sur « PROJECT ») affichez le niveau « Basic » et « Combined ».
Allez dans la section « Code Signing », c’est ici que l’on décide de signer avec vos profils les exécutables qui seront créés, et bien sur c’est là que vous allez positionner la signature de votre archive Ad Hoc.
Pour ce faire, sélectionnez dans cette section la ligne à coté de « Any iOS SDK » le profil qui correspond à votre profil Ad Hoc ou App Store (c’est très important de bien faire cette opération)
Voilà l’environnement de votre projet est prêt, il ne reste plus qu’à générer l’archive, de la signer puis de la distribuer avec le profil.
4 – Générez votre Archive (Application) et la distribuer
Nous abordons ici la dernière étape de cet article.
Pour finir, il ne reste plus qu’à générer votre archive via le menu « Product » puis « Archive », la compilation va commencer.
Une fois terminé la fenêtre de « l’organizer » va s’ouvrir et vous afficher votre archive, il ne reste plus qu’à signer l’archive pour pouvoir la partager, pour cela cliquez sur le bouton [Share…].
Une fenêtre va apparaître, dans cette dernière il faudra vérifier que soit sélectionné « iOS App Store Package (.ipa) » pour « Contents », et vérifier que pour la partie « Identity » c’est bien votre profil de signature que vous avez positionné en partie 3 (dans la section « Code signing »)
Une fois terminé, une fenêtre va vous demander où enregistrer l’archive qui est a présent un fichier *.ipa.
5 – C’est terminé, ou presque…
C’est enfin terminé, il ne vous reste plus qu’à envoyer ce fichier ipa et le profils Ad Hoc à vos testeurs (le mieux étant de mettre les deux dans un fichier ZIP).
