Paket-Paket Support Library

Catatan: Dengan dirilisnya Support Library 28.0.0, paket android.support library tidak digunakan lagi dan diganti dengan Jetpack dengan versi terpisah library yang dikemas sebagai androidx. Versi 1.0.0 awal Library Jetpack menyediakan paritas dengan Support Library 28.0.0 dan menyediakan titik awal untuk memigrasikan ke androidx baru kemasan produk.

Library terpaket android.support yang sudah ada akan terus berfungsi; Namun, mereka tidak akan menerima update apa pun di luar 28.0.0 dan tidak akan kompatibel dengan library Jetpack baru. Artefak historis (versi 27 dan yang lebih lama, serta yang dikemas sebagai android.support) akan tetap tersedia di Google Maven. Semua artefak baru akan dikemas sebagai androidx dan akan memerlukan migrasi dari android.support ke androidx.

Sebaiknya gunakan library androidx di semua project baru. Anda juga harus pertimbangkan untuk memigrasikan project yang ada untuk memastikan project tersebut terus menerima perbaikan bug dan peningkatan library lainnya.

Android Support Library berisi beberapa paket library yang dapat disertakan dalam aplikasi Anda. Masing-masing library ini mendukung rentang platform Android tertentu versi dan serangkaian fitur.

Untuk menggunakan salah satu pustaka berikut, Anda harus mengunduh file pustaka ke Penginstalan Android SDK. Ikuti petunjuk untuk mendownload Support Library di Penyiapan Support Library untuk menyelesaikan langkah ini. Anda harus mengambil langkah tambahan untuk menyertakan Support Library tertentu dalam aplikasi Anda. Lihat bagian akhir dari setiap pustaka di bawah ini untuk informasi penting tentang cara menyertakan library dalam aplikasi Anda.

Catatan: Versi SDK minimum untuk semua dukungan paket library setidaknya adalah API level 14. Beberapa paket memerlukan API yang lebih tinggi seperti yang disebutkan di bawah ini.

Support Library v4

Library ini menyertakan kumpulan API terbesar dibandingkan dengan library lainnya, termasuk dukungan untuk komponen aplikasi, fitur antarmuka pengguna, aksesibilitas, penanganan data, konektivitas jaringan, dan pemrograman utilitas.

Untuk informasi lengkap dan terperinci tentang class dan metode yang disediakan oleh library dukungan v4, lihat paket android.support.v4 dalam referensi API.

Catatan: Sebelum revisi Support Library 24.2.0, ada library dukungan v4 tunggal. Pustaka itu dibagi menjadi beberapa modul untuk meningkatkan efisiensi. Untuk kompatibilitas mundur, jika Anda mencantumkan support-v4 dalam skrip Gradle, aplikasi Anda akan menyertakan semua modul v4. Namun, untuk mengurangi ukuran aplikasi, sebaiknya Anda hanya mencantumkan modul spesifik yang dibutuhkan aplikasi Anda.

Library compat v4

Memberikan wrapper kompatibilitas untuk sejumlah API framework, seperti Context.obtainDrawable() dan View.performAccessibilityAction().

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:support-compat:28.0.0

Library core-utils v4

Menyediakan sejumlah class utilitas, seperti AsyncTaskLoader dan PermissionChecker.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:support-core-utils:28.0.0

Library core-ui v4

Mengimplementasikan berbagai komponen terkait UI, seperti ViewPager, NestedScrollView, dan ExploreByTouchHelper.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:support-core-ui:28.0.0

Library media-comp4 v4

Mem-backport bagian framework media, termasuk MediaBrowser dan MediaSession.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:support-media-compat:28.0.0

Library fragment v4

Menambahkan dukungan untuk enkapsulasi antarmuka pengguna dan fungsionalitas dengan fragmen, memungkinkan aplikasi untuk menyediakan tata letak yang menyesuaikan antara perangkat layar besar. Modul ini memiliki dependensi pada compat, core-utils, core-ui, dan media-compat.

