Préparation d'une application Android pour son déploiement
Remonter à Développement d'applications mobiles Android
Votre app Android est déployée quand vous l'exécutez sur un périphérique cible Android. Vous pouvez aussi utiliser le Gestionnaire de déploiement pour gérer les fichiers déployés. Lorsque votre application Android est prête pour le déploiement final, vous pouvez construire et signer votre application. Voir Déploiement de votre application Android signée.
Sommaire
Configuration des options pour le déploiement de votre app Android
Vous devez configurer plusieurs options pour votre app Android avant de construire l'application pour la distribution. Les propriétés que vous configurez sont fournies avec votre application, dans le fichier AndroidManifest.xml
. Vous ne pouvez pas modifier ces propriétés après avoir construit et signé votre application. Parce que ces propriétés fournissent des informations essentielles concernant votre application, vous devez vous assurer qu'elles contiennent des valeurs correctes avant de déployer votre application. Dans le cas contraire, il se peut que vous deviez reconstruire votre application pour changer les valeurs configurées.
Avant chaque release de votre application Android, vous devez vérifier que chaque paramètre est correctement configuré.
Pour configurer votre app Android :
- Sur la page Projet > Options > Application, fournissez les icônes et images représentant votre application.
- Sur la page Projet > Options > Informations de version, augmentez le code de version de votre application. Les magasins d'applications comme Google Play peuvent nécessiter que les nouvelles versions de votre application aient toujours un code de version supérieur aux versions précédentes.
- Sur la page Projet > Options > Permissions d'utilisation, définissez les permissions requises par votre application pour fonctionner.
- Si vous le souhaitez, vous pouvez déclarer des fonctionnalités comme facultatives.
- Sur la page Projet > Options > Approvisionnement, sélectionnez dans Cible la configuration de construction que vous voulez utiliser pour déployer votre application (par exemple, Release) et fournissez un fichier magasin de clés si vous n'en avez pas déjà créé un. Cette étape est nécessaire afin d'installer votre application dans un périphérique ayant le débogage USB désactivé et de distribuer votre application. Pour de plus amples informations sur les fichiers magasin de clés, voir : http://docs.oracle.com/javase/1.5.0/docs/api/java/security/KeyStore.html (EN).
Personnalisation de votre fichier AndroidManifest.xml
RAD Studio écrit les options de votre application Android dans un fichier Android spécial, AndroidManifest.xml, qui est inclus dans votre package Android final quand vous déployez votre application pour Android. Ce fichier définit des informations comme le code de version ou le nom d'affichage de votre application, la liste des permissions requises par votre application, etc.
Généralement, vous n'avez pas besoin de modifier ce fichier, et vous pouvez laisser RAD Studio s'occuper de tout. Néanmoins, RAD Studio vous permet de personnaliser le contenu du fichier AndroidManifest.xml
si vous devez inclure dans ce fichier des données personnalisées que vous ne pouvez pas définir visuellement dans vos options de projet.
Quand vous construisez une application pour la plate-forme cible Android pour la première fois, RAD Studio ajoute un fichier au dossier de votre projet : AndroidManifest.template.xml
. Chaque fois que vous construisez votre application pour Android, RAD Studio lit ce fichier, remplace des espaces réservés du fichier par les valeurs réelles de vos options de projet, et écrit le contenu résultant dans un fichier de sortie : Android\<build configuration>\AndroidManifest.xml
. Ce fichier de sortie est le fichier AndroidManifest.xml qui est inclus dans le package Android que RAD Studio génère quand vous déployez votre application pour la plate-forme cible Android.
Pour personnaliser le fichier de sortie AndroidManifest.xml
d'un projet unique, modifiez le contenu de AndroidManifest.template.xml
.
Le fichier AndroidManifest.template.xml
que RAD Studio ajoute à un projet quand vous construisez ce projet pour la plate-forme cible Android pour la première fois provient de C:\Users\<nom d'utilisateur>\AppData\Roaming\Embarcadero\BDS\17.0\AndroidManifest.xml
. Si vous voulez que vos nouveaux projets utilisent un autre fichier AndroidManifest.template.xml
de démarrage, modifiez ce fichier.
Déclaration de fonctionnalités comme facultatives
Lorsque vous construisez votre application Android, une liste des fonctionnalités requises est automatiquement créée selon les permissions déclarées. Cette liste est uniquement fournie à titre informatif et elle n'empêche pas l'installation d'une application sur un périphérique. Certains services, comme Google Play, utilisent cette liste pour filtrer les applications qui sont visibles aux utilisateurs. Les utilisateurs peuvent de cette façon ne voir et ne télécharger que les applications qui sont compatibles avec leur périphérique. Toutes les fonctionnalités nécessaires à votre application sont déclarées comme requises par défaut, ce qui rend votre application incompatible avec les périphériques qui ne prennent pas en charge ces fonctionnalités.
Si votre application ne requiert pas une certaine fonctionnalité pour fonctionner (mais a besoin de cette fonctionnalité pour des fonctions non essentielles), vous pouvez déclarer cette fonctionnalité comme facultative. Pour déclarer une fonctionnalité comme facultative, vous devez spécifier explicitement cette fonctionnalité comme non requise dans le manifeste de l'application.
Par exemple, pour déclarer que votre application requiert facultativement un accès au microphone, procédez comme suit :
- Assurez-vous que la permission
Enregistrer du son
est définie dans Permissions d'utilisation. - Ajoutez manuellement la ligne suivante à
AndroidManifest.template.xml
après <%uses-permission%> : (voir la section Personnalisation de votre fichier AndroidManifest.xml pour de plus amples informations sur la façon de modifierAndroidManifest.template.xml
) : <uses-feature android:name="android.hardware.microphone" android:required="False"/>- Remarque : Certaines permissions, comme
android.permission.CAMERA
, impliquent plusieurs exigences de fonctionnalité. Pour de plus amples informations, lisez Permissions that Imply Feature Requirements (EN).
- Remarque : Certaines permissions, comme
Voir Features Reference (EN) pour obtenir une liste complète des fonctionnalités matérielles et logicielles prises en charge par la release de plate-forme la plus récente.