<uses-sdk>

يستخدم Google Play سمات <uses-sdk> المُعلَنة في بيان التطبيق لفلترة تطبيقك من الأجهزة التي لا تستوفي متطلبات إصدار النظام الأساسي. قبل ضبط هذه السمات، تأكَّد من فهم فلاتر Google Play.

بناء الجملة:

<uses-sdk android:minSdkVersion="integer"
          android:targetSdkVersion="integer"
          android:maxSdkVersion="integer" />

المضمَّنة في:

<manifest>

description:

تتيح لك التعبير عن توافق التطبيق مع إصدار أو أكثر من نظام Android الأساسي، وذلك عن طريق عدد صحيح لمستوى واجهة برمجة التطبيقات. تتم مقارنة مستوى واجهة برمجة التطبيقات الذي تم التعبير عنه من خلال التطبيق بمستوى واجهة برمجة التطبيقات في نظام Android معين، والذي يمكن أن يختلف بين أجهزة Android المختلفة.

على الرغم من اسمه، يُستخدم هذا العنصر لتحديد مستوى واجهة برمجة التطبيقات، وليس رقم إصدار حزمة تطوير البرامج (SDK) أو نظام Android الأساسي. ويكون مستوى واجهة برمجة التطبيقات دائمًا عددًا صحيحًا واحدًا. لا يمكنك الحصول على مستوى واجهة برمجة التطبيقات من رقم إصدار Android المرتبط بها. على سبيل المثال، ليس هو نفسه الإصدار الرئيسي أو مجموع الإصدارات الرئيسية والثانوية.

يُرجى أيضًا قراءة المستند حول إصدار إصدارات تطبيقاتك.

السمات:

android:minSdkVersion

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

تنبيه: إذا لم تحدّد هذه السمة، سيفترض النظام القيمة التلقائية "1"، ما يشير إلى أنّ تطبيقك متوافق مع جميع إصدارات Android. إذا لم يكن ليس، ولم تعلن عن minSdkVersion المناسب، يتعطل التطبيق أثناء وقت التشغيل عند محاولة الوصول إلى واجهات برمجة التطبيقات غير المتاحة عند تثبيته على نظام بمستوى واجهة برمجة تطبيقات غير متوافق. لهذا السبب، يجب تحديد مستوى واجهة برمجة التطبيقات المناسب في السمة minSdkVersion.

android:targetSdkVersion

عدد صحيح يحدّد مستوى واجهة برمجة التطبيقات الذي يستهدفه التطبيق. إذا تم ترك السياسة بدون ضبط، تكون القيمة التلقائية تساوي ما تم تقديمه إلى minSdkVersion.

تُعلم هذه السمة النظام بأنك اختبرت الإصدار المستهدف، ولا يتيح النظام أي سلوكيات متعلقة بالتوافق للحفاظ على توافق تطبيقك مع الإصدار المستهدف مع الإصدار المستهدف. لا يزال يمكن تشغيل التطبيق على الإصدارات الأقدم (حتى minSdkVersion).

مع تطوُّر Android بظهور كل إصدار جديد، قد تتغير بعض السلوكيات وكذلك بعض المظاهر. وإذا كان مستوى واجهة برمجة التطبيقات في النظام الأساسي أعلى من الإصدار المُعلَن في targetSdkVersion لتطبيقك، يمكن للنظام تفعيل سلوكيات التوافق حتى يستمر تطبيقك في العمل بالطريقة التي تتوقعها. يمكنك إيقاف سلوكيات التوافق هذه من خلال تحديد targetSdkVersion لمطابقة مستوى واجهة برمجة التطبيقات في النظام الأساسي الذي يتم تشغيله عليه.

على سبيل المثال، يؤدي ضبط هذه القيمة على "11" أو أعلى إلى السماح للنظام بتطبيق مظهر Holo التلقائي على تطبيقك عند تشغيله على الإصدار Android 3.0 أو الإصدارات الأحدث، وكذلك إيقاف وضع توافق الشاشة عند تشغيله على الشاشات الأكبر حجمًا، لأنّ التوافق مع المستوى 11 لواجهة برمجة التطبيقات يتوافق ضمنيًا مع الشاشات الأكبر حجمًا.

يمكن للنظام تفعيل العديد من سلوكيات التوافق استنادًا إلى القيمة التي حدّدتها لهذه السمة. تتضمّن إصدارات النظام الأساسي المقابلة العديد من هذه السلوكيات في مرجع Build.VERSION_CODES.

