Register now for Android Dev Summit 2019!

Penyiapan Library Dukungan

Catatan: Dengan dirilisnya Android 9.0 (API level 28), ada library dukungan versi baru yang disebut AndroidX yang merupakan bagian dari Jetpack. Library AndroidX memuat library dukungan yang ada dan juga menyertakan komponen Jetpack terbaru.

Anda dapat terus menggunakan library dukungan 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 Anda juga mempertimbangkan untuk memigrasikan project yang ada ke AndroidX.

Penyiapan Android Support Library dalam project pengembangan bergantung pada fitur yang ingin digunakan dan rentang versi platform Android yang ingin didukung dengan aplikasi Anda.

Dokumen ini akan memandu Anda mendownload paket Library Dukungan dan menambahkan library ke lingkungan pengembangan.

Library dukungan sekarang tersedia melalui repositori Maven Google. Kami tidak lagi mendukung download library melalui Pengelola SDK, dan fungsionalitas tersebut akan dihapus dalam waktu dekat.

Memilih Library Dukungan

Sebelum menambahkan Library Dukungan ke aplikasi, tentukan fitur yang ingin disertakan dan versi Android terendah yang ingin didukung. Untuk informasi lebih lanjut tentang fitur yang disediakan oleh berbagai library, lihat Fitur Library Dukungan.

Menambahkan Library Dukungan

Agar dapat menggunakan Library Dukungan, Anda harus memodifikasi dependensi classpath project aplikasi dalam lingkungan pengembangan Anda. Anda harus menjalankan prosedur ini untuk setiap Library Dukungan yang ingin Anda gunakan.

Untuk menambahkan Library Dukungan ke project aplikasi Anda:

  1. Sertakan repositori Maven Google ke file build.gradle level teratas.
        allprojects {
            repositories {
                google()
    
                // If you're using a version of Gradle lower than 4.1, you must
                // instead use:
                //
                // maven {
                //     url 'https://maven.google.com'
                // }
            }
        }
        
  2. Tambahkan library dukungan ke bagian dependencies. Misalnya, untuk menambahkan library core-utils v4, tambahkan baris 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. Kami menyarankan agar Anda menentukan versi library secara eksplisit (misalnya palette-v7:28.0.0).

Menggunakan API Library Dukungan

Kelas Library Dukungan 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 Library Dukungan, pastikan Anda mengimpor class dari paket yang sesuai. Misalnya, saat menerapkan class ActionBar:

  • android.support.v7.app.ActionBar saat menggunakan Library Dukungan.
  • android.app.ActionBar saat melakukan pengembangan hanya untuk API level 11 atau yang lebih tinggi.

Catatan: Setelah menyertakan Library Dukungan dalam project aplikasi Anda, kami sangat menyarankan penggunaan fitur ProGuard untuk mempersiapkan rilis APK aplikasi Anda. Selain melindungi kode sumber, fitur ProGuard juga menghapus class yang tidak terpakai dari library yang Anda sertakan dalam aplikasi, sehingga ukuran download aplikasi Anda dapat dipertahankan sekecil mungkin. Untuk informasi lebih lanjut, lihat ProGuard.

Panduan lebih lanjut mengenai penggunaan beberapa fitur Library Dukungan disediakan dalam kelas pelatihan, panduan, dan sampel untuk developer Android. Untuk informasi lebih lanjut tentang masing-masing class dan metode Library Dukungan, lihat paket android.support dalam referensi API.

Perubahan Deklarasi Manifes

Jika Anda meningkatkan kompatibilitas aplikasi yang ada untuk mendukung Android API versi lama dengan Library Dukungan, pastikan untuk memperbarui manifes aplikasi Anda. Secara khusus, sebaiknya Anda 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 ini 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 menimpa setelan manifes.

    apply plugin: 'com.android.application'

    android {
        ...

        defaultConfig {
            minSdkVersion 16
            ...
        }
        ...
    }
    

Dalam kasus 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 informasi lebih lanjut tentang varian build, lihat Ringkasan Sistem Build.

Catatan: Jika Anda menyertakan beberapa library dukungan, versi SDK minimum haruslah versi tertinggi yang diperlukan oleh 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.