Catatan: Support library v13 menyediakan class FragmentCompat. V4 Class Fragment adalah class mandiri yang menyediakan perbaikan {i>bug<i} yang ditambahkan di versi platform yang lebih baru, sedangkan Class FragmentCompat v13 menyediakan shim kompatibilitas untuk implementasi framework Class Fragment.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:support-fragment:28.0.0

Support Library Multidex

Library ini menyediakan dukungan untuk membuat aplikasi yang menggunakan beberapa file Dalvik Executable (DEX). Konfigurasi multidex mensyaratkan aplikasi yang mereferensikan lebih dari 65.536 metode. Sebagai informasi selengkapnya tentang penggunaan multidex, lihat Membuat Aplikasi dengan Lebih dari 64K Metode.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:multidex:1.0.0

Support Library v7

Library ini menyediakan set fitur tertentu dan dapat dimasukkan dalam aplikasi Anda satu sama lain secara independen.

Library compat v7 Bagian dari Android Jetpack.

Catatan: Library compat telah dimigrasikan ke Library AndroidX, yang merupakan Android Jetpack Google. Lihat penggunaannya di Aplikasi demo Sunflower.

Library ini menambahkan dukungan untuk Pengguna Panel Tindakan desain antarmuka pola. Library ini mencakup dukungan untuk Antarmuka pengguna desain material implementasi yang tepat.

Catatan: Library ini bergantung pada Support Library v4.

Berikut adalah beberapa class utama yang disertakan dalam library appcompat v7:

  • ActionBar - Menyediakan implementasi panel tindakan pola antarmuka pengguna. Untuk selengkapnya informasi tentang cara menggunakan Bilah Tindakan, lihat Panduan developer Panel Tindakan.
  • AppCompatActivity - Menambahkan class aktivitas aplikasi yang dapat digunakan sebagai class dasar untuk aktivitas yang menggunakan panel tindakan Support Library terlepas dari implementasi layanan.
  • AppCompatDialog - Menambahkan class dialog yang dapat digunakan sebagai basis untuk dialog bertema AppCompat.
  • ShareActionProvider - Menambahkan dukungan untuk tindakan berbagi (seperti email atau posting ke aplikasi sosial) yang dapat disertakan dalam panel tindakan.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:appcompat-v7:28.0.0

Library cardview v7

Library ini menambahkan dukungan untuk CardView widget, yang memungkinkan Anda menampilkan informasi di dalam kartu yang memiliki tampilan konsisten di aplikasi apa pun. Kartu-kartu ini berguna untuk desain material dan banyak digunakan dalam tata letak untuk aplikasi TV.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:cardview-v7:28.0.0

Library gridlayout v7

Setelah Anda mendownload Android Support Library, library ini akan menambahkan dukungan untuk GridLayout, yang memungkinkan Anda untuk mengatur elemen antarmuka pengguna menggunakan {i>grid<i} sel persegi panjang. Untuk informasi selengkapnya tentang API library gridlayout v7, lihat android.support.v7.widget dalam referensi API.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:gridlayout-v7:28.0.0

Library mediarouter v7

Library ini menyediakan MediaRouter, MediaRouteProvider, dan class media terkait yang mendukung Google Cast.

Secara umum, API di pustaka mediarouter v7 menyediakan sarana mengontrol perutean saluran dan aliran media dari perangkat saat ini ke layar eksternal, speaker, dan perangkat tujuan lainnya. Library ini menyertakan API untuk memublikasikan penyedia rute media khusus aplikasi, guna menemukan dan memilih perangkat tujuan, memeriksa status media, dan banyak lagi. Untuk detail informasi tentang API library mediarouter v7, lihat Paket android.support.v7.media di API alamat IP internal.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:mediarouter-v7:28.0.0

API library mediarouter v7 yang diperkenalkan dalam Support Library r18 dapat berubah dalam revisi Support Library berikutnya. Di sebaiknya gunakan library ini hanya untuk Google Cast.

