<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 المرتبط به. على سبيل المثال، لا يتطابق مع رقم الإصدار الرئيسي أو مجموع رقمي الإصدار الرئيسي والثانوي.

لا يمكن تحديد ما إذا كان التطبيق يستهدف إصدارًا ثانويًا من حزمة تطوير البرامج (SDK) أو يتطلّبه.

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

السمات:

android:minSdkVersion

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

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

android:targetSdkVersion

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

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

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

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

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

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

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

android:maxSdkVersion

‫

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

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

لتوضيح كيف يمكن أن تؤثّر هذه السمة في تطبيقك بعد تحديثات النظام، إليك المثال التالي:

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

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

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

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

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

تم إدخال القدرة لأول مرة في:

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

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

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

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

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

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

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

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

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

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

إصدار النظام الأساسي	مستوى واجهة برمجة التطبيقات	VERSION_CODE	ملاحظات
Android 17	37	CINNAMON_BUN	أهم ميزات المنصة
Android 16	36	BAKLAVA	أهم ميزات المنصة
‫Android 15	35	VANILLA_ICE_CREAM	أهم ميزات المنصة
Android 14	34	UPSIDE_DOWN_CAKE	أهم ميزات المنصة
Android 13	33	TIRAMISU	أهم ميزات المنصة
Android 12	32	S_V2	أهم ميزات المنصة
	31	S	أهم ميزات المنصة
Android 11	30	R	أهم ميزات المنصة
Android 10	29	Q	أهم ميزات المنصة
Android 9	28	P	أهم ميزات المنصة
‫Android 8.1	27	O_MR1	أهم ميزات المنصة
‫Android 8.0	26	O	أهم ميزات المنصة
‫Android 7.1.1 ‫Android 7.1	25	N_MR1	أهم ميزات المنصة
‫Android 7.0	24	N	أهم ميزات المنصة
‫Android 6.0	23	M	أهم ميزات المنصة
‫Android 5.1	22	LOLLIPOP_MR1	أهمّ ميزات المنصة
Android 5.0	21	LOLLIPOP
Android 4.4W	20	KITKAT_WATCH	KitKat للأجهزة القابلة للارتداء فقط
‫Android 4.4	19	KITKAT	أهمّ ميزات المنصة
‫Android 4.3	18	JELLY_BEAN_MR2	أهمّ ميزات المنصة
‫Android 4.2 و4.2.2	17	JELLY_BEAN_MR1	أهمّ ميزات المنصة
‫Android 4.1 و4.1.1	16	JELLY_BEAN	أهمّ ميزات المنصة
‫Android 4.0.3 و4.0.4	15	ICE_CREAM_SANDWICH_MR1	أهمّ ميزات المنصة
‫Android 4.0 و4.0.1 و4.0.2	14	ICE_CREAM_SANDWICH
‫Android 3.2	13	HONEYCOMB_MR2
‫Android 3.1.x	12	HONEYCOMB_MR1	أهم ميزات المنصة
‫Android 3.0.x	11	HONEYCOMB	أهم ميزات المنصة
‫Android 2.3.4 Android 2.3.3	10	GINGERBREAD_MR1	أهمّ ميزات المنصة
‫Android 2.3.2 ‫Android 2.3.1 ‫Android 2.3	9	GINGERBREAD
‫Android 2.2.x	8	FROYO	أهم ميزات المنصة
‫Android 2.1.x	7	ECLAIR_MR1	أهمّ ميزات المنصة
‫Android 2.0.1	6	ECLAIR_0_1
‫Android 2.0	5	ECLAIR
‫Android 1.6	4	DONUT	أهم ميزات المنصة
‫Android 1.5	3	CUPCAKE	أهم ميزات المنصة
‫Android 1.1	2	BASE_1_1
‫Android 1.0	1	BASE

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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