Catatan: Dengan dirilisnya Android 9.0 (API level 28), ada
support library versi baru yang disebut
AndroidX, yang merupakan bagian dari Jetpack.
Library AndroidX
berisi support library yang ada, juga menyertakan komponen Jetpack terbaru.
Anda dapat terus menggunakan support library ini.
Artefak historis (versi 27 dan yang lebih lama, serta yang dipaketkan sebagai android.support.*
) akan
tetap tersedia di Google Maven. Namun, semua pengembangan
library baru akan terjadi di library AndroidX.
Kami merekomendasikan penggunaan library AndroidX di semua project baru. Sebaiknya pertimbangkan
juga untuk memigrasikan project yang ada ke AndroidX.
Cara Anda menyiapkan Android Support Library dalam project pengembangan bergantung pada fitur yang ingin Anda gunakan dan rentang versi platform Android yang ingin Anda dukung dengan aplikasi Anda.
Dokumen ini memandu Anda mendownload paket Library Dukungan dan menambahkan library ke lingkungan pengembangan.
Library dukungan kini tersedia melalui repositori Maven Google. Kami tidak lagi mendukung download library melalui Pengelola SDK, dan fungsi tersebut akan segera dihapus.
Memilih Support Library
Sebelum menambahkan Support Library ke aplikasi, tentukan fitur yang ingin disertakan dan versi Android terendah yang ingin Anda dukung. Untuk informasi selengkapnya tentang fitur yang disediakan oleh berbagai library, lihat Fitur Support Library.
Menambahkan Library Dukungan
Untuk menggunakan Support Library, Anda harus memodifikasi dependensi classpath project aplikasi dalam lingkungan pengembangan Anda. Anda harus melakukan prosedur ini untuk setiap Support Library yang ingin Anda gunakan.
Untuk menambahkan Support Library ke project aplikasi Anda:
- Sertakan repositori Maven Google dalam file
settings.gradle
project Anda.dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() // If you're using a version of Gradle lower than 4.1, you must // instead use: // // maven { // url 'https://maven.google.com' // } } }
- Untuk setiap modul tempat Anda ingin menggunakan Support Library, tambahkan library tersebut di blok
dependencies
dari filebuild.gradle
modul. Misalnya, untuk menambahkan library core-utils v4, tambahkan kode berikut:dependencies { ... implementation "com.android.support:support-core-utils:28.0.0" }
Perhatian: Penggunaan dependensi dinamis (misalnya,
palette-v7:23.0.+
) dapat menyebabkan update versi yang tidak terduga dan
inkompatibilitas regresi. Sebaiknya Anda menentukan versi library secara eksplisit (misalnya, palette-v7:28.0.0
).
Menggunakan API Support Library
Class Support Library yang menyediakan dukungan untuk API framework yang ada biasanya memiliki
nama yang sama dengan class framework, tetapi terletak di paket class android.support
,
atau memiliki akhiran *Compat
.
Perhatian: Jika menggunakan class dari Support Library, pastikan Anda mengimpor
class dari paket yang sesuai. Misalnya, saat menerapkan class
ActionBar
:
android.support.v7.app.ActionBar
saat menggunakan Support Library.android.app.ActionBar
saat mengembangkan hanya untuk API level 11 atau yang lebih tinggi.
Catatan: Setelah menyertakan Support Library dalam project aplikasi Anda, sebaiknya persingkat, obfuscate, dan optimalkan aplikasi Anda untuk rilis. Selain melindungi kode sumber dengan obfuscation, penyusutan menghapus class yang tidak terpakai dari library yang Anda sertakan dalam aplikasi, sehingga ukuran download aplikasi Anda dapat dipertahankan sekecil mungkin.
Panduan lebih lanjut mengenai penggunaan beberapa fitur Support Library disediakan dalam
kelas pelatihan,
panduan,
dan contoh untuk developer Android. Untuk informasi selengkapnya tentang masing-masing class dan metode Support Library, lihat
paket android.support
dalam referensi API.
Perubahan Deklarasi Manifes
Jika Anda meningkatkan kompatibilitas mundur aplikasi yang ada ke Android API versi
sebelumnya dengan Support Library, pastikan untuk memperbarui manifes
aplikasi Anda. Secara khusus, Anda harus memperbarui elemen android:minSdkVersion
tag
<uses-sdk>
dalam manifes ke nomor versi baru yang lebih rendah, seperti
ditunjukkan di bawah ini:
<uses-sdk android:minSdkVersion="14" android:targetSdkVersion="23" />
Setelan manifes memberi tahu Google Play bahwa aplikasi Anda dapat diinstal pada perangkat dengan Android 4.0 (API level 14) dan yang lebih tinggi.
Jika Anda menggunakan file build Gradle, setelan minSdkVersion
dalam file build
akan menggantikan setelan manifes.
plugins { id 'com.android.application' } android { ... defaultConfig { minSdkVersion 16 ... } ... }
Dalam hal ini, setelan file build memberi tahu Google Play bahwa varian build default aplikasi Anda dapat diinstal pada perangkat yang menjalankan Android 4.1 (API level 16) dan yang lebih tinggi. Untuk mengetahui informasi selengkapnya tentang varian build, lihat Ringkasan Sistem Build.
Catatan: Jika Anda menyertakan beberapa library dukungan, versi SDK minimum harus berupa versi tertinggi yang diperlukan oleh salah satu library yang ditentukan. Misalnya, jika aplikasi Anda menyertakan library Dukungan Preferensi v14 dan library Leanback v17, versi SDK minimum Anda harus 17 atau yang lebih tinggi.