Signer votre application—ArcGIS AppStudio

Les systèmes d'exploitation disposent de procédures de signature qui diffèrent légèrement, mais qui sont conceptuellement identiques. Les applications qui sont distribuées pour être utilisées par d'autres doivent être signées. Même si ArcGIS AppStudio se charge du processus de génération et de signature de l'application, vous devez toujours obtenir des fichiers de signature auprès de chaque fournisseur de système d'exploitation pour les fournir en entrée dans AppStudio.

Préparer une nouvelle application

Avant de signer et de lancer votre application, il faut lui donner un ID de client ArcGIS, une URI de redirection, et une chaîne de licence. Bien qu’il soit possible de générer une application sans ID client ni URI de redirection, ces deux éléments sont importants dans une application utilisant les services ArcGIS.

Un ID du client ArcGIS, également nommé ID d’application, est requis pour la connexion des utilisateurs nommés pour toutes les applications. Pour obtenir un ID de client, accédez à https://developers.arcgis.com, connectez-vous avec vos informations d'identification de développeur, cliquez sur la flèche de la liste déroulante figurant à côté du Dashboard (Tableau de bord) , et sélectionnez New Application (Nouvelle application). Une fois inscrit, vous recevez un ID de client que vous pouvez copier dans votre application AppStudio. Si vous utilisez ArcGIS AppStudio, un ID de client peut également être généré dans Settings (Paramètres), > Licensing (Licenses) en cliquant sur le bouton Register (S'inscrire).

Si votre application requiert une identification d’utilisateur nommé, vous devez également fournir un URI de redirection. Les URI de redirection représentent des emplacements valides vers lesquels l’utilisateur peut être redirigé après avoir effectué une connexion OAuth. Pour ajouter un nouvel URI pour votre application, accédez à l’onglet Authentication (Authentification) pour votre application sur https://developers.arcgis.com. Ici, inscrivez votre application, si ce n’est pas déjà fait et ajoutez votre propre URI de redirection, ou ajoutez urn:ietf:wg:oauth:2.0:oob pour utiliser la page de redirection hébergée pour revenir à votre application sur ArcGIS Online. L’URi urn:ietf:wg:oauth:2.0:oob est également défini automatiquement pour toute application créée et inscrite dans ArcGIS AppStudio.

Une chaîne de licence est requise pour générer des applications utilisant ArcGIS Runtime version 100.x. Une application ne peut être générée sans une chaîne de licence, qui indique également les fonctions de la plateforme ArcGIS que l’application est autorisée à exécuter. Pour plus d’informations sur l’obtention d’une chaîne de licence, consultez la rubrique Octroyez une licence à votre application.

Signer votre application iOS

Toutes les applications iOS doivent être signées. Les applications créées à des fins de test doivent être signées par un certificat de développeur qui est lié à votre compte de développeur Apple et à l'appareil sur lequel vous effectuez les tests. Un certificat de production est lié uniquement à votre compte de développeur Apple.

Avant d’exécuter l’outil Make (Construire) qui se trouve dans le volet latéral de la bibliothèque AppStudio, que ce soit sur le cloud ou en local, vérifiez que vous avez indiqué les informations suivantes dans l’onglet iOS de la section Settings (Paramètres), qui se trouve sous l’en-tête Platforms (Plateformes) :

ID de groupe : utilisez toujours un nom de domaine Internet inversé, par exemple, com.nomsociété.nomapplication. Le nom du paquetage est un identifiant unique de l'application et le nom par défaut du processus de l'application. Une fois votre application publiée, vous ne pouvez pas modifier le nom du paquetage. Pour en savoir plus, reportez-vous à l’explication de l’ID de groupe dans Préparer la distribution de l’application.
Configuration du profil : désigne les appareils sur lesquels vous prévoyez d'exécuter votre application.
Certificat (fichier .p12) : certificat permettant d'effectuer une distribution surApp Store ou en interne. Ce fichier est créé dans Keychain Access. Si vous ne fournissez pas à la fois ces informations et l’ID de groupe dans AppStudio, les fichiers d'installation ne sont pas générés. Pour plus d’informations, reportez-vous à En quoi consiste la signature d’application ?.

Lors de l'exécution de l'outil Construire, vous êtes invité à fournir le mot de passe du certificat.

Pour créer le fichier de certificat requis pour la signature, les étapes suivantes doivent être réalisées une fois par développeur et nécessitent un Mac :

Téléchargez votre certificat de développeur (par exemple, ios_developer.cer) depuis le centre de développement iOS.
Téléchargez votre profil de configuration mobile (par exemple, ios_developer.mobileprovision) depuis le centre de développement iOS.
Utilisez le Finder pour accéder à Applications > Utilities (Utilitaires) > Keychain Access (Trousseaux d’accès).
Importez votre certificat dans Keychain Access.
Dans Keychain Access, dans la liste Keychain, choisissez login, et dans la liste Category, choisissez My Certificates. Choisissez le certificat nommé phone Developer: Your Name et exportez-le avec la clé privée et un mot de passe (par exemple, john_doe_private_key.p12).

Votre fichier de certificat est créé.
Dans AppStudio, accédez à Settings (Paramètres) > Platforms (Plateformes) > iOS.
Définissez le chemin du profil d’approvisionnement.
Définissez le type de distribution de votre application. Pour plus d’informations sur les options, reportez-vous à la documentation Xcode sur les méthodes de distribution.

Remarque :

Double-cliquez sur le fichier de certificat .p12 et le profil d’approvisionnement mobile pour importer les fichiers.

