Mendeklarasikan Izin

Setiap aplikasi Android berjalan dalam kotak pasir dengan akses-terbatas. Jika aplikasi perlu menggunakan sumber daya atau informasi di luar kotak pasirnya, aplikasi harus membuat permintaan izin yang tepat. Anda mendeklarasikan bahwa aplikasi membutuhkan izin dengan mencantumkan izin dalam Manifes Aplikasi.

Bergantung pada seberapa sensitif izin tersebut, sistem mungkin memberikan izin secara otomatis, atau pengguna perangkat mungkin harus mengizinkan permintaan tersebut. Sebagai contoh, jika aplikasi Anda meminta izin untuk menyalakan senter perangkat, sistem akan memberikan izin tersebut secara otomatis. Namun jika aplikasi Anda harus membaca kontak pengguna, sistem meminta pengguna untuk menyetujui izin tersebut. Bergantung pada versi platform, pengguna memberikan izin ketika mereka memasang aplikasi (pada Android 5.1 dan yang lebih rendah) atau saat menjalankan aplikasi (pada Android 6.0 dan yang lebih tinggi).

Menetapkan Izin yang Dibutuhkan Aplikasi Anda

Ketika mengembangkan aplikasi, Anda harus memerhatikan saat aplikasi menggunakan kapabilitas yang memerlukan izin. Biasanya, aplikasi membutuhkan izin setiap kali menggunakan informasi atau sumber daya yang tidak dibuat aplikasi, atau melakukan tindakan yang berdampak pada perilaku perangkat atau aplikasi lain. Misalnya, jika suatu aplikasi harus mengakses internet, menggunakan kamera perangkat, atau menghidupkan dan mematikan Wi-Fi, aplikasi membutuhkan izin yang tepat. Untuk daftar perizinan sistem, lihat Izin Biasa dan Berbahaya.

Aplikasi Anda hanya membutuhkan izin untuk tindakan yang dilakukan secara langsung. Aplikasi Anda tidak membutuhkan izin jika meminta aplikasi lain melakukan tugas atau memberikan informasi. Misalnya, jika aplikasi Anda harus membaca buku alamat pengguna, aplikasi membutuhkan izin READ_CONTACTS. Namun jika aplikasi Anda menggunakan maksud untuk meminta informasi dari Aplikasi kontak pengguna, aplikasi Anda tidak membutuhkan izin, tapi Aplikasi kontak harus memiliki izin itu. Untuk informasi selengkapnya, lihat Pertimbangkan Menggunakan Maksud.

Menambahkan Izin ke Manifes

Untuk mendeklarasikan bahwa aplikasi Anda membutuhkan izin, tempatkan elemen <uses-permission> dalam manifes aplikasi, sebagai anak dari elemen <manifest> tingkat atas. Misalnya, sebuah aplikasi yang perlu mengirimkan pesan SMS akan memiliki baris ini dalam manifesnya:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.snazzyapp">

    <uses-permission android:name="android.permission.SEND_SMS"/>
    

    <application ...>
        ...
    </application>

</manifest>

Perilaku sistem setelah Anda mendeklarasikan izin bergantung pada seberapa sensitif izin itu. Jika izin akses tidak memengaruhi privasi pengguna, sistem akan memberikan izin secara otomatis. Jika suatu izin mungkin memberikan akses ke informasi sensitif pengguna, sistem meminta pengguna untuk menyetujui permintaan tersebut. Untuk informasi selengkapnya tentang berbagai jenis izin, lihat Izin Biasa dan Berbahaya.