Android 2.3.4 API'leri

API Düzeyi: 10

Android 2.3.4 (GINGERBREAD_MR1), Android 2.3.3'teki API değişiklikleri olmadan Android 2.3 platformuna çeşitli hata düzeltmeleri ve yamalar ekleyen bir bakım sürümüdür. Ayrıca Android 2.3.4, isteğe bağlı Open Accessory Library aracılığıyla mobil cihazlarda Open Accessory API desteği sunar.

Geliştiriciler için Android 2.3.4 platformu, Android SDK için indirilebilir bir bileşen olarak mevcuttur. İndirilebilir platformda Android kitaplığı ve sistem resminin yanı sıra bir dizi emülatör kaplaması ve daha fazlası bulunur. Android 2.3.4 için geliştirmeye veya test etmeye başlamak istiyorsanız platformu SDK'nıza indirmek için Android SDK Yöneticisi'ni kullanın.

API'ye Genel Bakış

Android 2.3.4, uygulamalara Android 2.3.3 (API düzeyi 10) ile aynı çerçeve API'sini sağlar. API'nin özeti için Android 2.3.3 sürüm notlarına bakın.

Aksesuar Kitaplığı'nı aç

Açık Aksesuar, bağlı çevre birimlerini platformda çalışan uygulamalarla entegre etmek için yeni bir özelliktir. Bu özellik, platforma yerleştirilmiş bir USB (Evrensel Seri Yol) yığınını ve uygulamalara sunulan bir API'yi temel alır. Android destekli cihazlara aksesuar olarak takılan çevre birimleri, USB ana makineleri olarak bağlanır.

Açık Aksesuar, Android 3.1'de (API düzeyi 12) kullanıma sunulmuştur, ancak isteğe bağlı harici bir kitaplık olan Open Accessory Library aracılığıyla Android 2.3.4 çalıştıran cihazlarda kullanıma sunulmuştur. Kitaplık, uygulamaların USB üzerinden bağlı çeşitli cihaz türlerini keşfetmesine, bu cihazlarla iletişim kurmasına ve bunları yönetmesine olanak tanıyan bir çerçeve API'si sağlar. Ayrıca, Android 2.3.4'te uygulamalara doğrudan sunulmayan Android platformunun bölümlerine karşı API'nin uygulanmasını sağlar.

Açık Aksesuar Kitaplığı, tüm cihazlarda isteğe bağlıdır. Cihaz üreticileri, Açık Aksesuar Kitaplığı'nı ürünlerine dahil etmeyi veya hariç tutmayı seçebilir. Kitaplık, Android 3.1 ile ileriye dönük uyumludur. Bu nedenle, Android 2.3.4 için geliştirilen uygulamalar, USB aksesuarlarını destekleyen Android 3.1 çalıştıran cihazlarda düzgün şekilde çalışır.

Open Accessory Library tarafından sağlanan API, Android 3.1'de sağlanan Open Accessory API'ye dayanır. Çoğu alanda aynı teknikleri ve API'leri kullanabilirsiniz. Bununla birlikte, Android 2.3.4'te Açık Aksesuar Kitaplığı için geliştirme yapmak, standart USB API'sinden şu yönleriyle farklıdır:

  • UsbManager nesnesi alma: Eklenti kitaplığını kullanırken UsbManager nesnesini almak için getSystemService() yerine getInstance() yardımcı yöntemini kullanın. Örneğin:

    Kotlin

    val manager = UsbManager.getInstance(this)

    Java

    UsbManager manager = UsbManager.getInstance(this);
  • Filtrelenmiş bir amaçtan UsbAccessory elde etme: Niyet filtresiyle bağlı bir cihaz veya aksesuar için filtre uyguladığınızda UsbAccessory nesnesi uygulamanıza iletilen amacın içinde yer alır. Eklenti kitaplığını kullanıyorsanız UsbAccessory nesnesini aşağıdaki şekilde alabilirsiniz:

    Kotlin

    val accessory = UsbManager.getAccessory(intent)

    Java

    UsbAccessory accessory = UsbManager.getAccessory(intent)
  • USB ana makine desteği yoktur. Android 2.3.4 ve Açık Aksesuar Kitaplığı, USB ana makine modunu (örneğin, UsbDevice aracılığıyla) desteklemez ancak USB ana makine modu Android 3.1'de desteklenir. Android 2.3.4 yüklü Android cihazlar USB ana makinesi olarak kullanılamaz. Kitaplık, Android destekli cihazın yalnızca çevre birimi olarak çalışmasını sağlar. Bağlı aksesuar, USB ana makinesi olarak çalışır (UsbAccessory üzerinden).

Açık Aksesuar Kitaplığı'nı kullanarak uygulama geliştirmek için:

  • Android SDK araçlarının en son sürümü
  • Google API'leri eklentisinin en son sürümü (bağlantı oluşturmak için kitaplığı içerir)
  • Bağlı cihazlara karşı çalışma zamanı testi yapmak için USB aksesuar destekli Android 2.3.4 (veya Android 3.1) çalıştıran gerçek bir donanım cihazı

USB aksesuarlarıyla etkileşimde bulunan uygulamaların nasıl geliştirileceğine dair kapsamlı bir açıklama için lütfen ilgili geliştirici belgelerine bakın.

Ayrıca geliştiriciler, Google Play'de filtreleme isteğinde bulunarak uygulamalarının, cihazlarında uygun aksesuar desteği bulunmayan kullanıcılara sunulmamasını sağlayabilir. Filtreleme isteğinde bulunmak için aşağıdaki öğeyi uygulama manifest dosyasına ekleyin:

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

API düzeyi

Android 2.3.4 platformu, API düzeyini artırmaz. Android 2.3.3, API düzeyi 10 ile aynı API düzeyini kullanır.

Uygulamanızda API düzeyi 10'da kullanıma sunulan API'leri kullanmak için uygulamayı, Open Aksesuar Kitaplığı'nı da içeren Google API'leri Eklentisi'nin en son sürümünde sağlanan Android kitaplığına göre derlemeniz gerekir.

İhtiyaçlarınıza bağlı olarak, uygulamanın manifest dosyasındaki <uses-sdk> öğesine bir android:minSdkVersion="10" özelliği eklemeniz de gerekebilir. Uygulamanız yalnızca Android 2.3.3 ve sonraki sürümlerde çalışacak şekilde tasarlandıysa bu özelliğin belirtilmesi, uygulamanın platformun önceki sürümlerine yüklenmesini engeller.

Daha fazla bilgi için API seviyesi nedir? başlıklı makaleyi okuyun.