Si vous utilisez AppStudio sur macOS, vous devez configurer deux propriétés supplémentaires pour concevoir des applications iOS avec l’outil Construction en local. Le contenu de ces champs se trouve dans votre certificat de développement ou de distribution, qui est accessible en accédant à l’aide du Finder à Applications > Utilities (Utilitaires) > Keychain Access (Trousseaux d’accès).

Indiquez l’unité d’organisation du certificat dans le champ Team ID (ID de l’équipe).

Fournissez le nom courant du certificat dans le champ Code Signing Identity (Identité de signature du code).

Signer votre application Android

Pour préparer une version Android, vous devez d'abord générer un fichier KeyStore de signature. Pour obtenir des informations détaillées sur la création de ce fichier, consultez la documentation Android.

Avant d’exécuter l’outil Make (Construire), que ce soit sur le cloud ou en local, vérifiez que vous avez indiqué les informations suivantes dans l’onglet Android de la section Settings (Paramètres), qui se trouve sous l’en-tête Platforms (Plateformes) :

Nom du paquetage : utilisez toujours un nom de domaine Internet inversé, par exemple, com.nomsociété.nomapplication. Le nom du paquetage est un identifiant unique de l'application et le nom par défaut du processus de l'application. Une fois votre application publiée, vous ne pouvez pas modifier le nom du paquetage. Pour en savoir plus, consultez l'explication des noms de paquetage dans l'élément de manifeste du SDK Android.
Chemin d'accès au fichier KeyStore : emplacement du fichier KeyStore sur votre machine bureautique.
Alias de clé : nom de la clé généré au moment de la création du fichier KeyStore.

Si vous ne fournissez pas ces informations, vos fichiers d'installation seront créés, mais non signés. Les fichiers non signés peuvent être installés à des fins de test, mais ne peuvent pas être envoyés à Google Play Store ou Amazon Appstore.

Lors de l'exécution de l'outil Construire, vous êtes invité à fournir les mots de passe de clé et KeyStore.

Pour créer un fichier KeyStore, les étapes suivantes doivent être réalisées une fois par développeur :

Téléchargez et installez le Kit de développement Java (JDK) depuis http://www.oracle.com/technetwork/java/javase/downloads/index.html.
Créez une variable d'environnement nommée JAVA_HOME sur votre machine bureautique :http://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/index.html.
Ajoutez le chemin d'accès au dossier bin JDK à votre variable d'environnement PATH.
Dans une fenêtre de commande, utilisez ce qui suit pour créer la clé : keytool -genkey -v -keystore [keystore_name].keystore -alias [alias_name] -keyalg RSA -keysize 2048 -validity 10000, où keystore_name est le nom que vous choisissez pour le fichier KeyStore obtenu et alias_name est le nom que vous choisissez comme alias.
Saisissez un mot de passe KeyStore et vérifiez-le.
Saisissez des informations supplémentaires et vérifiez-les.
Saisissez un mot de passe de clé. Ce mot de passe peut être unique, mais vous pouvez également appuyer sur Entrée pour utiliser le même mot de passe que le mot de passe KeyStore.

Votre fichier KeyStore va être créé dans le dossier où vous avez exécuté cette commande.

Signer votre application macOS

Comme pour Android, si vous ne fournissez pas de certificat lorsque vous demandez des fichiers d'installation macOS, ils seront créés, mais non signés. Les fichiers non signés peuvent être installés à des fins de test, mais ne peuvent pas être envoyés dans le magasin Mac. Les étapes suivantes sont semblables à iOS. Toutefois, un profil de configuration n'est pas nécessaire pour macOS. Pour plus d’informations, reportez-vous à En quoi consiste la signature d’application ?.

Avant d’exécuter l’outil Make (Construire), que ce soit sur le cloud ou en local, vérifiez que vous avez indiqué les informations suivantes dans l’onglet macOS de la section Settings (Paramètres), qui se trouve sous l’en-tête Platforms (Plateformes) :

ID de groupe : utilisez toujours un nom de domaine Internet inversé, par exemple, com.nomsociété.nomapplication. Le nom du paquetage est un identifiant unique de l'application et le nom par défaut du processus de l'application. Une fois votre application publiée, vous ne pouvez pas modifier le nom du paquetage. Pour en savoir plus, reportez-vous à l’explication de l’ID de groupe dans Préparer la distribution de l’application.
Certificat (fichier .p12) : certificat permettant d'effectuer une distribution surApp Store ou en interne. Ce fichier est créé dans Keychain Access. Si vous ne fournissez pas à la fois ces informations et l’ID de groupe dans AppStudio, les fichiers d'installation ne sont pas générés. Pour plus d’informations, reportez-vous à En quoi consiste la signature d’application ?.

Lors de l'exécution de l'outil Construire, vous êtes invité à fournir le mot de passe du certificat.

Pour créer le fichier de certificat requis pour la signature d'une application macOS, suivez les étapes décrites ci-dessus pour les applications iOS.

Signer votre application Windows

Comme pour Android, si vous ne fournissez pas de certificat lorsque vous demandez des fichiers d'installation Windows, ils seront créés, mais non signés.

Avant d’exécuter l’outil Make (Construire), que ce soit sur le cloud ou en local, vérifiez que vous avez indiqué un fichier de certificat dans l’onglet Windows de la section Settings (Paramètres), qui se trouve sous l’en-tête Platforms (Plateformes). Ce certificat (fichier .p12 ou .pfx) permet d’effectuer une distribution via le Windows Store ou en interne. Consultez Créer un certificat de signature de package dans la documentation des développeurs de Microsoft pour plus d’informations.

Vous avez un commentaire à formuler concernant cette rubrique ?