<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، يتم تعريف قيمتها مساوٍ للعدد الصحيح لمستوى واجهة برمجة التطبيقات في النظام أو أكبر منه. إذا لم يتم الإعلان عنه، يفترض النظام أن التطبيق ليس له حد أقصى لمستوى واجهة برمجة التطبيقات. اطّلِع على description of هذه السمة للمزيد من المعلومات حول وكيف يعالجها النظام.

عند تعريفها في بيان التطبيق، ستلاحظ أنّ السمة <uses-sdk> العنصر كما يلي:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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