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 dengan aplikasi Anda.

Dokumen ini memandu Anda mendownload paket Support Library 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:

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 API framework yang ada biasanya memiliki nama yang sama dengan class framework, tetapi terletak di paket class android.support, atau memiliki akhiran *Compat.

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.