API Android 2.3

Level API: 9

Untuk developer, platform Android 2.3 (GINGERBREAD) tersedia sebagai komponen yang dapat didownload untuk Android SDK. Platform yang dapat didownload mencakup library Android dan image sistem, serta sekumpulan skin emulator dan lainnya. Untuk mulai mengembangkan atau menguji Android 2.3, gunakan Android SDK Manager untuk mendownload platform ke SDK Anda.

Ringkasan API

Bagian di bawah ini memberikan ringkasan teknis tentang hal yang baru bagi developer pada versi 2.3, termasuk fitur baru dan perubahan dalam API framework sejak versi sebelumnya.

VoIP berbasis SIP

Platform ini kini mencakup stack protokol SIP dan API framework yang memungkinkan developer mem-build aplikasi telepon internet. Dengan menggunakan API, aplikasi dapat menawarkan fitur panggilan suara tanpa harus mengelola sesi, komunikasi tingkat transportasi, atau audio — semua ini ditangani secara transparan oleh layanan dan API SIP platform.

SIP API tersedia dalam paket android.net.sip. Class utamanya adalah SipManager, yang digunakan aplikasi untuk menyiapkan dan mengelola profil SIP, lalu memulai panggilan audio dan menerima panggilan audio. Setelah panggilan audio dibuat, aplikasi dapat membisukan panggilan, mengaktifkan mode speaker, mengirim nada DTMF, dan lainnya. Aplikasi juga dapat menggunakan SipManager untuk membuat koneksi SIP generik.

Stack dan layanan SIP yang mendasarinya tersedia di perangkat atas pertimbangan produsen dan operator terkait. Karena alasan ini, aplikasi harus menggunakan metode isApiSupported() untuk memeriksa apakah dukungan SIP tersedia, sebelum mengekspos fungsi panggilan kepada pengguna.

Untuk menggunakan SIP API, aplikasi harus meminta izin dari pengguna dengan mendeklarasikan <uses-permission android:name="android.permission.INTERNET"> dan <uses-permission android:name="android.permission.USE_SIP"> dalam file manifesnya.

Selain itu, developer dapat meminta pemfilteran di Google Play, sehingga aplikasi mereka tidak dapat ditemukan oleh pengguna yang perangkatnya tidak menyertakan stack dan layanan SIP platform. Untuk meminta pemfilteran, tambahkan <uses-feature android:name="android.software.sip" android:required="true"> dan <uses-feature android:name="android.software.sip.voip"> ke manifes aplikasi.

Untuk informasi selengkapnya, baca panduan developer SIP.

Komunikasi Nirkabel Jarak Dekat (NFC)

Android 2.3 menyertakan stack NFC dan API framework yang memungkinkan developer membaca tag NDEF yang ditemukan saat pengguna menyentuh perangkat berkemampuan NFC untuk memberi tag pada elemen yang disematkan dalam stiker, poster smart, dan bahkan perangkat lainnya.

Platform ini menyediakan layanan NFC dasar yang berfungsi dengan hardware perangkat untuk menemukan tag saat berada dalam jangkauan. Saat menemukan tag, platform akan memberi tahu aplikasi dengan menyiarkan Intent, dengan menambahkan pesan NDEF tag ke Intent sebagai tambahan. Aplikasi dapat membuat filter Intent untuk mengenali dan menangani tag dan pesan yang ditargetkan. Misalnya, setelah menerima tag berdasarkan Intent, aplikasi akan mengekstrak pesan NDEF, menyimpannya, memberi tahu pengguna, atau menanganinya dengan cara lain.

NFC API tersedia dalam paket android.nfc. Class utamanya adalah:

  • NfcAdapter, yang merepresentasikan hardware NFC pada perangkat.
  • NdefMessage, yang mewakili pesan data NDEF, format standar yang digunakan "data" yang membawa data dikirim antara perangkat dan tag. Aplikasi dapat menerima pesan ini dari Intent ACTION_TAG_DISCOVERED.
  • NdefRecord, dikirim dalam NdefMessage, yang menjelaskan jenis data yang dibagikan dan membawa data itu sendiri.

