Android
Le fichier manifeste
Recherche…
Introduction
Le manifeste est un fichier obligatoire nommé exactement "AndroidManifest.xml" et situé dans le répertoire racine de l'application. Il spécifie le nom de l'application, l'icône, le nom du package Java, la version, la déclaration des activités, les services, les autorisations d'application et d'autres informations.
Déclaration de composants
La tâche principale du manifeste consiste à informer le système des composants de l'application. Par exemple, un fichier manifeste peut déclarer une activité comme suit:
<?xml version="1.0" encoding="utf-8"?>
<manifest ... >
<application android:icon="@drawable/app_icon.png" ... >
<activity android:name="com.example.project.ExampleActivity"
android:label="@string/example_label" ... >
</activity>
...
</application>
</manifest>
Dans l'élément <application>
, l'attribut android:icon
pointe vers les ressources pour une icône identifiant l'application.
Dans l'élément, l'attribut android:name
spécifie le nom de classe complet de la sous-classe Activity et l'attribut android: label spécifie une chaîne à utiliser comme étiquette visible par l'utilisateur pour l'activité.
Vous devez déclarer tous les composants de l'application de cette manière:
- éléments <activity>
pour activités
- éléments <service>
pour les services
- Éléments <receiver>
pour récepteurs de diffusion
- Éléments <provider>
pour les fournisseurs de contenu
Les activités, services et fournisseurs de contenu que vous incluez dans votre source mais ne déclarent pas dans le manifeste ne sont pas visibles pour le système et ne peuvent donc jamais être exécutés. Toutefois, les récepteurs de diffusion peuvent être soit déclarés dans le manifeste, soit créés dynamiquement dans le code (objets BroadcastReceiver
) et enregistrés avec le système en appelant registerReceiver()
.
Pour plus d'informations sur la structure du fichier manifeste pour votre application, voir la documentation sur le fichier AndroidManifest.xml.
Déclaration des autorisations dans votre fichier manifeste
Toute autorisation requise par votre application pour accéder à une partie protégée de l'API ou pour interagir avec d'autres applications doit être déclarée dans votre fichier AndroidManifest.xml
. Ceci est fait en utilisant la <uses-permission />
.
Syntaxe
<uses-permission android:name="string"
android:maxSdkVersion="integer"/>
android: name: c'est le nom de l'autorisation requise
android: maxSdkVersion: le niveau d'API le plus élevé auquel cette autorisation doit être accordée pour votre application. La définition de cette autorisation est facultative et ne doit être définie que si l'autorisation requise par votre application n'est plus nécessaire à un certain niveau d'API.
Exemple d'AndroidManifest.xml:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.android.samplepackage">
<!-- request internet permission -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- request camera permission -->
<uses-permission android:name="android.permission.CAMERA"/>
<!-- request permission to write to external storage -->
<uses-permission
android:name="android.permission.WRITE_EXTERNAL_STORAGE"
android:maxSdkVersion="18" />
<application>....</application>
</manifest>
* Voir aussi la rubrique Autorisations .