Library palette v7

Pustaka dukungan palette v7 mencakup Class Palette, yang memungkinkan Anda mengekstrak warna yang menonjol dari sebuah gambar. Misalnya, aplikasi musik dapat menggunakan Objek Palette untuk mengekstrak warna utama dari sampul album, dan menggunakan warna tersebut untuk membuat lagu yang dikoordinasikan dengan warna kartu judul.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:palette-v7:28.0.0

Library recyclerview v7

Library AOSP menambahkan RecyclerView . Class ini memberikan dukungan untuk RecyclerView widget, tampilan untuk menampilkan set data besar secara efisien dengan menyediakan periode terbatas untuk item data.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:recyclerview-v7:28.0.0

Support Library Preference v7

Tujuan preferensi menyediakan API untuk mendukung penambahan objek preferensi, seperti CheckBoxPreference dan ListPreference, untuk pengguna untuk mengubah pengaturan UI.

Pustaka Preference v7 menambahkan dukungan untuk antarmuka, seperti Preference.OnPreferenceChangeListener dan Preference.OnPreferenceClickListener, dan class, seperti CheckBoxPreference dan ListPreference.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:preference-v7:28.0.0

Support Library v8

Library ini menyediakan set fitur khusus dan dapat disertakan dalam aplikasi Anda terpisah dari library lain.

Library renderscript v8

{i>Library<i} ini menambahkan dukungan untuk komputasi RenderScript Google Workspace for Education. API ini disertakan dalam paket android.support.v8.renderscript. Anda harus menyadari bahwa langkah-langkah untuk memasukkan API ini ke dalam aplikasi sangatlah berbeda dengan API support library lainnya. Untuk informasi selengkapnya tentang penggunaan API ini dalam aplikasi Anda, lihat Skrip RenderScript panduan developer.

Catatan: Penggunaan RenderScript dengan support library didukung dengan Android Build berbasis Gradle dan Studio. Tujuan library renderscript terletak di folder build-tools/$VERSION/renderscript/.

Contoh berikut menampilkan properti skrip build Gradle untuk library ini:

defaultConfig {
    renderscriptTargetApi 18
    renderscriptSupportModeEnabled true
}

Support Library v13

Library ini menambahkan dukungan untuk pola antarmuka pengguna Fragment dengan class (FragmentCompat) dan dukungan fragmen tambahan Google Cloud Platform. Untuk informasi selengkapnya tentang fragmen, lihat Panduan developer Fragment. Untuk detail informasi tentang API Support Library v13, lihat paket android.support.v13 dalam referensi API.

Catatan: Library fragment v4 menyediakan class Fragment. V4 Class Fragment adalah class mandiri yang menyediakan perbaikan {i>bug<i} yang ditambahkan di versi platform yang lebih baru, sedangkan Class FragmentCompat v13 menyediakan shim kompatibilitas untuk implementasi framework Class Fragment.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:support-v13:28.0.0

Support Library Preference v14

Paket android.support.v14.preference menyediakan API untuk menambahkan dukungan untuk antarmuka preferensi seperti PreferenceFragment.OnPreferenceStartFragmentCallback dan PreferenceFragment.OnPreferenceStartScreenCallback, beserta class, seperti MultiSelectListPreference dan PreferenceFragment. Untuk detail informasi tentang API Preference Support Library v14, lihat preferensi dalam referensi API.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:preference-v14:28.0.0

Support Library Preference v17 untuk TV

Paket android.support.v17.preference menyediakan API untuk memberikan preferensi antarmuka pada perangkat TV, termasuk dukungan untuk LeanbackListPreferenceDialogFragment.ViewHolder.OnItemClickListener dan class, seperti BaseLeanbackPreferenceFragment dan LeanbackPreferenceFragment. Untuk detail informasi tentang API Preference Support Library v17, lihat preferensi dalam referensi API.

