واجهات برمجة التطبيقات لنظام التشغيل Android 2.3.4

مستوى واجهة برمجة التطبيقات: 10

‫Android 2.3.4 (GINGERBREAD_MR1) هو إصدار صيانة يضيف العديد من الإصلاحات والتعديلات إلى نظام Android 2.3، بدون أي تغييرات في واجهة برمجة التطبيقات مقارنةً بإصدار Android 2.3.3. بالإضافة إلى ذلك، يوفّر الإصدار 2.3.4 من Android إمكانية استخدام واجهة برمجة التطبيقات Open Accessory API على الأجهزة الجوّالة، من خلال مكتبة Open Accessory Library الاختيارية.

أمّا المطوّرون، فيتوفّر النظام الأساسي Android 2.3.4 قابل للتنزيل لحزمة Android SDK. تتضمن المنصة القابلة للتنزيل مكتبة Android وصورة نظام، بالإضافة إلى مجموعة من مظاهر و أخرى. لبدء تطوير التطبيقات أو اختبارها وفقًا للإصدار 2.3.4 من نظام التشغيل Android، استخدِم "مدير حزمة تطوير البرامج (SDK) لنظام التشغيل Android" لتنزيل النظام الأساسي في حزمة تطوير البرامج (SDK) الخاصة بك.

نظرة عامة على واجهة برمجة التطبيقات

يوفّر Android 2.3.4 واجهة برمجة التطبيقات لإطار العمل نفسه للتطبيقات مثل Android 2.3.3. (المستوى 10 من واجهة برمجة التطبيقات) للحصول على ملخّص لواجهة برمجة التطبيقات، يُرجى الاطّلاع على ملاحظات إصدار Android 2.3.3.

فتح "مكتبة الملحقات"

Open Accessory هي ميزة جديدة لدمج الأجهزة الطرفية المتصلة بالتطبيقات التي تعمل على المنصة. القدرة يعتمد على مكدس USB (ناقل تسلسلي عالمي) مدمج في المنصة تعرض واجهة برمجة التطبيقات للتطبيقات. يتم توصيل الأجهزة الملحقة التي يتم توصيلها بالأجهزة التي تعمل بنظام التشغيل Android كإكسسوارات كمضيفات USB.

تم طرح Open Accessory في Android 3.1 (المستوى 12 لواجهة برمجة التطبيقات)، ولكن تم إتاحة هذا الإطار للأجهزة التي تعمل بنظام التشغيل Android 2.3.4 من خلال مكتبة خارجية optional ، وهي مكتبة Open Accessory Library. تعرض المكتبة واجهة برمجة تطبيقات لإطار العمل تتيح للتطبيقات اكتشاف مجموعة متنوعة من أنواع الأجهزة المتصلة عبر USB والتواصل معها وإدارتها. ويوفّر أيضًا تنفيذ واجهة برمجة التطبيقات مع أجزاء من نظام Android الأساسي غير المعروضة مباشرةً للتطبيقات في Android 2.3.4.

تكون "مكتبة الملحقات المفتوحة" اختيارية على أي جهاز معيّن. يمكن لصنّاع الأجهزة اختيار ما إذا كانوا يريدون تضمين "مكتبة الملحقات المفتوحة" في منتجاتهم أو استبعادها. تتلاءم المكتبة مع الإصدارات الأحدث من Android، مثل الإصدار 3.1، لذا ستعمل التطبيقات المطوّرة للإصدار 2.3.4 بشكلٍ سليم على الأجهزة التي تعمل بالإصدار 3.1، إذا كانت هذه الأجهزة متوافقة مع الملحقات التي تعمل عبر USB.

