Android
Het manifestbestand
Zoeken…
Invoering
Het manifest is een verplicht bestand met de naam "AndroidManifest.xml" en bevindt zich in de hoofdmap van de app. Het specificeert de app-naam, het pictogram, de naam van het Java-pakket, de versie, de verklaring van activiteiten, services, app-machtigingen en andere informatie.
Componenten declareren
De primaire taak van het manifest is het systeem te informeren over de componenten van de app. Een manifestbestand kan bijvoorbeeld een activiteit als volgt declareren:
<?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>
In het element <application>
verwijst het kenmerk android:icon
naar bronnen voor een pictogram dat de app identificeert.
In het element geeft het kenmerk android:name
de volledig gekwalificeerde klassenaam van de subklasse Activiteit aan en geeft het kenmerk android: label een tekenreeks aan die moet worden gebruikt als het door de gebruiker zichtbare label voor de activiteit.
U moet alle app-componenten op deze manier declareren:
- <activity>
elementen voor activiteiten
- <service>
-elementen voor services
- <receiver>
-elementen voor uitzendontvangers
- <provider>
-elementen voor contentproviders
Activiteiten, services en inhoudsproviders die u in uw bron opneemt, maar niet in het manifest declareert, zijn niet zichtbaar voor het systeem en kunnen daarom nooit worden uitgevoerd. Omroepontvangers kunnen echter ofwel in het manifest worden gedeclareerd of dynamisch in code worden gemaakt (als BroadcastReceiver
objecten) en bij het systeem worden registerReceiver()
door registerReceiver()
aan te roepen.
Zie De bestandsdocumentatie voor AndroidManifest.xml voor meer informatie over het structureren van het manifestbestand voor uw app.
Machtigingen declareren in uw manifestbestand
Elke toestemming die uw toepassing vereist om toegang te krijgen tot een beschermd deel van de API of om te communiceren met andere toepassingen, moet worden aangegeven in uw AndroidManifest.xml
bestand. Dit wordt gedaan met behulp van de tag <uses-permission />
.
Syntaxis
<uses-permission android:name="string"
android:maxSdkVersion="integer"/>
android: name: dit is de naam van de vereiste toestemming
android: maxSdkVersion: het hoogste API-niveau waarop deze toestemming aan uw app moet worden verleend. Het instellen van deze toestemming is optioneel en mag alleen worden ingesteld als de toestemming die uw app vereist niet langer nodig is op een bepaald API-niveau.
Voorbeeld 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>
* Zie ook het onderwerp Machtigingen .