للحفاظ على تطبيقك مع كل إصدار من Android، يجب زيادة قيمة هذه السمة لتتطابق مع أحدث مستوى لواجهة برمجة التطبيقات، ثم اختبار تطبيقك بدقة على إصدار النظام الأساسي المقابل.

تم إدخال المنتج في المستوى 4 من واجهة برمجة التطبيقات

android:maxSdkVersion

عدد صحيح يشير إلى الحد الأقصى لمستوى واجهة برمجة التطبيقات الذي تم تصميم التطبيق لتشغيله.

في أنظمة التشغيل Android 1.5 و1.6 و2.0 و2.0.1، يتحقّق النظام من قيمة هذه السمة عند تثبيت تطبيق وعند إعادة التحقّق من التطبيق بعد إجراء تحديث للنظام. وفي كلتا الحالتين، إذا كانت سمة maxSdkVersion للتطبيق أقل من مستوى واجهة برمجة التطبيقات الذي يستخدمه النظام نفسه، لن يسمح النظام بتثبيت التطبيق. وفي حالة إعادة التحقق بعد تحديث النظام، يؤدي هذا الإجراء إلى إزالة التطبيق من الجهاز بفعالية.

لتوضيح كيفية تأثير هذه السمة على تطبيقك بعد إجراء تحديثات النظام، ننصحك بأخذ المثال التالي:

تم نشر تطبيق يوضح maxSdkVersion="5" في ملف البيان الخاص به على Google Play. يُجري المستخدم الذي يعمل على جهاز Android 1.6 (المستوى 4 من واجهة برمجة التطبيقات) تنزيلاً للتطبيق وتثبيته. وبعد بضعة أسابيع، يتلقّى المستخدم تحديثًا للنظام عبر شبكة غير سلكيّة إلى Android 2.0 (المستوى 5 من واجهة برمجة التطبيقات). بعد تثبيت التحديث، يفحص النظام maxSdkVersion للتطبيق ويعيد التحقق من صحته بنجاح.

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

تحذير: لا ننصح بتعريف هذه السمة. أولاً، لن تحتاج إلى ضبط السمة كوسيلة لحظر نشر تطبيقك على الإصدارات الجديدة من نظام Android الأساسي عند إصدارها. وحسب التصميم، تتوافق الإصدارات الجديدة من النظام الأساسي بشكل كامل مع الأنظمة القديمة. يعمل تطبيقك بشكل صحيح مع الإصدارات الجديدة، بشرط أن يستخدم واجهات برمجة التطبيقات العادية ويتّبع أفضل ممارسات التطوير. ثانيًا، في بعض الحالات، قد يؤدي الإعلان عن السمة إلى إزالة تطبيقك من أجهزة المستخدمين بعد إجراء تحديث للنظام إلى مستوى أعلى لواجهة برمجة التطبيقات. تتلقّى معظم الأجهزة التي يُحتمل أن يتم تثبيت تطبيقك عليها تحديثات النظام الدورية عبر الهواء، لذا عليك مراعاة تأثيرها في التطبيق قبل ضبط هذه السمة.

تم إدخال المنتج في المستوى 4 من واجهة برمجة التطبيقات

لا تتحقّق بعض إصدارات Android (بخلاف Android 2.0.1) من سمة maxSdkVersion أو تفرضها أثناء التثبيت أو إعادة التحقق. ومع ذلك، يواصل Google Play استخدام السمة كفلتر، مع ذلك عند تقديم التطبيقات المتاحة للتنزيل للمستخدمين.

تم تقديمه في:

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

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

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

يوفر نظام Android الأساسي واجهة برمجة تطبيقات لإطار العمل يمكن للتطبيقات استخدامها للتفاعل مع نظام Android الأساسي. تتألف واجهة برمجة التطبيقات لإطار العمل من:

• هي مجموعة أساسية من الحزم والفئات
• مجموعة من عناصر وسمات XML للإعلان عن ملف بيان
• مجموعة من عناصر وسمات XML للإعلان عن الموارد والوصول إليها
• مجموعة من الأهداف
• يشير ذلك المصطلح إلى مجموعة من الأذونات التي يمكن أن تطلبها التطبيقات، بالإضافة إلى إجراءات تنفيذ الأذونات التي يتم تضمينها في النظام.

