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.

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 pada aplikasi.

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

Support library kini tersedia melalui repositori Maven Google. Kami tidak lagi mendukung download library melalui SDK Manager, 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 didukung. 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:

  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 dalam blok dependencies file build.gradle modul. Misalnya, untuk menambahkan library core-utils v4, tambahkan kode berikut:
    dependencies {
        ...
        implementation "com.android.support:support-core-utils:28.0.0"
    }
    

Perhatian: Menggunakan dependensi dinamis (misalnya palette-v7:23.0.+) dapat menyebabkan update versi yang tidak terduga dan inkompatibilitas regresi. Sebaiknya tentukan 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, kami sangat menyarankan agar Anda menyusutkan, meng-obfuscate, dan mengoptimalkan aplikasi Anda untuk rilis. Selain melindungi kode sumber melalui obfuscation, penyingkatan juga menghapus class yang tidak terpakai dari library apa pun 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 versi Android API yang lebih lama dengan Support Library, pastikan untuk memperbarui manifes aplikasi Anda. Secara khusus, Anda harus mengupdate elemen android:minSdkVersion dari 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 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 dapat diinstal di 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 yang lebih tinggi.