واجهات برمجة تطبيقات Android 2.3.4

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

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

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

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

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

فتح مكتبة الإكسسوارات

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

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

مكتبة الإكسسوار المفتوحة اختيارية على أي جهاز محدد. الجهاز الشركات المصنعة باختيار تضمين مكتبة الإكسسوارات المفتوحة في المنتجات أو استبعادها. وتتوافق المكتبة مع الإصدارات القديمة من نظام التشغيل Android 3.1، ولذلك سيتم تشغيل التطبيقات التي تم تطويرها وفقًا للإصدار 2.3.4 من نظام التشغيل Android بشكل صحيح على الأجهزة. يعمل بنظام التشغيل Android 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، حيث يتوفر كل من Android 2.3.4 ومكتبة الإكسسوارات المفتوحة. لا يتوافق مع وضع مضيف USB (من خلال UsbDevice مثلاً)، على الرغم من أنّ وضع مضيف USB متوافق مع Android. 3.1. لا يمكن لأي جهاز يعمل بنظام التشغيل Android يعمل بالإصدار 2.3.4 من Android العمل كوحدة USB المضيف. تمكّن المكتبة الجهاز الذي يعمل بنظام التشغيل Android من العمل جهاز ملحق فقط، مع عمل الملحق المتصل كمضيف USB (من خلال UsbAccessory).

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

  • أحدث إصدار من أدوات حزمة تطوير البرامج (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 مكتبة الإكسسوارات.

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

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