استخدام "مساعد ترقية حزمة تطوير البرامج (SDK) لنظام التشغيل Android"
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
"مساعد ترقية حزمة تطوير البرامج (SDK) لنظام التشغيل Android" هو أداة في "استوديو Android" تساعدك في
ترقية
targetSdkVersion، أو
مستوى واجهة برمجة التطبيقات الذي يستهدفه تطبيقك. من المهم تحديث
targetSdkVersion باستمرار لتتمكّن من استخدام أحدث ميزات المنصة. تتوفر أداة "مساعد ترقية حزمة تطوير البرامج (SDK) لنظام التشغيل Android" في إصدار Giraffe من "استوديو Android" والإصدارات الأحدث.
يساعدك مساعد ترقية حزمة تطوير البرامج (SDK) لنظام التشغيل Android في توفير الوقت والجهد عند تحديث targetSdkVersion:
في كل خطوة من خطوات نقل البيانات، يتم تسليط الضوء على التغييرات الرئيسية التي قد تؤدي إلى أعطال وكيفية معالجتها.
ويحاول التطبيق فلترة القائمة الكاملة للتغييرات لعرض الخطوات ذات الصلة
بتطبيقك فقط. ورغم ذلك، سيعرض خطوة إذا لم تكن متأكدًا، مع ذلك قد يظلّ بإمكانك رؤية الخطوات التي يمكنك تخطّيها.
وبالنسبة إلى بعض التغييرات، فإنّه يحدِّد بالضبط المكان الذي يجب إجراء التغييرات فيه في الرمز.
لفتح "مساعد ترقية حزمة تطوير البرامج (SDK) لنظام التشغيل Android"، انتقِل إلى
الأدوات > مساعد ترقية حزمة تطوير البرامج (SDK) لنظام التشغيل Android. في لوحة المساعد، اختَر مستوى واجهة برمجة التطبيقات الذي تريد الترقية إليه للحصول على إرشادات. للحصول على أفضل تجربة،
يجب ترقية قيم targetSdkVersion لمستوى واحد في كل مرة.
الإبلاغ عن الأخطاء
لمساعدتنا في تقديم أفضل تجربة لك، يُرجى إرسال الملاحظات والأخطاء باستخدام أداة تتبّع المشاكل.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Use the Android SDK Upgrade Assistant\n\nThe Android SDK Upgrade Assistant is a tool in Android Studio that helps you\nupgrade the\n[`targetSdkVersion`](/guide/topics/manifest/uses-sdk-element#target), or\nthe API level that your app targets. It's important to keep your\n`targetSdkVersion` up to date so you can use the platform's latest features. The\nAndroid SDK Upgrade Assistant is available in Android Studio Giraffe and higher.\n| **Important:** Starting August 31, 2023, all apps must target Android 13 (API level 33) or higher to be submitted to Google Play for review and remain discoverable for all Google Play users. Configuring your app to target a recent API level ensures that users benefit from security and performance improvements while your app can still run on lower Android versions (down to the specified `minSdkVersion`). To learn more, see the [Google Play target API level requirement](/google/play/requirements/target-sdk).\n\nThe Android SDK Upgrade Assistant helps you save time and effort when updating\nthe `targetSdkVersion`:\n\n- For each migration step, it highlights the major breaking changes and how to address them.\n- It tries to filter the full list of changes to only show steps relevant\n to your app. It'll show a step if it's not certain though, so you might still\n see steps that you can skip.\n\n | **Note:** If you need to reset the step filters, close and reopen your project or restart the Studio IDE. The SDK Upgrade Assistant filters the migration steps once at the beginning of each project session, so you might want to reset the step filters if you've checked out another version of your project for which previously hidden steps apply.\n- For some changes, it pinpoints where exactly in your code the changes need to be made.\n\nTo open the Android SDK Upgrade Assistant, go to\n**Tools \\\u003e Android SDK Upgrade Assistant** . In the **Assistant** panel, select\nthe API level that you want to upgrade to for guidance. For the best experience,\nyou should upgrade `targetSdkVersion` values one level at a time.\n\nReport bugs\n-----------\n\nTo help us create the best experience for you, please submit feedback and bugs\nusing the\n[issue tracker](https://issuetracker.google.com/issues/new?component=1267157&template=1750462)."]]
