API Android 2.3.4

Level API: 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 banyak lagi. 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 bagian Catatan versi Android 2.3.3.

Buka Library Aksesori

Akses Terbuka adalah kemampuan baru untuk mengintegrasikan periferal yang terhubung dengan aplikasi yang berjalan di platform. Kemampuan didasarkan pada tumpukan USB (Universal Serial Bus) yang dibangun ke dalam platform dan API yang diekspos ke aplikasi. Periferal yang terhubung ke perangkat yang didukung Android ketika aksesori terhubung sebagai {i>host<i} 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 macam perangkat yang terhubung melalui USB. API ini juga menyediakan implementasi API terhadap bagian dari platform Android yang tidak secara langsung terpapar aplikasi Android 2.3.4

Open Accessory Library bersifat opsional di perangkat tertentu. Perangkat produsen dapat memilih apakah akan menyertakan Perpustakaan Aksesori Terbuka dalam atau mengecualikannya. Pustaka ini kompatibel dengan Android 3.1 ke depan, jadi aplikasi yang dikembangkan terhadap Android 2.3.4 akan berjalan dengan baik pada 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 Google Cloud Platform. Namun, mengembangkan untuk Open Accessory Library di Android 2.3.4 berbeda dari 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 yang memiliki intent , objek UsbAccessory 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 yang didukung Android untuk berfungsi sebagai periferal, dengan aksesori yang terhubung berfungsi sebagai host USB (melalui UsbAccessory).

Untuk mengembangkan aplikasi menggunakan Open Accessory Library, Anda memerlukan:

  • Versi terbaru Android SDK Tools
  • Versi terbaru add-on Google API, 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 diskusi lengkap tentang cara mengembangkan aplikasi yang berinteraksi dengan USB aksesori, lihat dokumentasi developer yang 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 ini 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.

Tergantung kebutuhan, Anda mungkin juga perlu menambahkan android:minSdkVersion="10" ke elemen <uses-sdk> dalam elemen manifes. 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?