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

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

Android 4.0.3 (ICE_CREAM_SANDWICH_MR1) هو إصدار تدريجي من مجموعة النظام الأساسي Android 4.0 (ICE_CREAM_SANDWICH). يتضمن هذا الإصدار ميزات جديدة للمستخدمين والمطورين وتغييرات في واجهة برمجة التطبيقات وإصلاحات أخطاء متنوعة.

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

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

تقدم الأقسام أدناه نظرة عامة فنية على واجهات برمجة التطبيقات الجديدة في Android 4.0.3.

واجهة برمجة تطبيقات ساحة مشاركات الشبكات الاجتماعية في جهات الاتصال

يمكن الآن للتطبيقات التي تستخدم بيانات تدفقات الشبكات الاجتماعية مثل تحديثات الحالة وعمليات التحقق مزامنة تلك البيانات مع كل جهة من جهات اتصال المستخدم، وتوفير العناصر في ساحة المشاركات مع صور لكل منها.

يتم تحديد جدول قاعدة البيانات الذي يحتوي على ساحة المشاركات الاجتماعية لجهة اتصال فردية من خلال android.provider.ContactsContract.StreamItems، وهو معرّف الموارد المنتظم (URI) المدمج في دليل ContactsContract.RawContacts الذي تنتمي إليه عناصر ساحة المشاركات. يتضمن كل جدول بث اجتماعي عدة أعمدة للبيانات الوصفية حول كل عنصر بث، مثل رمز يمثل المصدر (صورة رمزية)، وتصنيف للعنصر، ومحتوى النص الأساسي، والتعليقات حول العنصر (مثل الردود من أشخاص آخرين)، وغير ذلك. يتم تخزين الصور المرتبطة بساحة المشاركات في جدول آخر يحدده android.provider.ContactsContract.StreamItemPhotos، المتاح في شكل دليل فرعي من android.provider.ContactsContract.StreamItems Uri.

للحصول على مزيد من المعلومات، يمكنك الاطّلاع على android.provider.ContactsContract.StreamItems وandroid.provider.ContactsContract.StreamItemPhotos.

لقراءة عناصر ساحة المشاركات على الشبكات الاجتماعية أو كتابتها لجهة اتصال، يجب أن يطلب التطبيق إذنًا من المستخدم من خلال تعريف <uses-permission android:name="android.permission.READ_SOCIAL_STREAM"> و/أو <uses-permission android:name="android.permission.WRITE_SOCIAL_STREAM"> في ملفات البيان لديه.

موفِّر التقويم
  • تضيف الفئة CalendarContract.Colors لتمثيل جدول ألوان في التقويم Provider. توفر الفئة حقولاً للوصول إلى الألوان المتاحة لحساب معين. تتم الإشارة إلى الألوان من خلال COLOR_KEY الذي يجب أن يكون فريدًا لاسم/نوع حساب معيّن. لا يمكن تعديل هذه القيم إلا باستخدام محوِّل المزامنة.
  • تضيف ALLOWED_AVAILABILITY وALLOWED_ATTENDEE_TYPES للحصول على دعم التبادل/المزامنة.
  • تضيف TYPE_RESOURCE (مثل قاعات المؤتمرات) للحاضرين و AVAILABILITY_TENTATIVE، بالإضافة إلى EVENT_COLOR_KEY للفعاليات.

تطبيقات الشاشة الرئيسية المصغّرة

بدءًا من نظام التشغيل Android 4.0، يجب ألا تتضمن أدوات الشاشة الرئيسية المساحة المتروكة الخاصة بها بعد الآن. بدلاً من ذلك، يضيف النظام الآن مساحة متروكة تلقائيًا لكل أداة، بناءً على خصائص الشاشة الحالية. يؤدي هذا إلى عرض أكثر توحيدًا واتساقًا للأدوات في شبكة. لمساعدة التطبيقات التي تستضيف التطبيقات المصغّرة للشاشة الرئيسية، يوفّر النظام الأساسي طريقة جديدة getDefaultPaddingForWidget(). يمكن أن تستدعي التطبيقات هذه الطريقة للحصول على المساحة المتروكة المحددة من النظام وحسابها عند حساب عدد الخلايا المخصصة للتطبيق المصغّر.

التدقيق الإملائي

  • بالنسبة إلى التطبيقات التي يمكنها الوصول إلى خدمات المدقق الإملائي، تلغي طريقة cancel() جديدة أي مهام للمدقق الإملائي قيد التشغيل في إحدى الجلسات في انتظار المراجعة.
  • بالنسبة إلى خدمات المدقق الإملائي، هناك علامة اقتراحات جديدة، RESULT_ATTR_HAS_RECOMMENDED_SUGGESTIONS، تتيح للخدمات التفريق بين الاقتراحات الأكثر ثقة وتلك الاقتراحات الأقل ثقة. على سبيل المثال، يمكن للمدقق الإملائي وضع العلامة إذا كانت الكلمة التي تم إدخالها ليست في قاموس المستخدم، ولكن من المحتمل أن يكون لها اقتراحات، أو لم يضبط العلامة إذا لم تكن الكلمة المدخلة في القاموس وتحتوي على اقتراحات من المرجح أن تكون أقل فائدة.

    يمكن للتطبيقات المرتبطة بالمدقق الإملائي استخدام العلامة RESULT_ATTR_HAS_RECOMMENDED_SUGGESTIONS مع سمات اقتراحات أخرى، بالإضافة إلى الطريقتَين getSuggestionsAttributes() وgetSuggestionsCount()، لتحديد ما إذا كان سيتم وضع علامة على كلمات الإدخال باعتبارها أخطاءً إملائية وتقديم اقتراحات.

  • يشير نمط FLAG_AUTO_CORRECTION الجديد لامتدادات النص إلى أنّ التصحيح التلقائي على وشك تطبيقه على كلمة/نص يكتبها المستخدم أو ينشئها المستخدم. يتم عرض هذا النوع من الاقتراحات بشكل مختلف للإشارة إلى حدوث التصحيح التلقائي.

