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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

تحديث حزمة تطوير البرامج المتكاملة باستخدام JetBrains Toolbox

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

الشكل 1: أداة Jetbrains Toolbox تعرض التحديثات المتاحة

تعديل بيئة تطوير البرامج وتغيير القنوات

إذا ثبّتْت Android Studio يدويًا، سيرسل لك البرنامج إشعارًا من خلال فقاعة حوار صغيرة عند توفّر تحديث لبيئة تطوير البرامج. للتحقّق يدويًا من توفّر تحديثات، انقر على ملف >الإعدادات > المظهر والسلوك > إعدادات النظام > التحديثات (على نظام التشغيل macOS، Android Studio > البحث عن التحديثات). راجِع الشكل 2.

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

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

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

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

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

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

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

الشكل 2: إعدادات ملف التفضيلات "تحديثات استوديو Android"

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

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

تحديث أدواتك باستخدام "مدير حِزم تطوير البرامج (SDK)"

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

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

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

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

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

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

الشكل 3: أداة "إدارة حزمة تطوير البرامج (SDK) لنظام التشغيل Android"

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

يمكنك العثور على الأدوات التالية في علامة التبويب أدوات حزمة تطوير البرامج (SDK):

أدوات إنشاء حزمة تطوير البرامج (SDK) لنظام التشغيل Android

تتضمّن أدوات لإنشاء تطبيقات Android. لمزيد من المعلومات، يُرجى الاطّلاع على ملاحظات إصدار "أدوات إنشاء حِزم تطوير البرامج (SDK)".

أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android

تتضمّن أدوات مختلفة تتطلّبها منصّة Android، بما في ذلك أداة adb.

أدوات سطر أوامر حزمة تطوير البرامج (SDK) لنظام التشغيل Android

تتضمّن أدوات أساسية، مثل ProGuard. لمزيد من المعلومات، يُرجى الاطّلاع على ملاحظات إصدار أدوات حزمة تطوير البرامج (SDK).

منصّة حزمة تطوير البرامج (SDK) لنظام التشغيل Android

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

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

برنامج تشغيل USB من Google

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

الحِزم المقترَحة

يُنصح باستخدام الأدوات التالية لتطوير التطبيقات:

محاكي Android

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

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

Intel أو صور أنظمة ARM

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

خدمات Google Play

تتضمّن مجموعة من المكتبات وJavadocs والعيّنات للمساعدة في إنشاء تطبيقك. إذا كنت تريد استخدام واجهات برمجة التطبيقات من خدمات Google Play، عليك استخدام صورة نظام Google APIs أو صورة نظام Google Play.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2. انتقِل إلى هذا الدليل وحدِّد موقع الدليل licenses/ داخله.

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

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

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

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

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

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

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

$ sdkmanager --licenses

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