تعتمد واجهة برمجة التطبيقات التي توفرها مكتبة الإكسسوارات المفتوحة على مكتبة الملحقات المفتوحة. تتوفر واجهة برمجة التطبيقات (API) في الإصدار Android 3.1. وفي معظم المجالات، يمكنك استخدام الأساليب واجهات برمجة التطبيقات. مع ذلك، تختلف عملية تطوير مكتبة الإكسسوارات المفتوحة على نظام التشغيل Android 2.3.4 من واجهة برمجة تطبيقات USB العادية بهذه الطرق:

  • الحصول على كائن UsbManager: للحصول على كائن UsbManager عند استخدام المكتبة الإضافية، استخدِم الطريقة المساعدة getInstance() بدلاً من getSystemService() مثل:

    Kotlin

    val manager = UsbManager.getInstance(this)

    Java

    UsbManager manager = UsbManager.getInstance(this);
  • الحصول على UsbAccessory من هدف تمّت فلترته - عند فلترة البيانات بحثًا عن جهاز أو ملحق متصل بهدف فسيتم تضمين الكائن UsbAccessory داخل الغرض الذي يتم تمريره إلى طلبك. إذا كنت تستخدِم مكتبة الإضافة، يمكنك الحصول على عنصر UsbAccessory بالطريقة التالية:

    Kotlin

    val accessory = UsbManager.getAccessory(intent)

    Java

    UsbAccessory accessory = UsbManager.getAccessory(intent)
  • عدم توفّر مضيف USB: لا يتوافق الإصدار 2.3.4 من نظام التشغيل Android ومكتبة Open Accessory Library مع وضع مضيف USB (على سبيل المثال، من خلال UsbDevice)، على الرغم من توفّر وضع مضيف USB في الإصدار 3.1 من نظام التشغيل Android. لا يمكن لجهاز Android الذي يعمل بالإصدار 2.3.4 العمل كمضيف USB. تتيح المكتبة للجهاز الذي يعمل بنظام التشغيل Android العمل كهاتف ملحق فقط، مع عمل الملحق المتصل كمضيف USB (من خلال UsbAccessory).

لتطوير تطبيقات باستخدام مكتبة Open Accessory Library، ستحتاج إلى ما يلي:

  • أحدث إصدار من أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android
  • أحدث إصدار من إضافة Google APIs والذي يتضمّن المكتبة نفسها (للربط)
  • جهاز فعلي يعمل بنظام التشغيل Android 2.3.4 (أو Android 3.1) مع USB دعم الملحقات، لاختبار وقت التشغيل على الأجهزة المتصلة

للحصول على مناقشة كاملة حول كيفية تطوير التطبيقات التي تتفاعل مع ملحقات USB، يُرجى الاطّلاع على مستندات المطوّرين ذات الصلة.

بالإضافة إلى ذلك، يمكن للمطوّرين طلب الفلترة على Google Play، بحيث لا تتوفّر تطبيقاتهم للمستخدمين الذين لا توفّر أجهزتهم التوافق مع الملحقات المناسبة. لطلب الفلترة، أضِف العنصر أدناه إلى بيان التطبيق:

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

مستوى واجهة برمجة التطبيقات

لا يزيد نظام Android 2.3.4 من مستوى واجهة برمجة التطبيقات، ويستخدم المستوى نفسه لواجهة برمجة التطبيقات مثل Android 2.3.3، وهو المستوى 10.

لاستخدام واجهات برمجة التطبيقات التي تم تقديمها في المستوى 10 من واجهة برمجة التطبيقات في تطبيقك، عليك تجميع التطبيق باستخدام مكتبة Android المقدَّمة في أحدث إصدار من "إضافة Google APIs"، والتي تتضمّن أيضًا مكتبة Open Accessory Library.

بناءً على احتياجاتك، قد يجب أيضًا إضافة android:minSdkVersion="10" إلى العنصر <uses-sdk> في العنصر البيان. إذا كان تطبيقك مصمّمًا للعمل على الإصدار 2.3.3 من نظام التشغيل Android والإصدارات الأحدث فقط، يؤدي تحديد السمة إلى منع تثبيت التطبيق على الإصدارات الأقدم من المنصة.

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة ما هي واجهة برمجة التطبيقات؟ ما هو المستوى؟