ويمكن لكل إصدار متعاقب من نظام Android الأساسي أن يتضمن تحديثات على واجهة برمجة التطبيقات لإطار عمل تطبيقات Android التي توفِّرها.

يتم تصميم تحديثات واجهة برمجة التطبيقات لإطار العمل بحيث تظل واجهة برمجة التطبيقات الجديدة متوافقة مع الإصدارات السابقة من واجهة برمجة التطبيقات. وهذا يعني أن معظم التغييرات في واجهة برمجة التطبيقات إضافية وتقدم وظائف جديدة أو بديلة. ومع ترقية أجزاء من واجهة برمجة التطبيقات، يتم إيقاف الأجزاء القديمة البديلة نهائيًا ولكن لا تتم إزالتها، ما يتيح للتطبيقات الحالية مواصلة استخدامها.

في حالات نادرة جدًا، يتم تعديل أجزاء من واجهة برمجة التطبيقات أو إزالتها، علمًا أنّ هذه التغييرات لا تكون مطلوبة إلا لتعزيز قوة واجهة برمجة التطبيقات وأمان التطبيق أو النظام. يتم نقل جميع أجزاء واجهة برمجة التطبيقات الأخرى من المراجعات السابقة دون تعديل.

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

يحدد الجدول التالي مستوى واجهة برمجة التطبيقات الذي يتوافق مع كل إصدار من نظام Android الأساسي. للحصول على معلومات حول الأعداد النسبية للأجهزة التي تعمل بكل إصدار، راجع لوحة بيانات التوزيع.

استخدامات مستوى واجهة برمجة التطبيقات في Android

يؤدي معرّف مستوى واجهة برمجة التطبيقات دورًا رئيسيًا في المساعدة في ضمان تقديم أفضل تجربة ممكنة للمستخدمين ومطوّري التطبيقات:

• ويسمح لنظام Android الأساسي بوصف الحد الأقصى لمراجعة واجهة برمجة التطبيقات لإطار العمل التي تتوافق معها.
• ويتيح للتطبيقات وصف مراجعة واجهة برمجة التطبيقات لإطار العمل التي تتطلبها.
• وهو يتيح للنظام التفاوض بشأن تثبيت التطبيقات على جهاز المستخدم حتى لا يتم تثبيت التطبيقات غير المتوافقة مع الإصدار.

يخزِّن كل إصدار من إصدارات نظام Android الأساسي معرّف مستوى واجهة برمجة التطبيقات داخليًا، في نظام Android نفسه.

يمكن للتطبيقات استخدام عنصر البيان الذي تم توفيره من خلال واجهة برمجة التطبيقات لإطار العمل، <uses-sdk>، لوصف الحد الأدنى والحد الأقصى لمستويات واجهة برمجة التطبيقات التي يمكن من خلالها تشغيلها، بالإضافة إلى مستوى واجهة برمجة التطبيقات المفضل الذي تم تصميمها لدعمه. يقدم العنصر ثلاث سمات رئيسية:

• android:minSdkVersion: الحدّ الأدنى لمستوى واجهة برمجة التطبيقات الذي يمكن تشغيل التطبيق عليه. القيمة التلقائية هي "1".
• android:targetSdkVersion: مستوى واجهة برمجة التطبيقات الذي تم تصميم التطبيق عليه للعمل وفي بعض الحالات، يتيح هذا الإجراء للتطبيق استخدام عناصر البيان أو السلوكيات المحددة في مستوى واجهة برمجة التطبيقات المستهدَف، بدلاً من الاقتصار على استخدام العناصر المحدّدة فقط في الحد الأدنى لمستوى واجهة برمجة التطبيقات.
• android:maxSdkVersion: الحدّ الأقصى لمستوى واجهة برمجة التطبيقات الذي يمكن تشغيل التطبيق عليه. ملاحظة: اقرأ معلومات عن هذه السمة في هذه الصفحة قبل استخدامها.

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

عندما يحاول المستخدم تثبيت تطبيق أو عند إعادة التحقّق من صحة تطبيق بعد تحديث النظام، يتحقّق نظام Android أولاً من سمات <uses-sdk> في بيان التطبيق ويقارن القيم بالمستوى الداخلي لواجهة برمجة التطبيقات الخاصة به. ولا يسمح النظام ببدء عملية التثبيت إلا في حال استيفاء الشروط التالية:

• في حال الإعلان عن سمة android:minSdkVersion، تكون قيمتها أقل من أو تساوي العدد الصحيح لمستوى واجهة برمجة التطبيقات في النظام. إذا لم يتم الإعلان عنه، يفترض النظام أن التطبيق يتطلب المستوى 1 من واجهة برمجة التطبيقات.
• في حال الإعلان عن سمة android:maxSdkVersion، تكون قيمتها مساوية أو أكبر من العدد الصحيح لمستوى واجهة برمجة التطبيقات في النظام. إذا لم يتم الإعلان، يفترض النظام أن التطبيق ليس له حد أقصى لمستوى واجهة برمجة التطبيقات. يمكنك قراءة وصف هذه السمة للاطّلاع على مزيد من المعلومات حول طريقة معالجة النظام لها.

عند تعريف عنصر <uses-sdk> في بيان التطبيق، قد يظهر على النحو التالي:

<manifest>
  <uses-sdk android:minSdkVersion="5" />
  ...
</manifest>

إنّ السبب الرئيسي في تعريف أحد التطبيقات لمستوى واجهة برمجة التطبيقات في android:minSdkVersion هو إعلام نظام Android بأنّه يستخدم واجهات برمجة التطبيقات التي تم تقديمها في مستوى واجهة برمجة التطبيقات المحدّد.

إذا تم تثبيت التطبيق بطريقة ما على نظام أساسي بمستوى واجهة برمجة تطبيقات أقل، فسيتعطل في وقت التشغيل عندما يحاول الوصول إلى واجهات برمجة تطبيقات غير موجودة. يمنع النظام هذه النتيجة عن طريق عدم السماح للتطبيق بتثبيته إذا كان أدنى مستوى لواجهة برمجة التطبيقات يتطلبه أعلى من مستوى إصدار النظام الأساسي على الجهاز المستهدف.

اعتبارات التطوير

تقدم الأقسام التالية معلومات ذات صلة بمستوى واجهة برمجة التطبيقات الذي تحتاج إلى وضعه في الاعتبار عند تطوير تطبيقك.

توافق إعادة توجيه التطبيق

تتوافق تطبيقات Android بشكل عام مع إعادة التوجيه مع الإصدارات الجديدة من نظام Android الأساسي.

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

يُعد التوافق مع الأمام مهمًا لأن العديد من الأجهزة التي تعمل بنظام التشغيل Android تتلقى تحديثات النظام عبر شبكة غير سلكية (OTA). قد يقوم المستخدم بتثبيت تطبيقك واستخدامه بنجاح، ثم يتلقى لاحقًا تحديثًا عبر الهواء إلى إصدار جديد من نظام Android الأساسي. بعد تثبيت التحديث، يتم تشغيل تطبيقك بإصدار وقت تشغيل جديد من البيئة، ولكنه لا يزال يحتوي على إمكانيات النظام وواجهة برمجة التطبيقات التي يعتمد عليها تطبيقك.

يمكن أن تؤدي التغييرات أسفل واجهة برمجة التطبيقات، مثل تلك الموجودة في النظام الأساسي نفسه، إلى التأثير في تطبيقك عند تشغيله في البيئة الجديدة. ومن المهم بالنسبة إليك بصفتك مطور التطبيق أن تفهم شكل التطبيق وأدائه في كل بيئة نظام.

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

توافق التطبيق مع الأنظمة القديمة

لا تكون تطبيقات Android بالضرورة متوافقة مع الإصدارات القديمة من نظام Android الأساسي من الإصدار الذي تم تجميعها عليها.

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

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

اختيار إصدار النظام الأساسي ومستوى واجهة برمجة التطبيقات

عندما تقوم بتطوير التطبيق الخاص بك، يمكنك اختيار إصدار النظام الأساسي الذي تقوم بتجميع التطبيق وفقًا له. بشكل عام، قم بتجميع تطبيقك مقابل أقل إصدار ممكن من النظام الأساسي الذي يمكن أن يدعمه تطبيقك.

يمكنك تحديد أدنى إصدار ممكن للنظام الأساسي عن طريق تجميع التطبيق وفقًا لأهداف الإصدار الأدنى بشكل متعاقب. بعد تحديد الإصدار الأدنى، أنشئ متوسط مدة مشاهدة باستخدام إصدار النظام الأساسي المقابل ومستوى واجهة برمجة التطبيقات، واختبِر تطبيقك بشكل كامل. احرص على الإعلان عن سمة android:minSdkVersion في بيان التطبيق وضبط قيمتها على مستوى واجهة برمجة التطبيقات لإصدار النظام الأساسي.