Paket ini memerlukan API level 17 atau yang lebih tinggi. Skrip build Gradle ID dependensi untuk library ini adalah sebagai berikut:

 com.android.support:preference-leanback-v17:28.0.0 

Library Leanback v17

Paket android.support.v17.leanback menyediakan API untuk didukung membangun antarmuka pengguna di perangkat TV. Paket ini menyediakan sejumlah widget penting untuk aplikasi TV. Beberapa class utama meliputi:

Paket ini memerlukan API level 17 atau yang lebih tinggi. Skrip build Gradle ID dependensi untuk library ini adalah sebagai berikut:

com.android.support:leanback-v17:28.0.0

Library Vector Drawable

Menyediakan dukungan untuk grafis vektor statis.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut ini:

com.android.support:support-vector-drawable:28.0.0

Library Animated Vector Drawable

Menyediakan dukungan untuk grafis vektor beranimasi.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut ini:

com.android.support:animated-vector-drawable:28.0.0

Support Library Annotations

Anotasi menyediakan API untuk mendukung penambahan metadata anotasi ke aplikasi Anda.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:support-annotations:28.0.0

Support Library Design

Tujuan Paket Design menyediakan API untuk mendukung penambahan komponen dan pola desain material ke aplikasi Anda.

{i>Support<i} desain {i>Support<i} menambahkan dukungan untuk berbagai komponen dan pola desain material untuk developer aplikasi sebagai dasar pembuatan, seperti panel navigasi, tombol tindakan mengambang (FAB), snackbar, dan tab.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:design:28.0.0

Support Library Custom Tabs

Tujuan Tab Khusus menyediakan API untuk mendukung penambahan dan pengelolaan tab khusus di aplikasi Anda.

Custom Tabs Support Library menambahkan dukungan untuk berbagai class, seperti Tab Khusus Layanan dan Tab Khusus Telepon Balik.

Paket ini memerlukan API level 15 atau yang lebih tinggi. ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:customtabs:28.0.0

Support Library Percent

Tujuan Persen menyediakan API untuk mendukung penambahan dan pengelolaan berbasis persentase dimensi dalam aplikasi Anda.

Catatan: Mulai rilis 26.0.0, Support Library Percent tidak digunakan lagi. Klien modul ini harus bermigrasi ke ConstraintLayout baru , yang disediakan sebagai artefak terpisah di SDK Manager.

{i>Support library<i} Percent menambahkan dukungan untuk Antarmuka PercentLayoutHelper.PercentLayoutParams serta berbagai class, seperti PercentFrameLayout dan PercenttargetSdkVersion.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:percent:28.0.0

Support Library ExifInterface

Tag Exif menyimpan informasi seperti orientasi, tanggal dan waktu, kamera informasi lokasi, dan lokasinya secara langsung dalam file JPEG atau RAW. ExifInterface mengurai dukungan class untuk membaca informasi Exif dari JPEG dan mentah (DNG, CR2, NEF, NRW, ARW, RW2, ORF, PEF, SRW, dan RAF) yang diformat dan mengatur informasi Exif pada file gambar JPEG.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:exifinterface:28.0.0

Support Library App Recommendation untuk TV

Tujuan Aplikasi Rekomendasi menyediakan API untuk mendukung penambahan rekomendasi konten di aplikasi Anda yang berjalan di perangkat TV.

Library Aplikasi menambahkan dukungan untuk anotasi, seperti ContentRecommendation.ContentMaturity dan berbagai class, seperti ContentRekomendasi dan RecommendationExtender.

Paket ini memerlukan API level 21 atau yang lebih tinggi. ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:recommendation:28.0.0

Library Wear UI

Library ini memiliki API untuk membuat antarmuka pengguna bagi aplikasi Wear. API, yang tersedia di paket android.support.wear.widget, mengganti API yang sesuai di Wearable Support Library.

Untuk informasi selengkapnya, lihat Menggunakan Library Wear UI.

ID dependensi skrip build Gradle untuk library ini adalah sebagai berikut:

com.android.support:wear:28.0.0