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 yang ingin Anda gunakan dan berbagai versi platform Android yang ingin Anda dukung dengan aplikasi.

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

Library dukungan kini tersedia melalui Maven Google repositori resource. Kami tidak lagi mendukung download library melalui SDK Pengelola, dan fungsi tersebut akan segera dihapus..

Memilih Support Library

Sebelum menambahkan Support Library ke aplikasi, tentukan fitur yang ingin Anda sertakan dan versi Android terendah yang ingin Anda dukung. Untuk informasi selengkapnya tentang fitur yang disediakan oleh library Fitur Library Dukungan.

Menambahkan Library Dukungan

Untuk menggunakan Library Dukungan, Anda harus memodifikasi elemen dependensi classpath dalam lingkungan pengembangan Anda. Anda harus melakukan prosedur ini untuk setiap {i>Support Library<i} yang ingin Anda gunakan.

Untuk menambahkan Support Library ke project aplikasi Anda:

  1. Sertakan repositori Maven Google di direktori File settings.gradle. 
    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 {i>Support Library<i}, tambahkan pustaka itu di Blok dependencies dari file build.gradle modul. Sebagai misalnya, untuk menambahkan library core-utils v4, tambahkan baris 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 ketidakcocokan regresi. Sebaiknya tentukan secara eksplisit versi library (misalnya, palette-v7:28.0.0).

Menggunakan API Support Library

Kelas Support Library yang menyediakan dukungan untuk API framework yang ada biasanya memiliki sama dengan class framework tetapi berada di paket class android.support, atau memiliki akhiran *Compat.

Perhatian: Saat menggunakan class dari Support Library, pastikan Anda mengimpor class dari paket yang sesuai. Misalnya, saat menerapkan 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 disarankan agar Anda menyusutkan, meng-obfuscate, dan mengoptimalkan aplikasi Anda untuk dirilis. Selain melindungi kode sumber Anda dengan obfuscation, penyingkatan kelas yang tidak digunakan akan menghapus dari pustaka apa pun yang Anda sertakan dalam aplikasi, yang menjaga sekecil mungkin.

Panduan lebih lanjut untuk menggunakan beberapa fitur Support Library disediakan di developer Android kelas pelatihan, panduan dan sampel. 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 lama Android API dengan Support Library, pastikan untuk memperbarui manifes. Secara khusus, Anda harus mengupdate android:minSdkVersion elemen <uses-sdk> dalam manifes ke nomor versi baru yang lebih rendah, sebagai yang ditampilkan di bawah ini:

  <uses-sdk
      android:minSdkVersion="14"
      android:targetSdkVersion="23" />

Setelan manifes memberi tahu Google Play bahwa aplikasi Anda bisa diinstal pada perangkat dengan Android 4.0 (level API 14) dan yang lebih tinggi.

Jika Anda menggunakan file build Gradle, setelan minSdkVersion pada file build mengganti 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 dari dapat diinstal pada perangkat dengan Android 4.1 (API level 16) dan yang lebih tinggi. Untuk selengkapnya informasi tentang varian build, lihat Ringkasan Sistem Build.

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