تعريف الحدّ الأدنى لمستوى واجهة برمجة التطبيقات

إذا صمّمت تطبيقًا يستخدم واجهات برمجة التطبيقات أو ميزات النظام التي تم تقديمها في أحدث إصدار من النظام الأساسي، اضبط السمة android:minSdkVersion على مستوى واجهة برمجة التطبيقات الخاص بأحدث إصدار من النظام الأساسي. وذلك كي لا يتمكن المستخدمون من تثبيت تطبيقك إلا إذا كانت أجهزتهم تعمل بإصدار متوافق من نظام Android الأساسي. وهذا بدوره يساعد على ضمان عمل التطبيق بشكل صحيح على أجهزتهم.

إذا كان تطبيقك يستخدم واجهات برمجة التطبيقات المقدَّمة في أحدث إصدار من النظام الأساسي ولكنه لم يعرض السمة android:minSdkVersion، يعني ذلك أنّه يعمل بشكل صحيح على الأجهزة التي تعمل بأحدث إصدار من النظام الأساسي، وليس على الأجهزة التي تعمل بإصدارات سابقة من النظام الأساسي. في الحالة الثانية، يتعطل التطبيق في وقت التشغيل عندما يحاول استخدام واجهات برمجة تطبيقات غير متوفرة في الإصدارات السابقة.

الاختبار مقارنةً بمستويات أعلى لواجهة برمجة التطبيقات

بعد تجميع التطبيق، احرص على اختباره على النظام الأساسي المحدّد في سمة android:minSdkVersion للتطبيق. ولإجراء ذلك، أنشِئ "متوسّط مدة تشغيل" يستخدم إصدار النظام الأساسي الذي يطلبه التطبيق. بالإضافة إلى ذلك، للتحقق من التوافق مع المستقبل، شغِّل التطبيق واختبره على جميع الأنظمة الأساسية التي تستخدم مستوى واجهة برمجة تطبيقات أعلى من ذلك الذي يستخدمه تطبيقك.

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

للوصول إلى أداة التحديث، يمكنك استخدام أداة سطر الأوامر android الموجودة في دليل <sdk>/tools. يمكنك تشغيل أداة تحديث SDK من خلال تنفيذ android sdk. يمكنك أيضًا النقر مرّتين على ملف android.bat (نظام التشغيل Windows) أو android (نظام التشغيل OS X/Linux).

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

فلترة المستندات المرجعية حسب مستوى واجهة برمجة التطبيقات

توفّر صفحات المستندات المرجعية لنظام Android الأساسي عنصر تحكّم في "مستوى واجهة برمجة التطبيقات" في أعلى يمين كل صفحة. ويمكنك استخدام عنصر التحكّم لعرض المستندات فقط لأجزاء من واجهة برمجة التطبيقات التي يمكن لتطبيقك الوصول إليها، استنادًا إلى مستوى واجهة برمجة التطبيقات الذي تحدّده في السمة android:minSdkVersion ضمن ملف البيان الخاص به.

لاستخدام التصفية، حدد مستوى واجهة برمجة التطبيقات الذي يحدده تطبيقك من القائمة. بعد ذلك، تصبح واجهات برمجة التطبيقات التي تم تقديمها في مستوى لاحق لواجهة برمجة التطبيقات غير متاحة، ويتم إخفاء محتواها، نظرًا لعدم إمكانية وصول تطبيقك إليها.

لا توفر التصفية حسب مستوى واجهة برمجة التطبيقات في الوثائق طريقة عرض للجديد أو المقدم في كل مستوى من مستويات واجهة برمجة التطبيقات. وهو يوفر طريقة لعرض واجهة برمجة التطبيقات الكاملة المرتبطة بمستوى معيّن لواجهة برمجة التطبيقات، مع استبعاد عناصر واجهة برمجة التطبيقات التي تم تقديمها في مستويات واجهة برمجة التطبيقات اللاحقة.

للعودة إلى عرض المستندات الكاملة، اختَر REL في أعلى قائمة مستوى واجهة برمجة التطبيقات. يتم تلقائيًا إيقاف فلترة مستوى واجهة برمجة التطبيقات لتتمكّن من عرض واجهة برمجة التطبيقات لإطار العمل بالكامل، بغض النظر عن مستوى واجهة برمجة التطبيقات.

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