Penyiapan Support Library

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.

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 Support Library dan menambahkan library ke lingkungan pengembangan.

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

Memilih Support Library

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

Menambahkan Library Dukungan

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

Untuk menambahkan Support Library ke project aplikasi Anda:

  1. 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'
            // }
        }
    }
  2. Untuk setiap modul tempat Anda ingin menggunakan Support Library, tambahkan library tersebut di blok dependencies dari file build.gradle modul. 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. Sebaiknya Anda menentukan versi library secara eksplisit (misalnya, palette-v7:28.0.0).

Menggunakan API Support Library

Class Support Library yang menyediakan dukungan untuk framework API 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 susutkan, obfuscate, dan optimalkan aplikasi Anda untuk rilis. Selain melindungi kode sumber melalui obfuscation, penyusutan menghapus class yang tidak terpakai dari setiap 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 lebih lanjut 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 untuk mendukung versi terbaru dari Android API menggunakan Support Library, pastikan untuk memperbarui manifes aplikasi Anda. Khususnya, sebaiknya perbarui 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 pada file build akan mengganti setelan manifes.

plugins {
  id '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 mengetahui informasi selengkapnya tentang varian build, lihat Ringkasan Sistem Build.

Catatan: Jika Anda menyertakan beberapa support library, versi SDK minimum harus berupa versi tertinggi yang diperlukan oleh library yang ditentukan. Misalnya, jika aplikasi Anda menyertakan Support Library Preference v14 dan library Leanback v17, versi SDK minimum Anda harus 17 atau lebih tinggi.