مستوى واجهة برمجة التطبيقات: 13
الإصدار Android 3.2 (HONEYCOMB_MR2
) هو إصدار نظام أساسي تزايدي يضيف
للمستخدمين والمطورين. تقدّم الأقسام أدناه نظرة عامة
على الميزات الجديدة وواجهات برمجة التطبيقات المخصّصة للمطوّرين.
أمّا المطوّرون، فيتوفّر نظام التشغيل Android 3.2 الأساسي قابل للتنزيل لحزمة Android SDK. تتضمن المنصة القابلة للتنزيل مكتبة Android وصورة نظام، بالإضافة إلى مجموعة من مظاهر و أخرى. لبدء تطوير التطبيقات أو اختبارها وفقًا للإصدار 3.2 من نظام التشغيل Android، استخدِم "مدير حزمة تطوير البرامج (SDK) لنظام التشغيل Android" لتنزيل النظام الأساسي في حزمة تطوير البرامج (SDK) الخاصة بك.
أهم اللقطات في المنصة
الميزات الجديدة للمستخدم
- تحسينات لمجموعة أكبر من الأجهزة اللوحية
يتضمّن الإصدار 3.2 من Android مجموعة متنوعة من التحسينات على مستوى النظام لضمان تجربة مستخدم رائعة على مجموعة أكبر من أجهزة الكمبيوتر اللوحي.
- تكبير التوافق للتطبيقات ذات الحجم الثابت
يقدّم نظام التشغيل Android 3.2 وضع تكبير التوافق الجديد الذي يوفّر للمستخدمين طريقة جديدة لعرض التطبيقات ذات الحجم الثابت على الأجهزة الأكبر حجمًا. يقدّم الوضع الجديد بديلاً مُعدَّلًا بالبكسل لتمديد واجهة المستخدم العادية للتطبيقات التي لم يتم تصميمها للتشغيل على أحجام شاشات أكبر، مثل الأجهزة اللوحية. الوضع الجديد هو يمكن للمستخدمين الوصول إليها من رمز قائمة في شريط النظام، للتطبيقات التي تحتاج التوافقية.
- مزامنة الوسائط من بطاقة SD
يمكن للمستخدمين الآن تحميل ملفات الوسائط مباشرةً على الأجهزة التي تتيح استخدام بطاقة SD. من بطاقة SD إلى التطبيقات التي تستخدمها. توفّر إحدى مرافق النظام إمكانية وصول التطبيقات إلى الملفات من خلال "متجر وسائط النظام".
ميزات جديدة للمطوّرين
- واجهة برمجة تطبيقات موسعة لإدارة دعم الشاشات
يقدّم نظام Android 3.2 إضافات إلى واجهة برمجة التطبيقات الخاصة بدعم الشاشة في النظام الأساسي لمنح المطوّرين طرقًا إضافية لإدارة واجهة مستخدم التطبيق على جميع الأجهزة التي تعمل بنظام Android. تتضمن واجهة برمجة التطبيقات مؤهِّلات جديدة للموارد وسمات البيان التي تمنحك تحكمًا أكثر دقة في كيفية تُعرض التطبيقات بأحجام مختلفة، بدلاً من الاعتماد على وفئات الحجم.
لضمان أفضل عرض ممكن للتطبيقات ذات الحجم الثابت والتطبيقات التي تتضمّن عددًا محدودًا من الإعلانات، دعمًا لأحجام الشاشات المختلفة، يوفر النظام الأساسي أيضًا تكبيرًا جديدًا وضع التوافق الذي يعرض واجهة المستخدم على مساحة أصغر على الشاشة، ثم يضبطها على لملء المساحة المتوفرة على الشاشة. لمزيد من المعلومات عن Screen support API وعناصر التحكّم التي توفّرها، يُرجى الاطّلاع على الأقسام أدناه.
نظرة عامة على واجهة برمجة التطبيقات
واجهات برمجة تطبيقات دعم الشاشات
يقدّم Android 3.2 شاشات جديدة تتوافق مع واجهات برمجة التطبيقات التي تمنحك المزيد من التحكم في كيفية عرض تطبيقاتهم عبر أحجام الشاشات المختلفة. تعتمد واجهة برمجة التطبيقات هذه على واجهة برمجة التطبيقات الحالية لدعم الشاشات، بما في ذلك واجهة برمجة التطبيقات كثافة شاشة معمَّمة، ولكنها توسّع نطاقه مع القدرة على استهداف نطاقات شاشات محددة حسب أبعادها، ويتم قياسها وحدات بكسل مستقلة الكثافة (مثل 600 بكسل مستقل الكثافة أو بعرض 720 بكسل مستقل الكثافة)، بدلاً من حسب أحجام الشاشة المعممة (مثل كبيرة أو كبيرة جدًا)
عند تصميم واجهة مستخدم تطبيق ما، لا يزال بإمكانك الاعتماد على النظام الأساسي الكثافة التجريدية، مما يعني أن التطبيقات لن تحتاج إلى للتعويض عن الاختلافات في كثافة وحدات البكسل الفعلية عبر الأجهزة. إِنْتَ تصميم واجهة مستخدم التطبيق وفقًا للمقدار الأفقي أو الرأسي المساحة المتوفرة. تُعبّر المنصة عن مقدار المساحة المتاحة باستخدام ثلاث سمات جديدة: smallestWidth وwidth و height.
- smallestWidth للشاشة هو الحد الأدنى الأساسي لحجمها، ويُقاس بوحدات بكسل مستقلة الكثافة ("dp"). لارتفاع الشاشة أو العرض، فهو الأقصر بين الاثنين. بالنسبة إلى الشاشة في الوضع العمودي، يستند عادةً smallestWidth إلى عرضها، بينما يستند في الوضع الأفقي إلى ارتفاعها. في جميع الحالات، يتم اشتقاق smallestWidth من سمة ثابتة للشاشة ولا تتغيّر القيمة بغض النظر عن الاتجاه. يُعدّ smallestWidth مهماً للتطبيقات لأنّه يمثّل أقصر عرض ممكن يجب رسم واجهة مستخدم التطبيق فيه، باستثناء مناطق الشاشة التي يحتجزها النظام.
- في المقابل، يمثّل العرض والارتفاع للشاشة المساحة الأفقية أو العمودية الحالية المتاحة لتنسيق التطبيق، ويتم قياسها بوحدات "dp"، ولا تشمل مساحات الشاشة المحجوزة من قِبل النظام. يُعد العرض يتغيّر ارتفاع الشاشة عندما يبدِّل المستخدم الاتجاه بين الوضع الأفقي وعمودي.
تم تصميم واجهة برمجة التطبيقات الجديدة المتوافقة مع الشاشات للسماح لك بإدارة واجهة مستخدم التطبيق وفقًا لأصغر عرض للشاشة الحالية. يمكنك أيضًا إدارة واجهة مستخدم وفقًا للعرض أو الارتفاع الحالي حسب الحاجة لتحقيق هذه الأغراض، يوفّر واجهة برمجة التطبيقات الأدوات التالية:
- محددات موارد جديدة لاستهداف التنسيقات والموارد الأخرى لتحديد الحد الأدنى من smallestWidth أو العرض أو الارتفاع
- سمات جديدة في البيان لتحديد الحد الأقصى لنطاق التوافق مع الشاشة للتطبيق
بالإضافة إلى ذلك، لا يزال بإمكان التطبيقات الاستعلام عن النظام وإدارة واجهة المستخدم يتم تحميلها في وقت التشغيل، كما هو الحال في الإصدارات السابقة من النظام الأساسي.
ونظرًا لأن واجهة برمجة التطبيقات الجديدة تتيح لك استهداف الشاشات بشكل مباشر أكثر من خلال أصغر عرض، والعرض والارتفاع، فمن المفيد أن تفهم النموذج الخصائص المختلفة لأنواع الشاشات المختلفة. يقدّم الجدول أدناه بعض الأمثلة، ويتم قياسها بوحدات "dp".
النوع | الكثافة (المعمَّمة) | الأبعاد (وحدة بكسل مستقلة الكثافة) | أصغر عرض (dp) |
---|---|---|---|
الهاتف الأساسي | mdpi | 320×480 | 320 |
جهاز لوحي صغير/هاتف كبير | mdpi | 480x800 | 480 |
جهاز لوحي مقاس 7 بوصات | mdpi | 600 × 1024 | 600 |
جهاز لوحي مقاس 10 بوصات | mdpi | 800x1280 | 800 |
تقدِّم الأقسام أدناه مزيدًا من المعلومات عن مؤهِّلات الشاشة الجديدة. وسمات البيان. للحصول على معلومات كاملة عن كيفية استخدام واجهة برمجة التطبيقات screen support API، يُرجى الاطّلاع على مقالة إتاحة استخدام عدة شاشات.
معايير جديدة لمؤهّلات الموارد لتوافق الشاشات
تتيح لك محددات الموارد الجديدة في Android 3.2 استهداف تصاميمك بشكل أفضل لنطاقات أحجام الشاشة. باستخدام المحدّدات، يمكنك إنشاء إعدادات للموارد مصمّمة لعرض الحد الأدنى من smallestWidth أو العرض الحالي أو الارتفاع الحالي، ويتم قياسها بالبكسل المستقل عن الكثافة.
المؤهلات الجديدة هي:
-
swNNNdp
: لتحديد الحد الأدنى لقيمة smallestWidth التي يجب استخدام المورد عندها، ويتم قياسها بوحدات dp. كما ذكرنا أعلاه، فإنّ smallestWidth للشاشة ثابت بغض النظر عن الاتجاه. أمثلة: "sw320dp
" و"sw720dp
" و"sw720dp
" wNNNdp
وhNNNdp
— لتحديد الحد الأدنى العرض أو الارتفاع الذي يجب استخدام المورد عليه، ويتم قياسه بـ "dp" الوحدات. كما ذكرنا أعلاه، يرتبط عرض الشاشة وارتفاعها باتجاه الشاشة، ويتغيران عند تغيُّر الاتجاه. أمثلة:w320dp
وw720dp
وh1024dp
ويمكنك أيضًا إنشاء تهيئات موارد متداخلة متعددة إذا لزم الأمر. على سبيل المثال، يمكنك وضع علامة على بعض الموارد لاستخدامها على أي شاشة يزيد عرضها عن 480 بكسل مستقل الكثافة، والبعض الآخر يكون أكبر من 600 بكسل مستقل الكثافة عندما تكون إعدادات موارد متعددة مؤهَّلة لشاشة معيّنة، يختار النظام الإعداد الأقرب تطابقًا. للتحكم الدقيق في الموارد التي يتم تحميلها على شاشة معيّنة، يمكنك وضع علامة على الموارد مؤهِّل أو يجمع بين عدة مؤهلات جديدة أو حالية.
استنادًا إلى السمات النموذجية المذكورة سابقًا، إليك بعض الأمثلة على كيفية استخدام المؤهّلات الجديدة:
res/layout/main_activity.xml # For phones res/layout-sw600dp/main_activity.xml # For 7” tablets res/layout-sw720dp/main_activity.xml # For 10” tablets res/layout-w600dp/main_activity.xml # Multi-pane when enough width res/layout-sw600dp-w720dp/main_activity.xml # For large width
ستتجاهل الإصدارات القديمة من المنصة المؤهلات الجديدة، وبالتالي يمكنك لذا امزجها حسب الحاجة لضمان أن يظهر تطبيقك بشكل رائع على أي جهاز. في ما يلي بعض الأمثلة:
res/layout/main_activity.xml # For phones res/layout-xlarge/main_activity.xml # For pre-3.2 tablets res/layout-sw600dp/main_activity.xml # For 3.2 and up tablets
للحصول على معلومات كاملة عن كيفية استخدام المحدّدات الجديدة، يُرجى الاطّلاع على استخدام محدّدات الحجم الجديدة .
سمات جديدة في البيان لتوافق حجم الشاشة
يوفّر إطار العمل مجموعة جديدة من سمات بيان <supports-screens>
التي تتيح
يمكنك إدارة دعم تطبيقك لأحجام الشاشات المختلفة.
وعلى وجه التحديد، يمكنك تحديد أكبر وأصغر الشاشات التي تم تصميم تطبيقك للعمل عليها، بالإضافة إلى أكبر شاشة تم تصميمه للعمل عليها
بدون الحاجة إلى وضع ملاءمة الشاشة الجديد للنظام. مثل محددات الموارد الموضّحة أعلاه، تحدِّد سمات الملف الجديد
manifest نطاق الشاشات التي يتوافق معها التطبيق،
كما هو محدّد من خلال smallestWidth.
في ما يلي سمات البيان الجديدة المتوافقة مع الشاشة:
-
android:compatibleWidthLimitDp="numDp"
: تتيح لك هذه السمة تحديد الحد الأقصى لقيمة smallestWidth التي يمكن تشغيل التطبيق عليها بدون الحاجة إلى وضع التوافق. إذا كانت الشاشة الحالية أكبر من القيمة المحدّدة، يعرض النظام التطبيق في الوضع العادي ولكنه يسمح للمستخدم بالتبديل اختياريًا إلى وضع التوافق من خلال إعداد في شريط النظام. android:largestWidthLimitDp="numDp"
— هذه تحديد الحد الأقصى لعرض أصغر عرض له تم تصميمه للتشغيل. إذا كانت الشاشة الحالية أكبر من القيمة المحددة، يفرض النظام دخول التطبيق إلى وضع التوافق مع الشاشة، لضمان العرض على الشاشة الحالية.-
android:requiresSmallestWidthDp="numDp"
: تتيح لك هذه السمة تحديد الحد الأدنى لقيمة smallestWidth التي يمكن تشغيل التطبيق عندها. إذا كانت الشاشة الحالية أصغر من القيمة المحددة، فسيبدأ النظام التطبيق غير متوافق مع الجهاز، لكنه لا يمنعه من تثبيته وتشغيله.
ملاحظة: لا يفرِّط Google Play حاليًا في التطبيقات استنادًا إلى أيّ من السمات المذكورة أعلاه. سيكون دعم التصفية
تمت إضافتها في إصدار نظام أساسي لاحق. التطبيقات التي تتطلب
للفلترة استنادًا إلى حجم الشاشة، يمكن استخدام سمة <supports-screens>
الحالية
ذات الصلة.
للحصول على معلومات كاملة عن كيفية استخدام السمات الجديدة، راجع بيان دعم حجم الشاشة
وضع التوافق مع الشاشة
يوفّر نظام التشغيل Android 3.2 وضعًا جديدًا للتوافق مع حجم الشاشة للتطبيقات التي تعلن صراحةً عن عدم توافقها مع الشاشات الكبيرة مثل الشاشة التي يتم تشغيلها عليها. يتم ضبط وضع "التكبير/التصغير" الجديد هذا حسب وحدات البكسل، ما يؤدي إلى عرض التطبيق في مساحة أصغر على الشاشة ثم تكبير وحدات البكسل لتغطي الشاشة الحالية.
يوفّر النظام تلقائيًا وضع التوافق مع الشاشة كخيار للمستخدمين في التطبيقات. التي تتطلب ذلك. يمكن للمستخدمين تفعيل وضع التكبير أو التصغير وإيقافه باستخدام عنصر تحكُّم متاح. في شريط النظام.
بما أنّ وضع التوافق مع الشاشة الجديد قد لا يكون مناسبًا لجميع التطبيقات، تسمح المنصة للتطبيق بإيقافه باستخدام سماتملف البيان . ولن يوفّر النظام ميزة "تكبير/تصغير" في حال إيقاف هذا الإعداد من خلال التطبيق. التوافق كخيار للمستخدمين عند تشغيل التطبيق.
ملاحظة: للحصول على معلومات مهمة حول كيفية التحكّم في وضع التوافق في تطبيقاتك، يُرجى مراجعة مقالة وضع جديد للتطبيقات على الشاشات الكبيرة على مدوّنة مطوّري تطبيقات Android.
كثافة شاشة جديدة لأجهزة التلفزيون بدقة 720p والأجهزة المشابهة
لتلبية احتياجات التطبيقات التي تعمل على أجهزة تلفزيون بدقة 720 بكسل أو ما شابه ذلك
ذات كثافة معتدلة، يقدم Android 3.2 كثافة معممة جديدة،
tvdpi
، مع نقطة لكل بوصة تقريبية تبلغ 213. يمكن للتطبيقات إجراء طلب بحث عن
بالكثافة الجديدة في densityDpi
ويمكنها استخدام
مؤهل tvdpi
الجديد لوضع علامة على الموارد الخاصة بأجهزة التلفزيون
أجهزة مشابهة. مثلاً:
res/drawable-tvdpi/my_icon.png # Bitmap for tv density
بوجه عام، لا يجب أن تعمل التطبيقات بكثافة بكسل هذه. في الحالات التي تحتاج فيها إلى إخراج شاشة بدقة 720p، يمكن للمنصة تكبير عناصر واجهة المستخدم تلقائيًا.
إطار عمل واجهة المستخدم
- أجزاء
- تحمل فئة
Fragment.SavedState
الجديدة الولاية المعلومات التي تم استردادها من مثيل مجزأ من خلالsaveFragmentInstanceState()
- الطريقة الجديدة
saveFragmentInstanceState()
تحفظ حالة المثيل الحالية الجزء المعين. يمكن استخدام الحالة لاحقًا عند إنشاء مثيل جديد على الجزء الذي يتطابق مع الحالة الحالية. - الطريقة الجديدة
setInitialSavedState()
لتعيين حالة الحفظ الأولية لجزء عند إنشائها لأول مرة. - تُعلم طريقة الاستدعاء الجديدة لـ
onViewCreated()
المقتطف بأنّهonCreateView()
قد عاد، ولكن قبل استعادة أي حالة محفوظة في العرض. - تحدِّد طريقة
isDetached()
ما إذا كان قد تم فصل المقتطف صراحةً عن واجهة المستخدم. attach()
جديد وdetach()
تتيح للتطبيق إعادة إرفاق الأجزاء أو فصلها في واجهة المستخدم.- تتيح لك طريقة جديدة من طرق التحميل الزائدة في "
setCustomAnimations()
" ضبط صورة متحركة محدّدة الموارد لتشغيل عمليات الدخول والخروج، وعلى وجه التحديد عندما وكسر المكدس الخلفي. ولا تراعي عملية التنفيذ الحالية لمعرفة السلوك المختلف للأجزاء عند تمييز المكدس الخلفي.
- تحمل فئة
- معلومات حجم الشاشة في ActivityInfo وApplicationInfo
- يضيف
ActivityInfo
CONFIG_SCREEN_SIZE
وCONFIG_SMALLEST_SCREEN_SIZE
كقناع بت فيconfigChanges
. تشير وحدات البت إلى ما إذا كان بإمكان النشاط نفسه يتعامل مع حجم الشاشة وأصغر حجم للشاشة. - إضافة
ApplicationInfo
largestWidthLimitDp
،compatibleWidthLimitDp
، وrequiresSmallestWidthDp
حقلاً، مستمدة من سمات<supports-screens>
المقابلة في ملف بيان التطبيق.
- يضيف
- أدوات مساعدة للحصول على حجم الشاشة من WindowManager
- تسمح الطريقتان الجديدتان
getSize()
وgetRectSize()
للتطبيقات بالحصول على الحجم الأوّلي للشاشة.
- تسمح الطريقتان الجديدتان
- أنماط "holographic" علنية جديدة
- تعرض المنصة الآن مجموعة متنوعة من الأنماط "المجسمة" العلنية
للنص وأداوت التطبيقات المصغّرة في شريط الإجراءات وعلامات التبويب وغير ذلك. عرض
يمكنك
R.style
للاطّلاع على القائمة الكاملة.
- تعرض المنصة الآن مجموعة متنوعة من الأنماط "المجسمة" العلنية
للنص وأداوت التطبيقات المصغّرة في شريط الإجراءات وعلامات التبويب وغير ذلك. عرض
يمكنك
LocalActivityManager
وActivityGroup
و تم إيقافLocalActivityManager
نهائيًا الآن.- يجب أن تستخدم التطبيقات الجديدة "أجزاء" بدلاً من هذه الفئات. لمواصلة التشغيل على الإصدارات القديمة من النظام الأساسي، يمكنك استخدام مكتبة دعم الإصدار 4 (مكتبة التوافق) المتوفّرة في حزمة تطوير البرامج (SDK) لنظام التشغيل Android. توفّر مكتبة الإصدار 4 إصدارًا من Fragment API متوافقًا مع الإصدار 1.6 من نظام التشغيل Android (المستوى 4 لواجهة برمجة التطبيقات).
- للتطبيقات التي يتم تطويرها مقابل الإصدار Android 3.0 (مستوى واجهة برمجة التطبيقات)
11) أو أعلى، يتم عادةً عرض علامات التبويب في واجهة المستخدم باستخدام واجهة
ActionBar.newTab()
وواجهات برمجة التطبيقات ذات الصلة لوضع علامات التبويب داخل منطقة شريط الإجراءات الخاص بها.
إطار عمل الوسائط
- يمكن الآن للتطبيقات التي تستخدم مزوّد وسائط النظام الأساسي (
MediaStore
) قراءة بيانات الوسائط مباشرةً من بطاقة SD قابلة للإزالة، في حال كان الجهاز متوافقًا معها يمكن للتطبيقات أيضًا التفاعل مع ملفات بطاقة SD مباشرةً باستخدام واجهة برمجة التطبيقات MTP API.
الرسومات
- أدوات قابلة للتقسيم في Point وPointF
- تتضمّن فئتَا
Point
وPointF
الآن واجهةParcelable
وطرق المرافقdescribeContents()
وreadFromParcel()
وwriteToParcel()
.
- تتضمّن فئتَا
إطار عمل IME
- طريقة
getModifiers()
جديدة ل retrieving the current state of the modifier keys
إطار عمل USB
- طريقة
getRawDescriptors()
جديدة ل retrieving the raw USB descriptors for the device يمكنك استخدام صفحة إلى وسائل الوصف غير المتاحة مباشرة عبر من واجهات برمجة التطبيقات.
الشبكة
- ثوابت نوع الشبكة
- تضيف
ConnectivityManager
الثابتَينTYPE_ETHERNET
وTYPE_BLUETOOTH
.
- تضيف
الاتصالات الهاتفية
- ثابت جديد لنوع الشبكة
NETWORK_TYPE_HSPAP
المرافق الأساسية
- الخدمات التي يمكن تقسيمها إلى وحدات
- ما تسمح به الواجهة الجديدة
Parcelable.ClassLoaderCreator
التطبيق لتلقّي دالة ClassLoader التي يتم إنشاء الكائن فيها. adoptFd
وdup()
وfromFd()
جديدة لإدارة المواردParcelFileDescriptor
عناصر
- ما تسمح به الواجهة الجديدة
- Binder وIBinder
- الطريقة الجديدة
dumpAsync()
فيBinder
وIBinder
السماح للتطبيقات تفريغ في ملف محدد، مع التأكد من تنفيذ الهدف بشكل غير متزامن. - إنّ رمز معاملة بروتوكول
IBinder
الجديدTWEET_TRANSACTION
يتيح للتطبيقات إرسال تغريدات. إلى الكائن المستهدف.
- الطريقة الجديدة
ثوابت الميزات الجديدة
يضيف النظام الأساسي ثوابتًا جديدة لميزات الأجهزة يمكنك الإفصاح عنها.
في بيانات التطبيقات، لإبلاغ الجهات الخارجية، مثل Google
تشغيل إمكانيات الأجهزة والبرامج المطلوبة. يمكنك تحديد هذه العناصر
والثوابت الأخرى للميزات في عناصر البيان <uses-feature>
.
يفلتر Google Play التطبيقات استنادًا إلى سمات <uses-feature>
، لضمان توفّرها فقط على الأجهزة التي يتم استيفاء متطلباتها عليها.
- الثوابت في الميزة للمتطلبات الأفقية أو الرأسية
يقدّم Android 3.2 ثوابتًا جديدة في الميزات تسمح للتطبيقات بتحديد ما إذا كانت تتطلب العرض في الاتجاه الأفقي أو الاتجاه العمودي أو كليهما. يشير تعريف هذه الثوابت إلى أنه يجب عدم تثبيت التطبيق على جهاز لا يوفر الاتجاه المرتبط. في المقابل، إذا لم يتم الإعلان عن أحد الثابتَين أو كليهما، يعني ذلك أنّ التطبيق لا يفضّل الاتجاهات غير المعلَن عنها وقد يتم تثبيته على جهاز لا يقدّمها.
android.hardware.screen.landscape
— يتطلب التطبيق العرض بتنسيق الاتجاه الأفقي.android.hardware.screen.portrait
- يتطلب التطبيق عرض المحتوى في الوضع عمودي.
لن يحتاج التطبيق النموذجي الذي يعمل بشكل صحيح في كل من الاتجاهين الأفقي والعمودي إلى الإعلان عن متطلبات الاتجاه عادةً. وبدلاً من ذلك، يمكن لتطبيق مصمَّم بشكل أساسي باتجاه واحد، مثل تطبيق مصمَّم لجهاز تلفزيون، الإفصاح عن أحد الثوابت لضمان عدم توفّره للأجهزة التي لا توفّر هذا الاتجاه.
إذا كان أيّ من الأنشطة المُعلَن عنها في البيان يتطلّب تشغيلها في اتجاه معيّن، باستخدام السمة
android:screenOrientation
، يعني ذلك أيضًا أنّ التطبيق يتطلّب هذا الاتجاه. - ثوابت العناصر الأخرى
-
android.hardware.faketouch.multitouch.distinct
- يتطلب التطبيق إتاحة ميزة الإدخال باللمس المتعدّد المحاكي مع تتبُّع دقيق لنقطة أو أكثر. android.hardware.faketouch.multitouch.jazzhand
- يتطلب التطبيق إتاحة ميزة الإدخال باللمس المتعدّد المحاكي مع تتبُّع دقيق لخمس نقاط أو أكثر.
-
تقرير الاختلافات في واجهة برمجة التطبيقات
للحصول على عرض تفصيلي لجميع التغييرات في واجهة برمجة التطبيقات في Android 3.2 (مستوى واجهة برمجة التطبيقات 13)، يُرجى الاطّلاع على تقرير اختلافات واجهة برمجة التطبيقات.
مستوى واجهة برمجة التطبيقات
يوفر نظام Android 3.2 الأساسي إصدارًا محدثًا من واجهة برمجة تطبيقات إطار العمل. تم منح واجهة برمجة التطبيقات لنظام التشغيل Android 3.2 معرّفًا عدديًا هو 13 ويتم تخزينه في النظام نفسه. يُعرف هذا المعرّف باسم "مستوى واجهة برمجة التطبيقات"، ويسمح للنظام بتحديد ما إذا كان التطبيق متوافقًا مع النظام بشكلٍ صحيح قبل تثبيته.
لاستخدام واجهات برمجة التطبيقات المقدّمة في الإصدار 3.2 من Android في تطبيقك،
ستحتاج إلى تجميع التطبيق مقابل مكتبة Android المتوفرة
لمنصة Android 3.2 SDK. بناءً على احتياجاتك، يمكنك
قد
يجب أيضًا إضافة android:minSdkVersion="13"
إلى العنصر <uses-sdk>
في العنصر
البيان.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة ما هي واجهة برمجة التطبيقات؟ ما هو المستوى؟