Komunikasi NFC bergantung pada teknologi nirkabel pada hardware perangkat, sehingga dukungan untuk fitur NFC platform pada perangkat tertentu ditentukan oleh produsennya. Untuk menentukan dukungan NFC pada perangkat saat ini, aplikasi dapat memanggil isEnabled() untuk membuat kueri NfcAdapter. Namun, NFC API selalu ada, terlepas dari dukungan hardware yang mendasarinya.

Untuk menggunakan API NFC, aplikasi harus meminta izin dari pengguna dengan mendeklarasikan <uses-permission android:name="android.permission.NFC"> dalam file manifesnya.

Selain itu, developer dapat meminta pemfilteran di Google Play, sehingga aplikasi mereka tidak dapat ditemukan oleh pengguna yang perangkatnya tidak mendukung NFC. Untuk meminta pemfilteran, tambahkan <uses-feature android:name="android.hardware.nfc" android:required="true"> ke manifes aplikasi.

Untuk melihat contoh aplikasi yang menggunakan NFC API, lihat NFCDemo.

Giroskop dan sensor lainnya

Android 2.3 menambahkan dukungan platform dan API untuk beberapa jenis pembacaan sensor baru — giroskop, vektor rotasi, akselerasi linear, gravitasi, dan barometer. Developer dapat menggunakan pembacaan sensor baru untuk membuat aplikasi yang merespons perubahan posisi dan gerakan perangkat dengan cepat dan lancar. Sensor API melaporkan giroskop dan perubahan sensor lainnya pada aplikasi yang diminati, baik yang berjalan di framework aplikasi maupun dalam kode native.

Perhatikan bahwa kumpulan sensor hardware tertentu yang tersedia di perangkat tertentu bervariasi sesuai pertimbangan produsen perangkat.

Developer dapat meminta pemfilteran di Google Play, sehingga aplikasi mereka tidak dapat ditemukan oleh pengguna yang perangkatnya tidak menawarkan sensor giroskop. Untuk melakukannya, tambahkan <uses-feature android:name="android.hardware.sensor.gyroscope" android:required="true"> ke manifes aplikasi.

Untuk detail API, lihat Sensor.

Dukungan beberapa kamera

Aplikasi kini dapat menggunakan kamera apa pun yang tersedia di perangkat, untuk pengambilan foto atau video. Camera memungkinkan aplikasi membuat kueri untuk jumlah kamera yang tersedia dan karakteristik unik masing-masing kamera.

Untuk melihat kode contoh untuk mengakses kamera depan, lihat CameraPreview.java dalam aplikasi contoh ApiDemos.

Camera API juga menambahkan:

Efek audio yang dapat dicampur

Framework media platform ini menambahkan dukungan untuk efek audio per lagu atau global baru, termasuk peningkatan bass, virtualisasi headphone, ekualisasi, dan gema.

Untuk melihat kode contoh efek audio, lihat AudioFxDemo.java dalam aplikasi contoh ApiDemos.

Framework media juga menambahkan:

  • Dukungan baru untuk tag ketinggian dalam metadata EXIF untuk file JPEG. Metode baru getAltitude() untuk mengambil nilai tag ketinggian EXIF.
  • Metode setOrientationHint() baru memungkinkan aplikasi memberi tahu MediaRecorder tentang orientasi selama perekaman video.

Pengelola Download

