Nama paket dan ID aplikasi
Elemen root file manifes memerlukan atribut untuk nama paket aplikasi Anda (biasanya cocok dengan struktur direktori proyek Anda - Java namespace).
Misalnya, cuplikan berikut menunjukkan
<manifest>elemen root dengan nama paket"com.example.myapp" :
Code:
<? versi xml = "1.0" encoding = "utf-8" ?>
<manifes xmlns : android = "http://schemas.android.com/apk/res/android"
package = "com.example.myapp"
android: versionCode = "1"
android: versionName = "1.0" >
...
</manifest>
Saat membangun aplikasi Anda ke dalam paket aplikasi final (APK), perangkat build Android menggunakan packageatribut untuk dua hal:
- Itu berlaku nama ini sebagai namespace untuk R.javakelas yang dihasilkan aplikasi Anda (digunakan untuk mengakses sumber daya aplikasiAnda ).
Contoh: Dengan manifes di atas, Rkelas dibuat di com.example.myapp.R.
- Ini menggunakan nama ini untuk menyelesaikan nama kelas relatif apa pun yang dideklarasikan dalam file manifes.
Contoh: Dengan manifes di atas, aktivitas yang dinyatakan sebagai <activity android:name=".MainActivity">telah diselesaikan com.example.myapp.MainActivity.
Komponen aplikasi
Untuk setiap
komponen aplikasi yang Anda buat di aplikasi Anda, Anda harus mendeklarasikan elemen XML yang sesuai di file manifes:
Jika Anda mensubklasifikasikan komponen ini tanpa mendeklarasikannya dalam file manifes, sistem tidak dapat memulainya.
Nama subclass Anda harus ditentukan dengan name atribut, menggunakan penunjukan paket lengkap. Sebagai contoh, sebuah
Activitysubclass dapat dideklarasikan sebagai berikut:
Code:
<manifes ... >
<aplikasi ... >
<activity android: name = "com.example.myapp.MainActivity" ... >
</activity>
</aplikasi>
</manifest>
Namun, jika karakter pertama dalam namenilai adalah titik, nama paket aplikasi (dari atribut
<manifest>elemen
package) diawali dengan nama. Misalnya, nama aktivitas berikut ini diselesaikan ke `" com.example.myapp.MainActivity "`:
Code:
<manifest package = "com.example.myapp" ... >
<aplikasi ... >
<activity android: name = ".MainActivity" ... >
...
</activity>
</aplikasi>
</manifest>
Jika Anda memiliki komponen aplikasi yang berada di dalam sub-paket (seperti dicom.example.myapp.purchases), namenilainya harus menambahkan nama sub-paket yang hilang (seperti ".purchases.PayActivity") atau menggunakan nama paket yang sepenuhnya memenuhi syarat.
Filter niat
Aktivitas aplikasi, layanan, dan penerima siaran diaktifkan oleh
maksud . Maksud adalah pesan yang didefinisikan oleh
Intentobjek yang menggambarkan tindakan yang harus dilakukan, termasuk data yang akan ditindaklanjuti, kategori komponen yang harus melakukan tindakan, dan instruksi lainnya.
Ketika suatu aplikasi mengeluarkan maksud ke sistem, sistem menemukan komponen aplikasi yang dapat menangani maksud berdasarkan deklarasi
filter maksud dalam file manifes masing-masing aplikasi. Sistem meluncurkan instance komponen yang cocok dan meneruskan
Intentobjek ke komponen itu. Jika lebih dari satu aplikasi dapat menangani maksudnya, maka pengguna dapat memilih aplikasi mana yang akan digunakan.
Komponen aplikasi dapat memiliki sejumlah filter maksud (ditentukan dengan
<intent-filter> elemen), masing-masing menggambarkan kemampuan komponen yang berbeda.
Untuk informasi lebih lanjut, lihat dokumen
Intents and Intent Filter .
Ikon dan label
Sejumlah elemen manifes memiliki icondan label atribut masing-masing untuk menampilkan ikon kecil dan label teks, kepada pengguna untuk komponen aplikasi yang sesuai.
Dalam setiap kasus, ikon dan label yang diatur dalam elemen induk menjadi default icondan labelnilai untuk semua elemen anak. Misalnya, ikon dan label yang diatur dalam
<application> elemen adalah ikon dan label default untuk setiap komponen aplikasi (seperti semua aktivitas).
Ikon dan label yang diatur dalam komponen
<intent-filter> ditampilkan kepada pengguna setiap kali komponen tersebut disajikan sebagai opsi untuk memenuhi maksud. Secara default, ikon ini diwarisi dari ikon mana saja yang dideklarasikan untuk komponen induk ( elemen
<activity>atau
<application>), tetapi Anda mungkin ingin mengubah ikon untuk filter maksud jika ikon ini memberikan tindakan unik yang ingin Anda indikasikan dengan lebih baik di dialog pemilih. Untuk informasi lebih lanjut, lihat
Izinkan Aplikasi Lain untuk Memulai Aktivitas Anda .
Izin
Aplikasi Android harus meminta izin untuk mengakses data pengguna yang sensitif (seperti kontak dan SMS) atau fitur sistem tertentu (seperti kamera dan akses internet). Setiap izin diidentifikasi oleh label unik. Misalnya, aplikasi yang perlu mengirim pesan SMS harus memiliki baris berikut dalam manifes:
Code:
<manifes ... >
<menggunakan-izin android: name = "android.permission.SEND_SMS" />
...
</manifest>
Dimulai dengan Android 6.0 (API level 23), pengguna dapat menyetujui atau menolak beberapa izin aplikasi saat runtime. Tetapi apa pun versi Android yang didukung aplikasi Anda, Anda harus mendeklarasikan semua permintaan izin dengan
<uses-permission> elemen di manifes. Jika izin diberikan, aplikasi dapat menggunakan fitur yang dilindungi. Jika tidak, upaya untuk mengakses fitur tersebut gagal.
Aplikasi Anda juga dapat melindungi komponennya sendiri dengan izin. Itu dapat menggunakan salah satu izin yang ditentukan oleh Android, sebagaimana tercantum dalam
android.Manifest.permission, atau izin yang dinyatakan di aplikasi lain. Aplikasi Anda juga dapat menentukan izinnya sendiri. Izin baru dideklarasikan dengan
<permission> elemen.
Untuk informasi lebih lanjut, lihat
Tinjauan Izin .
Kompatibilitas perangkat
File manifes juga tempat Anda dapat mendeklarasikan jenis fitur perangkat keras atau perangkat lunak apa yang dibutuhkan aplikasi Anda, dan dengan demikian, jenis perangkat yang kompatibel dengan aplikasi Anda. Google Play Store tidak mengizinkan aplikasi Anda diinstal pada perangkat yang tidak menyediakan fitur atau versi sistem yang dibutuhkan aplikasi Anda.
Ada beberapa tag manifes yang menentukan perangkat mana yang kompatibel dengan aplikasi Anda. Berikut ini adalah beberapa tag yang paling umum.
<penggunaan-Fitur>
The elemen memungkinkan Anda untuk menyatakan hardware dan software fitur kebutuhan aplikasi Anda. Misalnya, jika aplikasi Anda tidak dapat mencapai fungsionalitas dasar pada perangkat tanpa sensor kompas, Anda dapat mendeklarasikan sensor kompas seperti yang dipersyaratkan dengan tag manifes berikut:
<uses-feature>
Code:
<manifes ... >
<menggunakan-fitur android: name = "android.hardware.sensor.compass"
android: required = "true" />
...
</manifest>
note: Jika Anda ingin membuat aplikasi Anda tersedia di Chromebook, ada beberapa batasan fitur perangkat keras dan perangkat lunak yang harus Anda pertimbangkan.
Setiap versi platform berurutan sering menambahkan API baru yang tidak tersedia di versi sebelumnya. Untuk menunjukkan versi minimum yang kompatibel dengan aplikasi Anda, manifes Anda harus menyertakan
<uses-sdk>tag dan
minSdkVersion atributnya.
Namun, berhati-hatilah bahwa atribut dalam
<uses-sdk>elemen tersebut ditimpa oleh properti terkait dalam
build.gradlefile. Jadi jika Anda menggunakan Android Studio, Anda harus menentukan minSdkVersiondantargetSdkVersionnilai di sana sebagai gantinya:
Code:
android {
defaultConfig {
applicationId 'com.example.myapp'
// Tetapkan level API minimum yang diperlukan untuk menjalankan aplikasi.
minSdkVersi 15
// Menentukan level API yang digunakan untuk menguji aplikasi.
targetSdkVersion 28
...
}
}
Untuk informasi lebih lanjut tentang build.gradlefile, baca tentang
cara mengkonfigurasi build Anda .
Untuk mempelajari lebih lanjut tentang cara mendeklarasikan dukungan aplikasi Anda untuk perangkat yang berbeda, lihat
Ikhtisar Kompatibilitas Perangkat .
Konvensi file
Bagian ini menjelaskan konvensi dan aturan yang umumnya berlaku untuk semua elemen dan atribut dalam file manifes.
ElemenHanya yang
<manifest>dan
<application> elemen yang diperlukan. Mereka masing-masing harus terjadi hanya sekali. Sebagian besar elemen lain dapat muncul nol kali atau lebih. Namun, beberapa dari mereka harus hadir untuk membuat file manifes berguna.
Semua nilai ditetapkan melalui atribut, bukan sebagai data karakter dalam suatu elemen.
Elemen-elemen pada level yang sama umumnya tidak dipesan. Sebagai contoh,
<activity>,
<provider>, dan
<service> elemen dapat ditempatkan dalam urutan apapun. Ada dua pengecualian utama untuk aturan ini:
AtributSecara teknis, semua atribut bersifat opsional. Namun, banyak atribut harus ditentukan agar suatu elemen dapat mencapai tujuannya. Untuk atribut yang benar-benar opsional,
dokumentasi referensi menunjukkan nilai default.
Kecuali untuk beberapa atribut
<manifest> elemen root , semua nama atribut dimulai dengan android:awalan. Sebagai contoh android:alwaysRetainTaskState,. Karena awalan bersifat universal, dokumentasi biasanya menghilangkannya ketika merujuk ke atribut dengan nama.
Nilai bergandaJika lebih dari satu nilai dapat ditentukan, elemen ini hampir selalu diulang, daripada beberapa nilai yang terdaftar dalam satu elemen. Misalnya, filter maksud dapat mendaftar beberapa tindakan:
Code:
<intent-filter ... >
<action android: name = "android.intent.action.EDIT" />
<action android: name = "android.intent.action.INSERT" />
<action android: name = "android.intent.action.DELETE" />
...
</intent-filter>
Nilai sumber dayaBeberapa atribut memiliki nilai yang ditampilkan kepada pengguna, seperti judul untuk suatu aktivitas atau ikon aplikasi Anda. Nilai untuk atribut ini mungkin berbeda berdasarkan bahasa pengguna atau konfigurasi perangkat lain (seperti untuk memberikan ukuran ikon yang berbeda berdasarkan kepadatan piksel perangkat), sehingga nilai harus ditetapkan dari sumber daya atau tema, alih-alih dengan kode-keras ke dalam file manifes. Nilai aktual kemudian dapat berubah berdasarkan
sumber daya alternatif yang Anda berikan untuk konfigurasi perangkat yang berbeda.
Sumber daya dinyatakan sebagai nilai dengan format berikut:
Anda dapat menghilangkan nama paket jika sumber daya disediakan oleh aplikasi Anda (termasuk jika itu disediakan oleh ketergantungan perpustakaan, karena
sumber daya perpustakaan digabungkan ke dalam milik Anda ). Satu-satunya nama paket yang valid adalah android, ketika Anda ingin menggunakan sumber daya dari kerangka kerja Android.
The tipe adalah jenis sumber daya, seperti
stringatau
drawable, dan nama adalah nama yang mengidentifikasi sumber daya tertentu. Berikut ini sebuah contoh:
Code:
<activity android: icon = "@ drawable / smallPic" ... >
Untuk menerapkan nilai yang didefinisikan dalam
tema , ?alih-alih karakter pertama harus bukannya @:
Nilai stringDi mana nilai atribut adalah string, Anda harus menggunakan garis miring terbalik ganda ( \\) untuk keluar dari karakter, seperti \\nuntuk baris baru atau \\uxxxxuntuk karakter Unicode.
Referensi elemen manifes
Tabel berikut menyediakan tautan ke dokumen referensi untuk semua elemen yang valid dalam AndroidManifest.xmlfile.
| |
| <action> | Menambahkan tindakan ke filter maksud. |
| <activity> | Deklarasikan komponen aktivitas. |
| <activity-alias> | Nyatakan alias untuk suatu aktivitas. |
| <application> | Deklarasi aplikasi. |
| <category> | Menambahkan nama kategori ke filter maksud. |
| <compatible-screens> | Menentukan setiap konfigurasi layar yang dengannya aplikasi tersebut kompatibel. |
| <data> | Menambahkan spesifikasi data ke filter maksud. |
| <grant-uri-permission> | Menentukan himpunan bagian dari data aplikasi yang diizinkan untuk diakses oleh penyedia konten induk. |
| <instrumentation> | Deklarasikan Instrumentationkelas yang memungkinkan Anda untuk memonitor interaksi aplikasi dengan sistem. |
| <intent-filter> | Menentukan jenis niat yang dapat ditanggapi oleh suatu aktivitas, layanan, atau penerima siaran. |
| <manifest> | Elemen root dari file AndroidManifest.xml. |
| <meta-data> | Pasangan nilai-nama untuk item tambahan, data arbitrer yang dapat dipasok ke komponen induk. |
| <path-permission> | Menentukan jalur dan izin yang diperlukan untuk subkumpulan data tertentu dalam penyedia konten. |
| <permission> | Menyatakan izin keamanan yang dapat digunakan untuk membatasi akses ke komponen atau fitur tertentu dari ini atau aplikasi lain. |
| <permission-group> | Menyatakan nama untuk pengelompokan logis dari izin terkait. |
| <permission-tree> | Menyatakan nama dasar untuk pohon izin. |
| <provider> | Deklarasikan komponen penyedia konten. |
| <receiver> | Menyatakan komponen penerima siaran. |
| <service> | Deklarasikan komponen layanan. |
| <supports-gl-texture> | Menyatakan format kompresi tekstur GL tunggal yang didukung aplikasi. |
| <supports-screens> | Nyatakan ukuran layar yang didukung aplikasi Anda dan aktifkan mode kompatibilitas layar untuk layar yang lebih besar dari yang didukung aplikasi Anda. |
| <uses-configuration> | Menunjukkan fitur input spesifik yang dibutuhkan aplikasi. |
| <uses-feature> | Menyatakan satu fitur perangkat keras atau perangkat lunak yang digunakan oleh aplikasi. |
| <uses-library> | Menentukan perpustakaan bersama yang harus ditautkan dengan aplikasi. |
| <uses-permission> | Menentukan izin sistem yang harus diberikan pengguna agar aplikasi dapat beroperasi dengan benar. |
| <uses-permission-sdk-23> | Menentukan bahwa aplikasi menginginkan izin tertentu, tetapi hanya jika aplikasi diinstal pada perangkat yang menjalankan Android 6.0 (API level 23) atau lebih tinggi. |
| <uses-sdk> | Memungkinkan Anda mengekspresikan kompatibilitas aplikasi dengan satu atau lebih versi platform Android, melalui integer tingkat API. |
Contoh file manifes
XML di bawah ini adalah contoh sederhana AndroidManifest.xmlyang menyatakan dua aktivitas untuk aplikasi.
Code:
<?xml version="1.0" encoding="utf-8"?>
<manifest
xmlns:android="http://schemas.android.com/apk/res/android"
android:versionCode="1"
android:versionName="1.0"
package="com.example.myapp">
<!-- Beware that these values are overridden by the build.gradle file -->
<uses-sdk android:minSdkVersion="15" android:targetSdkVersion="26" />
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:roundIcon="@mipmap/ic_launcher_round"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<!-- This name is resolved to com.example.myapp.MainActivity
based upon the package attribute -->
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<activity
android:name=".DisplayMessageActivity"
android:parentActivityName=".MainActivity" />
</application>
</manifest>
enunjuk sumber daya ke 
alam Java: R.string.string_name
