API Android 2.3.4

API Level: 10

Android 2.3.4 (GINGERBREAD_MR1) adalah rilis pemeliharaan yang menambahkan beberapa perbaikan bug dan patch ke platform Android 2.3, tanpa perubahan API dari Android 2.3.3. Selain itu, Android 2.3.4 menghadirkan dukungan untuk Open Accessory API ke perangkat seluler, melalui Open Accessory Library opsional.

Untuk pengembang, platform Android 2.3.4 tersedia sebagai yang dapat didownload untuk Android SDK. Platform yang dapat didownload mencakup library dan image sistem Android, serta serangkaian skin emulator dan lainnya. Untuk memulai pengembangan atau pengujian di Android 2.3.4, menggunakan Android SDK Manager untuk mendownload platform ke SDK Anda.

Ringkasan API

Android 2.3.4 menyediakan API kerangka kerja yang sama untuk aplikasi seperti Android 2.3.3 (level API 10). Untuk ringkasan API, lihat catatan versi Android 2.3.3.

Membuka Library Aksesori

Aksesori Terbuka adalah kemampuan baru untuk mengintegrasikan periferal yang terhubung dengan aplikasi yang berjalan di platform. Kemampuan ini didasarkan pada stack USB (Universal Serial Bus) yang di-build ke dalam platform dan API yang diekspos ke aplikasi. Periferal yang terpasang ke perangkat Android sebagai aksesori terhubung sebagai host USB.

Open Accessory diperkenalkan di Android 3.1 (API level 12), tetapi tersedia untuk perangkat yang menjalankan Android 2.3.4 melalui {i>Open Accessory Library<i}, {i>Open Accessory Library<i}. Library ini mengekspos API framework yang memungkinkan aplikasi menemukan, berkomunikasi dengan, dan mengelola berbagai jenis perangkat yang terhubung melalui USB. API ini juga menyediakan implementasi API terhadap bagian platform Android yang tidak langsung diekspos ke aplikasi di Android 2.3.4.

Open Accessory Library bersifat opsional di perangkat tertentu. Produsen perangkat dapat memilih untuk menyertakan Open Accessory Library dalam produk mereka atau mengecualikannya. Library ini kompatibel dengan Android 3.1, sehingga aplikasi yang dikembangkan untuk Android 2.3.4 akan berjalan dengan benar di perangkat yang menjalankan Android 3.1, jika perangkat tersebut mendukung aksesori USB.

API yang disediakan oleh Open Accessory Library didasarkan pada Open Accessory API yang disediakan di Android 3.1. Di sebagian besar area, Anda dapat menggunakan teknik dan API yang sama. Namun, pengembangan untuk Open Accessory Library di Android 2.3.4 berbeda dengan USB API standar dengan cara berikut:

  • Memperoleh objek UsbManager — Untuk memperoleh objek UsbManager saat menggunakan library add-on, gunakan metode bantuan getInstance(), bukan getSystemService() Contoh:

    Kotlin

    val manager = UsbManager.getInstance(this)

    Java

    UsbManager manager = UsbManager.getInstance(this);
  • Mendapatkan UsbAccessory dari intent yang difilter — Saat Anda memfilter perangkat atau aksesori yang terhubung dengan filter intent, objek UsbAccessory akan dimuat di dalam intent yang diteruskan ke aplikasi Anda. Jika Anda menggunakan add-on library, Anda bisa mendapatkan objek UsbAccessory dengan cara berikut:

    Kotlin

    val accessory = UsbManager.getAccessory(intent)

    Java

    UsbAccessory accessory = UsbManager.getAccessory(intent)
  • Tidak ada dukungan host USB — Android 2.3.4 dan Open Accessory Library memiliki tidak mendukung mode host USB (misalnya, melalui UsbDevice), meskipun mode host USB didukung di Android 3.1 Perangkat Android yang menjalankan Android 2.3.4 tidak dapat berfungsi sebagai USB {i>host<i}. Library ini memungkinkan perangkat Android berfungsi sebagai periferal saja, dengan aksesori yang terhubung berfungsi sebagai host USB (melalui UsbAccessory).

Untuk mengembangkan aplikasi menggunakan Open Accessory Library, Anda memerlukan:

  • Alat Android SDK versi terbaru
  • Add-on Google API versi terbaru, yang menyertakan library itu sendiri (untuk penautan)
  • Perangkat keras aktual yang menjalankan Android 2.3.4 (atau Android 3.1) dengan USB dukungan aksesori, untuk pengujian runtime terhadap perangkat yang terhubung

Untuk pembahasan lengkap tentang cara mengembangkan aplikasi yang berinteraksi dengan aksesori USB, lihat dokumentasi developer terkait.

Selain itu, developer dapat meminta pemfilteran di Google Play, sehingga aplikasi mereka tidak tersedia bagi pengguna yang perangkatnya tidak menyediakan dukungan aksesori yang sesuai. Untuk meminta pemfilteran, tambahkan elemen di bawah ke manifes aplikasi:

<uses-feature
  android:name="android.hardware.usb.accessory"
  android:required="true">

API Level

Platform Android 2.3.4 tidak menambah level API — menggunakan API level yang sama dengan Android 2.3.3, API level 10.

Untuk menggunakan API yang diperkenalkan di API level 10 di aplikasi Anda, Anda harus mengompilasi aplikasi terhadap library Android yang disediakan di versi terbaru Add-On Google API, yang juga menyertakan Koleksi Aksesori.

Bergantung pada kebutuhan Anda, Anda mungkin juga perlu menambahkan atribut android:minSdkVersion="10" ke elemen <uses-sdk> dalam manifes aplikasi. Jika aplikasi Anda dirancang untuk berjalan hanya pada Android 2.3.3 dan yang lebih tinggi, mendeklarasikan atribut akan mencegah aplikasi diinstal sebelumnya versi dasar dari platform tersebut.

Untuk informasi selengkapnya, baca Apa yang dimaksud dengan API Tingkat?