Platform ini menyertakan layanan sistem DownloadManager baru yang menangani download HTTP yang berjalan lama. Aplikasi dapat meminta agar URI didownload ke file tujuan tertentu. DownloadManager akan menjalankan download di latar belakang, menangani interaksi HTTP, dan mencoba mendownload kembali setelah terjadi kegagalan atau saat terjadi perubahan konektivitas dan mulai ulang sistem.

  • Aplikasi dapat memperoleh instance class DownloadManager dengan memanggil getSystemService(String) dan meneruskan DOWNLOAD_SERVICE. Aplikasi yang meminta download melalui API ini harus mendaftarkan penerima siaran untuk ACTION_NOTIFICATION_CLICKED, agar dapat menangani dengan tepat saat pengguna mengklik download yang sedang berjalan dalam notifikasi atau dari UI Download.
  • Class DownloadManager.Request memungkinkan aplikasi memberikan semua informasi yang diperlukan untuk meminta download baru, seperti URI permintaan dan tujuan download. URI permintaan adalah satu-satunya parameter yang diperlukan. Perhatikan bahwa tujuan download default adalah volume bersama tempat sistem dapat menghapus file Anda jika perlu mendapatkan kembali ruang penyimpanan untuk penggunaan sistem. Untuk penyimpanan download persisten, tentukan tujuan download pada penyimpanan eksternal (lihat setDestinationUri(Uri)).
  • Class DownloadManager.Query menyediakan metode yang memungkinkan aplikasi membuat kueri dan memfilter download aktif.

StrictMode

Untuk membantu developer memantau dan meningkatkan performa aplikasi mereka, platform menawarkan fasilitas sistem baru yang disebut StrictMode. Saat diterapkan dalam aplikasi, StrictMode akan menangkap dan memberi tahu developer tentang aktivitas jaringan atau disk yang tidak disengaja yang dapat menurunkan performa aplikasi, seperti aktivitas yang berlangsung di thread utama aplikasi (tempat operasi UI diterima dan animasi juga berlangsung). Developer dapat mengevaluasi masalah penggunaan jaringan dan disk yang muncul dalam StrictMode dan memperbaikinya jika perlu, sehingga thread utama tetap lebih responsif dan mencegah dialog ANR ditampilkan kepada pengguna.

  • StrictMode adalah class inti dan merupakan titik integrasi utama dengan sistem dan VM. Class ini menyediakan metode praktis untuk mengelola kebijakan VM dan thread yang berlaku untuk instance.
  • StrictMode.ThreadPolicy dan StrictMode.VmPolicy memegang kebijakan yang Anda tentukan dan terapkan ke instance thread dan VM.

Untuk mengetahui informasi selengkapnya tentang cara menggunakan StrictMode guna mengoptimalkan aplikasi, lihat dokumentasi class dan kode contoh di android.os.StrictMode.