البلوتوث

تتيح الطريقتان العامتان الجديدتان fetchUuidsWithSdp() وgetUuids() للتطبيقات تحديد الميزات (UUID) التي يتيحها الجهاز البعيد. في حالة fetchUuidsWithSdp()، يجري النظام اكتشاف خدمة على الجهاز البعيد للحصول على أرقام التعريف الفريدة العالمية (UUID) المتوافقة، ثم ينشر النتيجة في هدف ACTION_UUID.

مجموعة أدوات واجهة المستخدم

تتيح الطريقتان الجديدتان setUserVisibleHint() وgetUserVisibleHint() للجزء ضبط تلميح عمّا إذا كان المحتوى مرئيًا للمستخدم حاليًا أم لا. يؤجِّل النظام بدء الأجزاء غير المرئية للمستخدم إلى أن يتم تشغيل برامج تحميل الأجزاء المرئية. يكون تلميح مستوى العرض هو "صحيح" تلقائيًا.

الرسومات

تسهيل الاستخدام

  • يمكن لعملاء RemoteViews الآن استخدام الطريقة setContentDescription() لضبط وصف محتوى أي طريقة عرض والحصول عليه ضمن التنسيق المضخَّم.
  • تسمح الطرق getMaxScrollX() وgetMaxScrollY() وsetMaxScrollX() و setMaxScrollY() للتطبيقات بالحصول على الحد الأقصى لإزاحة التمرير في عنصر AccessibilityRecord وضبطه.
  • عند تفعيل وضع الاستكشاف باللمس، يشير إعداد الأمان الجديد ACCESSIBILITY_SPEAK_PASSWORD إلى ما إذا كان المستخدم يطلب من أداة IME لقراءة النص الذي تم إدخاله في حقول كلمة المرور، حتى عندما لا تكون سماعة الرأس قيد الاستخدام. بشكل افتراضي، لا يتم نطق نص كلمة المرور ما لم تكن سماعة رأس قيد الاستخدام.

تحويل النص إلى كلام

  • يضيف هذا الإعداد الطريقة الجديدة getFeatures()لإجراء طلبات بحث وتفعيل ميزة "تحويل النص إلى كلام" للشبكة.
  • إضافة فئة جديدة للمستمعين، UtteranceProgressListener، يمكن للمحرّكات تسجيلها لتلقّي إشعار بأخطاء تركيب الكلام.

قاعدة البيانات

  • تتيح فئة CrossProcessCursorWrapper الجديدة لموفّري المحتوى عرض نتائج لطلب بحث متعدد العمليات بكفاءة أكبر. الفئة الجديدة هي لبنة أساسية مفيدة لإحاطة المؤشرات التي سيتم إرسالها إلى العمليات عن بُعد. ويمكنه أيضًا تحويل كائنات Cursor العادية إلى كائنات CrossProcessCursor بشفافية.

    تُصلح الفئة CrossProcessCursorWrapper مشاكل الأداء والأخطاء الشائعة التي واجهت التطبيقات عند الاستعانة بموفِّري المحتوى.

  • تأخذ الدالة الإنشائية CursorWindow(java.lang.String) الآن سلسلة الاسم كإدخال. لم يعُد النظام يميّز بين نوافذ المؤشر المحلية ونوافذ المؤشر عن بُعد، لذلك تم الآن إيقاف CursorWindow(boolean) نهائيًا.

مكان ووقت الاستماع إلى الموسيقى

إضافة فئات جديدة لاستهداف الأنواع الشائعة من التطبيقات على الجهاز، مثل CATEGORY_APP_BROWSER وCATEGORY_APP_CALENDAR وCATEGORY_APP_MAPS وغيرها

الكاميرا

الأذونات

في ما يلي الأذونات الجديدة:

  • android.Manifest.permission#READ_SOCIAL_Stream و android.Manifest.permission#WRITE_SOCIAL_Stream: للسماح بمحوِّل مزامنة لقراءة بيانات ساحة المشاركات الاجتماعية وكتابتها إلى جهة اتصال في مقدِّم خدمة جهات الاتصال المشترك.

للحصول على عرض تفصيلي لجميع التغييرات في واجهة برمجة التطبيقات في Android 4.0.3 (المستوى 15 من واجهة برمجة التطبيقات)، يمكنك الاطّلاع على تقرير الاختلافات في واجهة برمجة التطبيقات.

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

يتم تخصيص معرّف عدد صحيح 15 لواجهة برمجة التطبيقات لنظام التشغيل Android 4.0.3 يتم تخزينه في النظام نفسه. يتيح هذا المعرّف، المعروف باسم "مستوى واجهة برمجة التطبيقات"، للنظام تحديد ما إذا كان التطبيق متوافقًا مع النظام بشكل صحيح قبل تثبيته.

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

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