تحديث أدوات IDE وSDK

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

تعديل بيئة تطوير البرامج (IDE) باستخدام مجموعة أدوات JetBrains

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

مجموعة أدوات Jetbrains تعرض التحديثات المتاحة

الشكل 1. تعرض مجموعة أدوات Jetbrains التحديثات المتاحة.

تحديث بيئة تطوير البرامج (IDE) وتغيير القنوات

في حال تثبيت "استوديو Android" يدويًا، يرسل إليك "استوديو Android" إشعارًا من خلال مربّع حوار فقاعي صغير عند توفّر تحديث لـ IDE. للبحث عن التحديثات يدويًا، انقر على ملف >الإعدادات >المظهر والسلوك > إعدادات النظام > التحديثات (على نظام التشغيل macOS، استوديو Android > البحث عن تحديثات). انظر الرسم البياني 2.

تتوفر تحديثات "استوديو Android" في قنوات الإصدار التالية:

  • قناة إصدار Canary: يتم تحديث هذه الإصدارات المتطورة أسبوعيًا تقريبًا وهي متاحة للتنزيل على صفحة معاينة الإصدار.

    بالإضافة إلى تلقّي إصدارات Canary من "استوديو Android"، ستحصل أيضًا على إصدارات معاينة لأدوات SDK الأخرى، بما في ذلك Android Emulator.

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

    ملاحظة: لا يُنصح باستخدام هذه القناة لتطوير عملية الإنتاج.

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

إذا كنت تريد تجربة إحدى قنوات المعاينة (إصدار Canary أو الإصدار التجريبي) مع الاستمرار في استخدام الإصدار الثابت لمشاريع الإنتاج، يمكنك تثبيتها جنبًا إلى جنب.

الشكل 2. تفضيلات تحديثات استوديو Android.

حذف أدلة "استوديو Android" غير المستخدَمة

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

تحديث أدواتك باستخدام "مدير SDK"

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

لفتح "إدارة SDK" من "استوديو Android"، انقر على الأدوات > مدير SDK أو انقر على مدير SDK في شريط الأدوات. إذا لم تكن تستخدم "استوديو Android"، يمكنك تنزيل الأدوات باستخدام أداة سطر الأوامر sdkmanager .

عند توفُّر تحديث لحزمة حالية، تظهر شرطة في مربّع الاختيار بجانب الحزمة.

  • لتحديث عنصر أو تثبيت عنصر جديد، ضع علامة في مربّع الاختيار.
  • لإزالة حزمة، انقر لمحو مربّع الاختيار.

وتتم الإشارة إلى التحديثات المعلّقة في العمود الأيمن من خلال رمز التنزيل . يتم الإشارة إلى عمليات الإزالة المعلّقة بعلامة X حمراء: .

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

الشكل 3. مدير SDK لنظام التشغيل Android.

الحزم المطلوبة

يمكنك العثور على الأدوات التالية في علامة التبويب أدوات SDK:

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

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

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

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

يوصى باستخدام الأدوات التالية للتطوير:

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

ملاحظة: إنّ معظم مكتبات واجهات برمجة التطبيقات التي تم توفيرها سابقًا من خلال حِزم مستودع الدعم (مثل مكتبة دعم Android وتنسيق القيد و"خدمات Google Play" وFirebase) أصبحت الآن متوفّرة في مستودع Maven من Google. تتضمّن المشاريع التي تم إنشاؤها باستخدام الإصدار 3.0 من "استوديو Android" والإصدارات الأحدث هذا المستودع تلقائيًا في إعدادات الإصدار. إذا كنت تستخدم مشروعًا قديمًا، عليك إضافة مستودع Maven من Google يدويًا إلى ملف build.gradle أو build.gradle.kts.

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

القائمة السابقة ليست شاملة، ويمكنك إضافة مواقع إلكترونية أخرى لتنزيل حِزم إضافية من جهات خارجية، كما هو موضَّح في القسم التالي.

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

تعديل المواقع الإلكترونية لأدوات حزمة تطوير البرامج (SDK) أو إضافتها

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

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

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

  1. انقر على علامة التبويب مواقع تحديث SDK.
  2. انقر على إضافة في أعلى النافذة.
  3. أدخِل الاسم وعنوان URL للموقع الإلكتروني التابع للجهة الخارجية، ثم انقر على حسنًا.
  4. تأكّد من تحديد مربّع الاختيار في العمود Enabled.
  5. انقر على تطبيق أو حسنًا.

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

تنزيل الحزم المفقودة تلقائيًا باستخدام Gradle

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

عند قبول اتفاقيات الترخيص باستخدام مدير SDK، ينشئ "استوديو Android" دليل تراخيص داخل الدليل الرئيسي لحزمة SDK. دليل التراخيص هذا ضروري حتى تتمكن Gradle عن تنزيل الحزم المفقودة تلقائيًا.

إذا قبلت اتفاقيات الترخيص على محطة عمل واحدة ولكنك تريد إنشاء مشاريعك على محطة أخرى، يمكنك تصدير التراخيص من خلال نسخ دليل التراخيص المقبول.

لنسخ التراخيص إلى جهاز آخر، يُرجى اتّباع الخطوات التالية:

  1. على جهاز مثبَّت عليه "استوديو Android"، انقر على الأدوات > مدير SDK. في أعلى النافذة، اطّلِع على الموقع الجغرافي لحزمة تطوير البرامج (SDK) لنظام التشغيل Android.
  2. انتقِل إلى ذلك الدليل وحدِّد موقع دليل licenses/ داخله.

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

  3. انسخ دليل licenses/ بأكمله والصقه في الدليل الرئيسي لحزمة تطوير البرامج (SDK) لنظام التشغيل Android على الجهاز الذي تريد إنشاء مشاريعك عليه.

يمكن لأداة Gradle الآن تنزيل الحزم المفقودة التي يعتمد عليها مشروعك تلقائيًا.

يُرجى العِلم أنّه يتم إيقاف هذه الميزة تلقائيًا في الإصدارات التي يتم تشغيلها من "استوديو Android"، لأنّ مدير SDK يعالج عملية تنزيل الحزم المفقودة لحزمة تطوير البرامج (IDE). لإيقاف هذه الميزة يدويًا، يمكنك ضبط android.builder.sdkDownload=false في ملف gradle.properties لمشروعك.

تحديث أدواتك باستخدام سطر الأوامر

في الأنظمة التي لا تحتوي على واجهة مستخدم تصويرية، مثل خوادم CI، لا يمكنك استخدام SDK Manager في "استوديو Android". بدلاً من ذلك، استخدِم أداة سطر الأوامر sdkmanager من أجل تثبيت وتحديث أدوات حزمة تطوير البرامج (SDK) والأنظمة الأساسية.

بعد تثبيت أدوات حزمة تطوير البرامج (SDK) والأنظمة الأساسية التي تستخدم sdkmanager، قد تحتاج إلى قبول أي تراخيص مفقودة. يمكن إجراء ذلك أيضًا باستخدام sdkmanager:

$ sdkmanager --licenses

يفحص هذا الأمر كل الأنظمة الأساسية وأدوات حزمة تطوير البرامج (SDK) المثبَّتة ويعرض أي تراخيص لم يتم قبولها. وسيُطلب منك قبول كل ترخيص.