Save the date! Android Dev Summit is coming to Sunnyvale, CA on Oct 23-24, 2019.

Persiapan Pustaka Dukungan

Bagaimana Anda mempersiapkan Pustaka Dukungan Android dalam proyek development Anda bergantung pada fitur apa yang ingin Anda gunakan dan versi platform Android apa saja yang ingin Anda dukung dengan aplikasi Anda.

Dokumen ini memandu Anda dalam mengunduh paket Pustaka Dukungan dan menambahkan pustaka ke lingkungan development Anda.

Mengunduh Pustaka Dukungan

Paket Android Support Repository disediakan sebagai unduhan tambahan untuk Android SDK dan tersedia melalui Android SDK Manager. Ikuti petunjuk di bawah untuk memperoleh file Pustaka Dukungan.

Untuk mengunduh Pustaka Dukungan melalui SDK Manager:

  1. Jalankan Android SDK Manager.
  2. Pada jendela SDK Manager, gulir ke akhir daftar Packages, temukan folder Extras dan, jika diperlukan, perluas tampilan untuk menampilkan isinya.
  3. Pilih item Android Support Repository.
  4. Klik tombol Install packages....

Gambar 1. Android SDK Manager dengan Android Support Repository terpilih.

Setelah mengunduh, alat akan memasang file Pustaka Dukungan ke direktori Android SDK Anda. File pustaka terletak di subdirektori SDK berikut: direktori <sdk>/extras/android/m2repository/com/android/support/.

Memilih Pustaka Dukungan

Sebelum menambahkan Pustaka Dukungan ke aplikasi Anda, putuskan fitur apa yang ingin Anda sertakan dan versi Android terendah yang ingin Anda dukung. Untuk informasi selengkapnya mengenai fitur yang disediakan oleh pustaka berbeda, lihat Fitur Pustaka Dukungan.

Menambahkan Pustaka Dukungan

Untuk menggunakan Pustaka Dukungan, Anda harus memodifikasi dependensi classpath proyek aplikasi di dalam lingkungan development Anda. Anda harus melakukan prosedur ini untuk setiap Pustaka Dukungan yang ingin Anda gunakan.

Untuk menambahkan Pustaka Dukungan ke proyek aplikasi Anda:

  1. Pastikan Anda telah mengunduh Android Support Repository menggunakan SDK Manager.
  2. Buka file build.gradle untuk aplikasi Anda.
  3. Tambahkan pustaka dukungan ke bagian dependencies. Misalnya, untuk menambahkan pustaka core-utils v4, tambahkan baris berikut:
    dependencies {
        ...
        compile "com.android.support:support-core-utils:24.2.0"
    }
    

Perhatian: Menggunakan dependensi dinamis (misalnya, palette-v7:23.0.+) bisa menyebabkan pembaruan versi yang tidak terduga dan regresi tidak kompatibel. Kami menyarankan Anda secara eksplisit menetapkan versi pustaka (misalnya, palette-v7:24.2.0).

Menggunakan API Pustaka Dukungan

Kelas Pustaka Dukungan yang menyediakan dukungan untuk kerangka kerja API aktif biasanya memiliki nama yang sama dengan kelas kerangka kerja namun terletak di paket kelas android.support, atau berakhiran *Compat.

Perhatian: Saat menggunakan kelas dari Pustaka Dukungan, pastikan Anda mengimpor kelas dari paket yang sesuai. Misalnya, ketika menerapkan kelas ActionBar:

  • android.support.v7.app.ActionBar saat menggunakan Pustaka Dukungan.
  • android.app.ActionBar ketika mengembangkan hanya untuk API level 11 atau yang lebih tinggi.

Catatan: Setelah memasukkan Pustaka Dukungan dalam proyek aplikasi, kami sangat sarankan menggunakan alat ProGuard untuk mempersiapkan APK aplikasi Anda untuk rilis. Selain untuk melindungi kode sumber, alat ProGuard juga membuang kelas yang tidak terpakai dari pustaka yang Anda masukkan dalam aplikasi, yang membuat ukuran unduhan aplikasi sekecil mungkin. Untuk informasi selengkapnya, lihat ProGuard.

Panduan lebih jauh tentang penggunaan beberapa fitur Pustaka Dukungan disediakan dalam kelas pelatihan, panduan dan contoh developer Android. Untuk informasi selengkapnya tentang kelas dan metode Pustaka Dukungan individu, lihat paket android.support dalam referensi API.

Perubahan Deklarasi Manifes

Jika Anda meningkatkan kompatibilitas mundur aplikasi yang digunakan ke Android API versi sebelumnya dengan Pustaka Dukungan, pastikan untuk memperbarui manifes aplikasi. Secara spesifik, Anda harus memperbarui 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 memberi tahu Google Play bahwa aplikasi Anda bisa dipasang pada perangkat dengan Android 4.0 (API level 14) dan yang lebih tinggi.

Jika Anda menggunakan file pembangunan Gradle, setelan minSdkVersion dalam file pembangunan akan menggantikan setelan manifes.

apply plugin: 'com.android.application'

android {
    ...

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

Dalam kasus ini, setelan file pembangunan memberi tahu Google Play bahwa varian pembangunan default dari aplikasi Anda bisa dipasang pada perangkat dengan Android 4.1 (API level 16) dan yang lebih tinggi. Untuk informasi selengkapnya tentang varian pembangunan, lihat Ringkasan Sistem Pembangunan.

Catatan: Jika Anda menyertakan sejumlah pustaka dukungan, versi SDK minimum harus versi tertinggi yang diperlukan oleh salah satu pustaka yang ditetapkan. Misalnya, jika aplikasi Anda menyertakan pustaka Dukungan Preference v14 dan pustaka Leanback v17, versi SDK minimum Anda harus 17 atau yang lebih tinggi.