Android 2.3.4 API'leri

API Düzeyi: 10

Android 2.3.4 (GINGERBREAD_MR1), Android 2.3.3'ten herhangi bir API değişikliği olmaksızın 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ı Açık Aksesuar Kitaplığı aracılığıyla mobil cihazlara Open Accessory API desteği de sağlar.

Geliştiriciler, Android 2.3.4 platformu, Android SDK'sı için indirilebilir bir bileşen olarak kullanılabilir. İndirilebilir platformda bir Android kitaplığı ve sistem görüntüsünün yanı sıra bir dizi emülatör dış görünümü ve daha fazlası bulunur. Android 2.3.4 sürümünü geliştirmeye veya test etmeye başlamak için Android SDK Yöneticisi'ni kullanarak platformu SDK'nıza indirin.

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 uygulamalara entegre etmek için kullanılan yeni bir özelliktir. Bu işlev, platformda yerleşik olarak bulunan bir USB (Evrensel Seri Yol) yığınına ve uygulamalarda kullanılabilen bir API'ye dayanır. Android destekli cihazlara aksesuar olarak USB ana makineleri olarak bağlanan çevre birimleri.

Açık Aksesuar, Android 3.1'de (API düzeyi 12) kullanıma sunulmuştur ancak isteğe bağlı bir harici kitaplık olan Açık Aksesuar Kitaplığı aracılığıyla Android 2.3.4 çalıştıran cihazlarda kullanıma sunulmuştur. Kitaplıkta, uygulamaların USB üzerinden bağlanan çeşitli cihaz türlerini keşfetmesine, yönetmesine ve yönetmesine olanak tanıyan bir çerçeve API'si gösterilir. Ayrıca API'nin, Android platformunun Android 2.3.4'teki uygulamaların doğrudan kullanımına açık olmayan bölümlerine uygulanmasını da 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 uyumlu olduğundan Android 2.3.4'e dayalı olarak geliştirilen uygulamalar, USB aksesuarlarını destekliyorsa Android 3.1 çalıştıran cihazlarda düzgün bir şekilde çalışır.

Açık Aksesuar Kitaplığı tarafından sağlanan API, Android 3.1'de sunulan Açık Aksesuar API'sini temel alır. Çoğu alanda aynı teknikleri ve API'leri kullanabilirsiniz. Ancak Android 2.3.4'te Açık Aksesuar Kitaplığı için geliştirme yapmak, standart USB API'den şu yönleriyle farklıdır:

  • UsbManager nesnesi edinme: Eklenti kitaplığını kullanırken UsbManager nesnesi elde etmek 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: Amaç filtresi olan bağlı bir cihazı veya aksesuarı filtrelediğinizde 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. USB ana makine modu Android 3.1'de desteklense de Android 2.3.4 ve Açık Aksesuar Kitaplığı, USB ana makine modunu (örneğin, UsbDevice üzerinden) desteklemez. Android 2.3.4 çalıştıran Android destekli bir cihaz, USB ana makinesi olarak çalışamaz. Kitaplık, Android destekli cihazın yalnızca çevre birimi işlevi görmesini sağlar. Bağlı aksesuar, USB ana makinesi olarak (UsbAccessory üzerinden) çalışır.

Açık Aksesuar Kitaplığı'nı kullanarak uygulama geliştirmek için aşağıdakilere ihtiyacınız vardır:

  • Android SDK araçlarının en son sürümü
  • Google API'leri eklentisinin, kitaplığın kendisini de içeren en son sürümü (bağlantı için)
  • Bağlı cihazlarda çalışma zamanı testi için, USB aksesuarlarının desteklendiği 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 ilişkin kapsamlı bir açıklama için lütfen ilgili geliştirici belgelerine bakın.

Ayrıca geliştiriciler, cihazlarında uygun aksesuar desteği sağlamayan kullanıcıların uygulamalarını kullanamayacak şekilde Google Play'de filtreleme isteğinde bulunabilirler. 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 sunulan API'leri kullanmak için uygulamayı, Açık 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, uygulama manifestindeki <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 özelliğin bildirilmesi, uygulamanın platformun önceki sürümlerine yüklenmesini engeller.

Daha fazla bilgi için API Düzeyi nedir?