Framework UI

  • Dukungan untuk overscroll
    • Dukungan baru untuk overscroll dalam Views dan Widget. Dalam View, aplikasi dapat mengaktifkan/menonaktifkan overscroll untuk tampilan tertentu, menetapkan mode overscoll, mengontrol jarak overscroll, dan menangani hasil overscrolling.
    • Di Widget, aplikasi dapat mengontrol karakteristik overscroll seperti animasi, springback, dan jarak overscroll. Untuk informasi selengkapnya, lihat android.view.View dan android.widget.OverScroller.
    • ViewConfiguration juga menyediakan metode getScaledOverflingDistance() dan getScaledOverscrollDistance().
    • Atribut overScrollMode, overScrollFooter, dan overScrollHeader baru untuk elemen <ListView>, untuk mengontrol perilaku overscroll.
  • Dukungan untuk pemfilteran sentuh
    • Dukungan baru untuk pemfilteran sentuh, yang memungkinkan aplikasi meningkatkan keamanan Tampilan yang menyediakan akses ke fungsi sensitif. Misalnya, pemfilteran sentuh sesuai untuk memastikan keamanan tindakan pengguna seperti memberikan permintaan izin, melakukan pembelian, atau mengklik iklan. Untuk mengetahui detailnya, lihat dokumentasi View class.
    • Atribut filterTouchesWhenObscured baru untuk elemen tampilan, yang mendeklarasikan apakah akan memfilter sentuhan saat jendela tampilan terhalang oleh jendela lain yang terlihat. Jika ditetapkan ke "true", tampilan tidak akan menerima sentuhan setiap kali toast, dialog, atau jendela lain muncul di atas jendela tampilan. Baca Lihat dokumentasi keamanan untuk mengetahui detailnya.

    Untuk melihat kode contoh pemfilteran sentuh, lihat SecureView.java dalam aplikasi contoh ApiDemos.

  • Peningkatan pengelolaan peristiwa
    • Class dasar baru untuk peristiwa input, InputEvent. Class ini menyediakan metode yang memungkinkan aplikasi menentukan arti peristiwa, seperti dengan membuat kueri untuk InputDevice asal peristiwa. KeyEvent dan MotionEvent adalah subclass dari InputEvent.
    • Class dasar baru untuk perangkat input, InputDevice. Class ini menyimpan informasi tentang kemampuan perangkat input tertentu dan menyediakan metode yang memungkinkan aplikasi menentukan cara menafsirkan peristiwa dari perangkat input.
  • Peningkatan peristiwa gerakan
    • MotionEvent API diperluas untuk menyertakan informasi "ID pointer", yang memungkinkan aplikasi melacak setiap jari saat bergerak ke atas dan ke bawah. Class ini menambahkan berbagai metode yang memungkinkan aplikasi bekerja secara efisien dengan peristiwa gerakan.
    • Sistem input kini memiliki logika untuk menghasilkan peristiwa gerakan dengan informasi ID pointer baru, yang menyintesis ID saat pointer baru turun. Sistem melacak beberapa ID pointer secara terpisah selama peristiwa gerakan, dan memastikan kontinuitas pointer yang tepat dengan mengevaluasi pada jarak antara kumpulan pointer terakhir dan berikutnya.
  • Kontrol pemilihan teks
    • Metode setComposingRegion baru memungkinkan aplikasi menandai wilayah teks sebagai sedang menulis teks, dengan mempertahankan gaya saat ini. Metode getSelectedText akan menampilkan teks yang dipilih ke aplikasi. Metode ini tersedia di BaseInputConnection, InputConnection, dan InputConnectionWrapper.
    • Atribut textSelectHandle, textSelectHandleLeft, textSelectHandleRight, dan textSelectHandleWindowStyle baru untuk <TextView>, untuk mereferensikan drawable yang akan digunakan untuk menampilkan anchor pemilihan teks dan gaya untuk jendela yang memuatnya.
  • Kontrol aktivitas
  • Gaya ikon dan teks notifikasi

    • Layar Ekstra Besar

    Platform ini kini mendukung ukuran layar ekstra besar, seperti yang mungkin ditemukan di perangkat tablet. Developer dapat menunjukkan bahwa aplikasi mereka dirancang untuk mendukung ukuran layar ekstra besar dengan menambahkan elemen <supports screens ... android:xlargeScreens="true"> ke file manifesnya. Aplikasi dapat menggunakan penentu resource baru, xlarge, untuk memberi tag pada resource yang khusus bagi layar ekstra besar. Untuk detail cara mendukung ukuran layar ekstra besar dan lainnya, lihat Mendukung Beberapa Layar.

    Grafis

    Penyedia Materi

    • Class penyedia AlarmClock baru untuk menyetel alarm atau menangani alarm. Penyedia berisi tindakan Intent ACTION_SET_ALARM dan tambahan yang dapat digunakan untuk memulai Aktivitas guna menyetel alarm baru di aplikasi jam alarm. Aplikasi yang ingin menerima Intent SET_ALARM harus membuat aktivitas yang memerlukan izin SET_ALARM. Aplikasi yang ingin membuat alarm baru harus menggunakan Context.startActivity(), sehingga pengguna memiliki opsi untuk memilih aplikasi jam alarm yang akan digunakan.
    • MediaStore mendukung tindakan Intent baru, PLAY_FROM_SEARCH, yang memungkinkan aplikasi menelusuri media musik dan otomatis memutar konten dari hasil jika memungkinkan. Misalnya, aplikasi dapat memicu Intent ini sebagai hasil dari perintah pengenalan suara untuk mendengarkan musik.
    • MediaStore juga menambahkan flag MEDIA_IGNORE_FILENAME baru yang memberi tahu pemindai media untuk mengabaikan media dalam direktori yang memuatnya dan subdirektorinya. Developer dapat menggunakan ini untuk mencegah grafis muncul di Galeri dan juga mencegah suara dan musik aplikasi muncul di aplikasi Musik.
    • Penyedia Settings menambahkan tindakan Aktivitas baru APPLICATION_DETAILS_SETTINGS dan MANAGE_ALL_APPLICATIONS_SETTINGS, yang memungkinkan aplikasi menampilkan layar detail untuk aplikasi tertentu atau menampilkan layar Kelola Aplikasi.
    • Penyedia ContactsContract menambahkan jenis data ContactsContract.CommonDataKinds.SipAddress, untuk menyimpan alamat SIP (telepon internet) kontak.

    Lokasi

    • LocationManager kini melacak permintaan aplikasi yang menghasilkan penguncian layar saat aktif atau penguncian Wi-Fi sesuai dengan WorkSource, class yang dikelola sistem yang mengidentifikasi aplikasi.

      LocationManager melacak semua klien yang meminta update berkala, dan memberi tahu penyedianya tentang update tersebut sebagai parameter WorkSource, saat menetapkan waktu update minimumnya. Penyedia lokasi jaringan menggunakan WorkSource untuk melacak penguncian aktif dan Wi-Fi yang dimulai oleh aplikasi dan menambahkannya ke penggunaan baterai aplikasi yang dilaporkan dalam Kelola Aplikasi.

    • LocationManager menambahkan beberapa metode baru yang memungkinkan Aktivitas mendaftar untuk menerima pembaruan lokasi berkala atau satu kali berdasarkan kriteria yang ditentukan (lihat di bawah).
    • Class Criteria baru memungkinkan aplikasi menentukan serangkaian kriteria untuk memilih penyedia lokasi. Misalnya, penyedia dapat diurutkan sesuai dengan akurasi, penggunaan daya, kemampuan untuk melaporkan ketinggian, kecepatan, dan bearing, serta biaya moneter.

    Penyimpanan

    • Android 2.3 menambahkan StorageManager baru yang mendukung file OBB (Opaque Binary Blob). Meskipun dukungan platform untuk OBB tersedia di Android 2.3, alat pengembangan untuk membuat dan mengelola file OBB tidak akan tersedia hingga awal tahun 2011.
    • Platform Android 2.3 menambahkan dukungan resmi untuk perangkat yang tidak menyertakan kartu SD (meskipun menyediakan partisi Kartu SD virtual, jika tidak ada kartu SD fisik). Metode praktis, isExternalStorageRemovable(), memungkinkan aplikasi menentukan apakah kartu SD fisik ada atau tidak.

    Pengelola Paket

    Telepon

    Akses native ke siklus proses Aktivitas, jendela

    Android 2.3 mengekspos serangkaian API ke aplikasi yang menggunakan kode native. Kelas framework yang menarik untuk aplikasi tersebut meliputi:

    • NativeActivity adalah jenis class Aktivitas baru, yang callback siklus proses-nya diimplementasikan langsung dalam kode native. NativeActivity dan kode native yang mendasarinya berjalan di sistem sama seperti Aktivitas lainnya — khususnya yang berjalan dalam proses sistem aplikasi Android dan dieksekusi di UI thread utama aplikasi, dan menerima callback siklus proses yang sama seperti Aktivitas lainnya.
    • Class InputQueue dan antarmuka callback yang baru memungkinkan kode native mengelola antrean peristiwa.
    • Antarmuka SurfaceHolder.Callback2 baru memungkinkan kode native mengelola SurfaceHolder.
    • Metode takeInputQueue dan takeSurface() baru di Window memungkinkan kode native mengelola peristiwa dan platform.

    Untuk informasi selengkapnya tentang menggunakan kode native atau mendownload NDK, lihat halaman Android NDK.

    Runtime Dalvik

    Elemen dan atribut manifes baru

    • Atribut xlargeScreens baru untuk elemen <supports-screens>, untuk menunjukkan apakah aplikasi mendukung faktor bentuk layar besar ekstra. Untuk mengetahui detailnya, lihat Mendukung Beberapa Layar.
    • Nilai baru untuk atribut android:screenOrientation dari elemen <activity>:
      • "reverseLandscape" — Aktivitas ingin layar dalam orientasi lanskap diputar ke arah yang berlawanan dari lanskap normal.
      • "reversePortrait" — Aktivitas ingin memiliki layar dalam orientasi potret, yang diputar ke arah yang berlawanan dari potret normal.
      • "sensorLandscape" — Aktivitas ingin memiliki layar dalam orientasi lanskap, tetapi dapat menggunakan sensor untuk mengubah arah hadap layar.
      • "sensorPortrait" — Aktivitas ingin memiliki layar dalam orientasi potret, tetapi dapat menggunakan sensor untuk mengubah ke arah mana layar menghadap.
      • "fullSensor" — Orientasi ditentukan oleh sensor orientasi fisik: layar akan berputar berdasarkan cara pengguna menggerakkan perangkat. Hal ini memungkinkan 4 kemungkinan rotasi, terlepas dari yang biasanya dilakukan perangkat (misalnya, beberapa perangkat biasanya tidak menggunakan rotasi 180 derajat).

    Izin Baru

    • com.android.permission.SET_ALARM — Mengizinkan aplikasi menyiarkan Intent untuk menyetel alarm bagi pengguna. Aktivitas yang menangani tindakan Intent SET_ALARM harus memerlukan izin ini.
    • android.permission.USE_SIP — Mengizinkan aplikasi menggunakan SIP API untuk melakukan atau menerima panggilan internet.
    • android.permission.NFC — Mengizinkan aplikasi menggunakan NFC API untuk membaca tag NFC.

    Konstanta Fitur Baru

    Platform ini menambahkan beberapa fitur hardware baru yang dapat dideklarasikan developer dalam manifes aplikasi sebagai diperlukan oleh aplikasi mereka. Hal ini memungkinkan developer mengontrol cara pemfilteran aplikasi, saat dipublikasikan di Google Play.

    Untuk mengetahui informasi selengkapnya tentang cara mendeklarasikan fitur dan menggunakannya untuk pemfilteran, lihat dokumentasi untuk <uses-feature>.

    Laporan perbedaan API

    Untuk melihat tampilan mendetail semua perubahan API di Android 2.3 (API Level 9), lihat Laporan Perbedaan API.

    API Level

    Platform Android 2.3 menghadirkan versi API framework yang telah diupdate. Android 2.3 API diberikan ID bilangan bulat — 9 — yang disimpan dalam sistem itu sendiri. ID ini, yang disebut "API Level", memungkinkan sistem menentukan dengan benar apakah aplikasi kompatibel dengan sistem, sebelum menginstal aplikasi.

    Untuk menggunakan API yang diperkenalkan di Android 2.3 dalam aplikasi, Anda perlu mengompilasi aplikasi tersebut ke library Android yang disediakan dalam platform SDK Android 2.3. Bergantung pada kebutuhan, Anda mungkin juga perlu menambahkan atribut android:minSdkVersion="9" ke elemen <uses-sdk> dalam manifes aplikasi. Jika aplikasi Anda dirancang untuk hanya berjalan pada Android 2.3 dan yang lebih tinggi, mendeklarasikan atribut akan mencegah aplikasi diinstal pada versi platform yang lebih lama.

    Untuk informasi selengkapnya, baca Apa itu API Level?