الميزات الجديدة في معاينة "استوديو Android"

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

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

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

الإصدارات الحالية من "استوديو Android"

يسرد الجدول التالي الإصدارات الحالية من Android Studio وقنواتها.

الإصدار القناة
تحديث Narwhal من "استوديو Android" | الإصدار ‎2025.1.2 ثابت
الإصدار 8.12.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android ثابت
تحديث الإصدار 3 من Android Studio Narwhal‏ | 2025.1.3 RC
تحديث الإصدار 4 من Android Studio Narwhal‏ | 2025.1.4 الكاناري

التوافق مع معاينات المكوّن الإضافي لنظام Gradle المتوافق مع Android

يتم نشر كل إصدار تجريبي من "استوديو Android" مع إصدار مطابق من المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP). من المفترض أن تعمل إصدارات معاينة "استوديو Android" مع أي إصدار ثابت متوافق من "مكوّن Android الإضافي لنظام Gradle". ومع ذلك، إذا كنت تستخدم إصدارًا تجريبيًا من AGP، عليك استخدام الإصدار التجريبي المتوافق من "استوديو Android" (على سبيل المثال، الإصدار التجريبي 7 من Android Studio Chipmunk مع الإصدار 7.2.0-alpha07 من AGP). ستؤدي محاولات استخدام إصدارات مختلفة (على سبيل المثال، الإصدار التجريبي الأول من Android Studio Chipmunk مع الإصدار 7.2.0-alpha07 من المكوّن الإضافي لنظام Android المتوافق مع Gradle) إلى تعذُّر المزامنة، ما يؤدي إلى ظهور طلب بتحديث المكوّن الإضافي إلى الإصدار المتوافق.

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

‫Studio Labs

يتيح لك برنامج Studio Labs تجربة أحدث الميزات التجريبية المستندة إلى الذكاء الاصطناعي في إصدار ثابت من "استوديو Android"، ما يتيح لك دمج عروض المساعدة المستندة إلى الذكاء الاصطناعي في سير عمل التطوير بشكل أسرع. لمزيد من المعلومات، يُرجى الاطّلاع على Studio Labs.

في ما يلي الميزات المتوفّرة حاليًا في Studio Labs.

الميزة الوصف مستندات Google
إنشاء معاينة يمكن لـ Gemini إنشاء معاينات Compose تلقائيًا، بما في ذلك بيانات وهمية لمعاينة المَعلمات، وذلك لمكوّن قابل للإنشاء معيّن أو جميع المكوّنات القابلة للإنشاء في ملف. إنشاء معاينات ميزة "كتابة أغنية"
إرفاق صور أرفِق صورة بطلب البحث للمساعدة في إنشاء واجهة المستخدم وتصحيح أخطاء واجهة المستخدم وتوثيق بنية التطبيق وغير ذلك. إرفاق صور
إرفاق ملفات أرفِق ملفات بطلبك لمساعدة Gemini في فهم سياق سؤالك بشكل أفضل وتحديد الرمز الذي يجب تعديله. إرفاق ملفات
Transform UI استخدِم اللغة الطبيعية لتعديل واجهة مستخدم تطبيقك مباشرةً من لوحة معاينة Compose. Transform UI

تحديث الإصدار 3 من Android Studio Narwhal‏ | 2025.1.3

في ما يلي الميزات الجديدة في التحديث الأخير لإصدار Narwhal 3 من "استوديو Android"‏ (2025.1.3).

للاطّلاع على المشاكل التي تم حلّها في هذا الإصدار من "استوديو Android"، راجِع المشاكل التي تم إغلاقها.

معاينات Compose قابلة لتغيير الحجم

تتيح ميزة "معاينة الإنشاء" الآن تغيير الحجم بشكل ديناميكي لمنحك ملاحظات مرئية فورية حول كيفية تكيّف واجهة المستخدم مع أحجام الشاشات المختلفة.

لاستخدام الميزة، فعِّل وضع التركيز في "معاينة الإنشاء" من خلال تغيير خيار العرض في شريط الأدوات:

وضع "التركيز" في "معاينة إنشاء"
وضع التركيز في "معاينة التدوين"

يمكنك الآن تغيير حجم نافذة المعاينة من خلال سحب حوافها:

تغيير حجم نافذة المعاينة من خلال سحب حوافها

أو يمكنك استخدام شريط أدوات تغيير الحجم الذي يظهر بعد تغيير حجم المعاينة:

تغيير حجم نافذة المعاينة باستخدام شريط أدوات تغيير الحجم

إذا أردت حفظ الحجم الجديد كتعليق توضيحي جديد Preview، استخدِم قائمة النقر بزر الماوس الأيمن:

Compose Resizeable Preview save new size
حفظ الحجم الجديد لمعاينة الرسالة القابلة لتغيير الحجم

تساعدك ميزة تغيير الحجم الديناميكي في إنشاء واجهات مستخدم تبدو رائعة على أي حجم شاشة.

إعداد "عرض Android" لعرض ملفات الإنشاء ضمن الوحدات ذات الصلة

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

طريقة عرض Android: إنشاء ملفات في الوحدة
خيار عرض ملفات الإنشاء ضمن الوحدات النمطية ذات الصلة في "طريقة عرض Android".

ميزة "إحصاءات سياسات Play" في "استوديو Android"

يتضمّن "استوديو Android" الآن إحصاءات وإرشادات أكثر تفصيلاً حول سياسات Google Play التي قد تؤثّر في تطبيقك. وتساعدك هذه المعلومات في إنشاء تطبيقات أكثر أمانًا منذ البداية، ما يمنع حدوث مشاكل قد تعيق عملية الإطلاق وتستغرق وقتًا وموارد أكثر لإصلاحها لاحقًا.

اعتبارًا من الإصدار 3 من حزمة الميزات Narwhal في "استوديو Android"، يمكنك الاطّلاع على "إحصاءات سياسات Google Play" كعمليات تحقّق مستندة إلى أداة Lint. ستعرض عمليات التحقّق من الأخطاء المحتملة المعلومات التالية:

  • نظرة عامة على السياسة
  • إجراءات يجب اتّخاذها وأخرى يجب تجنُّبها لتفادي المشاكل الشائعة.
  • روابط إلى صفحات سياسات Play التي يمكنك من خلالها العثور على السياسة الرسمية الكاملة والمزيد من المعلومات والمراجع المفيدة

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

للاطّلاع على ما إذا كانت هناك أي "إحصاءات حول سياسات Play" لمشروعك، انتقِل إلى الرمز > فحص "إحصاءات حول سياسات Play"… سيتم إدراج الإحصاءات في نافذة أداة "المشاكل"، كما ستظهر أيضًا كتحذيرات Lint في الملفات ذات الصلة.

ميزة "إحصاءات سياسات Play" في "استوديو Android"
ميزة "إحصاءات سياسات Play" في التحديث الثالث لإصدار Narwhal من "استوديو Android"

الاختبار والتطوير باستخدام ميزة "الاحتفاظ بنسخة احتياطية من التطبيقات واستعادتها"

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

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

إنشاء نسخة احتياطية

لإنشاء ملف نسخ احتياطي، اتّبِع الخطوات التالية:

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

يمكنك عرض النُسخ الاحتياطية التي تنشئها في نافذة أداة المشروع > Android ضمن عقدة ملفات النسخ الاحتياطي.

أنواع النسخ الاحتياطي

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

  • من جهاز إلى جهاز: يتم إنشاء نسخة احتياطية من تطبيقك، على غرار النسخة التي يتم إنشاؤها أثناء عملية نقل البيانات من جهاز إلى جهاز. في عمليات النقل بين الأجهزة، يتم إرسال بيانات النسخة الاحتياطية للتطبيق مباشرةً إلى جهاز آخر، مثلاً عبر USB أو Wi-Fi.
  • السحابة الإلكترونية: تنشئ نسخة احتياطية من تطبيقك، مشابهة للنسخة المحفوظة في مساحة تخزين حساب المستخدم على Google. عندما يضبط المستخدم جهازًا جديدًا، يمكنه اختيار الاستعادة من نسخة احتياطية محفوظة على السحابة الإلكترونية.
  • السحابة الإلكترونية (غير مشفّرة): يتم إنشاء نسخة احتياطية من تطبيقك، على غرار النسخة المحفوظة في مساحة تخزين حساب المستخدم على Google على جهاز غير مفعَّلة فيه ميزة التشفير من جهة العميل.

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

استعادة بيانات التطبيق

لاستعادة بيانات التطبيق، اتّبِع الخطوات التالية:

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

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

  1. انتقِل إلى تشغيل (Run) > تعديل الإعدادات (Edit Configurations) من شريط القائمة الرئيسي.
  2. اختَر إعداد تشغيل تطبيق وانتقِل إلى خيارات الاستعادة.
    خيارات الاستعادة في إعداد التشغيل:
  3. لاستعادة تطبيق من نسخة احتياطية، ضَع علامة في المربّع بجانب استعادة حالة التطبيق.
  4. اختَر ملف نسخة احتياطية من السجلّ الحديث أو تصفَّح مساحة التخزين المحلية واختَر ملف النسخة الاحتياطية.
  5. إذا أردت استعادة بيانات التطبيق عند تثبيته من جديد فقط، ضَع علامة في المربّع بجانب الاستعادة عند تثبيت حزمة APK من جديد فقط. يمكن أن يكون هذا الخيار مفيدًا إذا كنت تنشر التطبيق على جهاز اختبار جديد وأردت استعادة البيانات للمساعدة في تصحيح الأخطاء وتطوير التطبيق.
  6. انقر على حسنًا لحفظ إعداد التشغيل.
  7. يمكنك نشر تطبيقك باستخدام إعداد التشغيل لاختبار استعادة بيانات تطبيقك إلى جهاز متصل.

عمليات فحص Proguard

يتضمّن Android Studio الآن عمليات فحص لمنع قواعد Proguard المصمَّمة بشكل سيئ أو القواعد التي تمنع تحسينات R8. تؤدي قواعد الاحتفاظ الواسعة النطاق، مثل -keep class **.* وإعدادات قواعد Proguard الخاصة بالمستهلكين، مثل dontshrink و-dontoptimize، إلى ظهور تحذير الآن في بيئة التطوير المتكاملة في "استوديو Android". لإنشاء قاعدة إبقاء جيدة تتيح تصغير الرمز البرمجي، يجب حصر نطاق القاعدة في حزمة معيّنة وتوضيح ما تريد إبقاءه.

ملفات AGENT.md لتوفير السياق على مستوى المشروع

يمكنك الآن تضمين AGENT.md ملف في مشروعك. وهي ملفات Markdown تقدّم تعليمات خاصة بالمشروع وقواعد أسلوب الترميز وإرشادات أخرى إلى Gemini كسياق.

يكتشف Gemini تلقائيًا التعليمات من أي ملف باسم AGENT.md ويطبّقها في مشروعك. في حال عدم توفّر ملف AGENT.md، سيبحث Gemini بدلاً من ذلك عن ملف GEMINI.md كخيار احتياطي.

إعداد جديد لإيقاف المزامنة التلقائية

يتيح لك "استوديو Android" الآن خيار التبديل من وضع "المزامنة التلقائية" التلقائي (على سبيل المثال، يتم تشغيل المزامنة تلقائيًا عند فتح مشروع) إلى وضع "المزامنة اليدوية" الجديد مع التذكيرات. لا يزال السلوك التلقائي هو "المزامنة التلقائية". للتبديل إلى "المزامنة اليدوية"، انتقِل إلى ملف (File) (استوديو Android (Android Studio) على نظام التشغيل macOS) > الإعدادات (Settings) > الإنشاء والتنفيذ والنشر (Build, Execution, Deployment) > أدوات الإنشاء (Build Tools) واضبط وضع مزامنة المشروع (Project Sync mode) على المزامنة اليدوية مع التذكيرات (Manual Sync with reminders) كوضع مزامنة المشروع.

الميزات التي تم إطلاقها من Studio Labs

ستصبح الميزات التجريبية التالية من Studio Labs ثابتة بدءًا من إصدار Narwhal 3:

تحديث الإصدار 4 من Android Studio Narwhal‏ | 2025.1.4

في ما يلي الميزات الجديدة في التحديث الرابع لإصدار Narwhal من "استوديو Android"‏ (Android Studio Narwhal 4 Feature Drop) |‏ 2025.1.4.

للاطّلاع على المشاكل التي تم حلّها في هذا الإصدار من "استوديو Android"، راجِع المشاكل التي تم إغلاقها.

"رحلات المستخدم" في "استوديو Android"

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

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

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

تطبيق Backup and Sync

يمكنك الآن الاحتفاظ بنسخة احتياطية من إعدادات Android Studio في مساحة تخزين سحابية باستخدام حسابك على Google أو JetBrains. يساعد ذلك في مزامنة إعداداتك، مثل خرائط المفاتيح وإعدادات "محرّر الرموز" وإعدادات النظام وغير ذلك. للبدء، اتّبِع أحد الإجراءَين التاليَين:

  • بعد فتح مشروع في Android Studio، سجِّل الدخول إلى حسابك على Google من خلال النقر على الأفاتار في أعلى يسار بيئة التطوير المتكاملة (IDE)، ثم النقر على تسجيل الدخول.

    1. اتّبِع التعليمات في مربّع الحوار الذي يظهر، وتأكَّد من وضع علامة في المربّع لمنح Android Studio الإذن بالوصول إلى مساحة التخزين في حسابك على Google.
    2. اتّبِع التعليمات الظاهرة على الشاشة للسماح باستخدام Android Studio.
  • انتقِل إلى الإعدادات > الاحتفاظ بنسخة احتياطية والمزامنة.

    1. اختَر Google لاستخدام مساحة تخزين حسابك على Google من أجل مزامنة بيانات تطبيقك على جميع عمليات تثبيت Android Studio. يمكنك بدلاً من ذلك استخدام حساب JetBrains لمزامنة بيانات تطبيقك على جميع عمليات تثبيت IntelliJ و"استوديو Android".
    2. بعد اتّباع التعليمات التي تطلب منك منح "استوديو Android" الإذن بالوصول إلى مساحة التخزين في حسابك المفضّل، ارجع إلى "استوديو Android".
    3. في صفحة الإعدادات > الاحتفاظ بنسخة احتياطية والمزامنة، يمكنك مراجعة فئات بيانات التطبيقات التي تريد مزامنتها مع حسابك.
    4. لإيقاف ميزة "الاحتفاظ بنسخة احتياطية والمزامنة"، أزِل العلامة من المربّع الذي يفعّل الميزة.

إذا كانت لديك بيانات تمت مزامنتها مع جهازك المحدّد، يتيح لك Android Studio خيار تنزيل الإعدادات من وحدة التخزين البعيدة (وهذا هو الخيار التلقائي) أو تحميل إعداداتك المحلية واستبدال الإعدادات التي تمت مزامنتها مع وحدة التخزين البعيدة.

الحلول المقترَحة للأعطال

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

إعداد جديد لفتح المشاريع الجديدة باستخدام "طريقة عرض المشروع"

يتوفّر إعداد جديد لفتح المشاريع الجديدة في "طريقة عرض المشروع" تلقائيًا. لتفعيل الإعداد، انتقِل إلى ملف (File) (استوديو Android على نظام التشغيل macOS) > الإعدادات (Settings) > الإعدادات المتقدّمة (Advanced Settings) > عرض المشروع (Project View) وانقر على ضبط "عرض المشروع" كإعداد تلقائي (Set Project view as the default).

أداة اختبار لقطات شاشة "معاينة الإنشاء"

استخدِم أداة "اختبار لقطات شاشة معاينة Compose" لاختبار واجهات مستخدم Compose ومنع حدوث أخطاء. تساعدك الأداة الجديدة في إنشاء تقارير HTML تتيح لك رصد أي تغييرات في واجهة مستخدم تطبيقك بشكل مرئي. يمكنك الاطّلاع على مزيد من المعلومات في Compose Preview Screenshot Testing.

تحسين شجرة مكونات "أداة فحص التنسيق" المضمّنة

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

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

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

تتيح شجرة المكوّنات في "أداة فحص التنسيق المضمّن" الآن التمرير الأفقي والتمرير التلقائي عند التحديد.
تحسين شجرة المكوّنات في "أداة فحص التصميم المضمّن"

استخدام نموذج لغة كبير محلي

يتيح لك الإصدار الرابع من ميزات Android Studio Narwhal اختيار نموذج اللغة الكبير الذي يشغّل ميزات الذكاء الاصطناعي في بيئة التطوير المتكاملة.

نافذة محادثة Gemini في Android Studio تعرض أداة اختيار النموذج مع خيارات Gemini ونموذج لغوي كبير محلي
أداة اختيار النماذج في "استوديو Android"

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

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

يتطلّب استخدام النماذج اللغوية الكبيرة (LLM) المحلية تثبيت موفّر نماذج لغوية كبيرة، مثل LM Studio أو Ollama، على جهاز الكمبيوتر المحلي بالإضافة إلى نموذج متوافق من اختيارك.

تتوافق "أداة ترقية حزم تطوير البرامج" لنظام التشغيل Android الآن مع الإصدار 16 من نظام التشغيل Android / المستوى 36 من واجهة برمجة التطبيقات

تمت إضافة عملية النقل من الإصدار Android 15 (المستوى 35 من واجهة برمجة التطبيقات) إلى الإصدار Android 16 (المستوى 36 من واجهة برمجة التطبيقات) إلى أداة ترقية حزم تطوير البرامج (SDK) لنظام Android. للحصول على مساعدة في نقل البيانات، انتقِل إلى الأدوات > أداة ترقية حزمة تطوير البرامج لنظام التشغيل Android.

الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android

الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android هو إصدار رئيسي جديد من هذا المكوّن، ويتضمّن تغييرات في واجهة برمجة التطبيقات والسلوك.

للتحديث إلى الإصدار 9.0.0-alpha02 من المكوّن الإضافي لنظام Gradle المتوافق مع Android، استخدِم مساعد ترقية المكوّن الإضافي لنظام Gradle المتوافق مع Android في الإصدار 4 من تحديث Narwhal من "استوديو Android"‏ | 2025.1.4.

يساعد "مساعد ترقية" AGP في الحفاظ على السلوكيات الحالية عند ترقية مشروعك عند الاقتضاء، ما يتيح لك ترقية مشروعك لاستخدام الإصدار 9.0 من AGP، حتى إذا لم تكن مستعدًا لاستخدام جميع الإعدادات التلقائية الجديدة في الإصدار 9.0 من AGP.

التوافق

الحدّ الأقصى لمستوى واجهة برمجة التطبيقات في Android الذي يتيحه الإصدار 9.0.0-alpha02 من المكوّن الإضافي لنظام Gradle المتوافق مع Android هو المستوى 36 من واجهة برمجة التطبيقات.

يتطلّب الإصدار 9.0.0-alpha02 من المكوّن الإضافي لنظام Gradle المتوافق مع Android استخدام الإصدار 9.0.0 من Gradle.

تغييرات السلوك

يتضمّن الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android السلوكيات الجديدة التالية:

السُلوك الاقتراح
يستخدم الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android الإصدار r28c من NDK تلقائيًا. ننصحك بتحديد إصدار NDK الذي تريد استخدامه بشكل صريح.
يتطلّب الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android تلقائيًا أن يستخدم مستهلكو المكتبة الإصدار نفسه أو إصدارًا أحدث من حزمة SDK الخاصة بالتجميع. استخدِم حزمة SDK للتدوين نفسها أو حزمة أحدث عند استخدام مكتبة. إذا لم يكن ذلك ممكنًا، أو إذا أردت منح مستخدمي المكتبة التي تنشرها وقتًا أطول للتبديل، اضبط قيمة AarMetadata.minCompileSdk بشكل صريح.

يتضمّن الإصدار 9.0 من "مكوّن Android الإضافي في Gradle" تعديلات على الإعدادات التلقائية لخصائص Gradle التالية. يمنحك ذلك خيار الحفاظ على سلوك الإصدار 8.13 من "مكوّن Android الإضافي لبرنامج Gradle" عند الترقية:

الخاصية الوظيفة التغيير من الإصدار 8.13 إلى الإصدار 9.0 من "مكوّن Android الإضافي في Gradle" الاقتراح
android.uniquePackageNames يفرض أن يكون لكل مكتبة اسم حزمة مميز. falsetrue حدِّد أسماء حِزم فريدة لجميع المكتبات ضِمن مشروعك. إذا لم يكن ذلك ممكنًا، يمكنك إيقاف هذه العلامة أثناء نقل البيانات.
android.dependency.useConstraints تتحكّم هذه السمة في استخدام قيود التبعية بين عمليات الإعداد.
الإعداد التلقائي في الإصدار 9.0 من "مكوّن Android الإضافي Gradle" هو false الذي يستخدم القيود فقط في اختبارات التطبيق على الأجهزة (AndroidTest). سيؤدي ضبط هذا الخيار على true إلى الرجوع إلى السلوك السابق في الإصدار 8.13.
truefalse لا تستخدِم قيود التبعية في كل مكان ما لم تكن بحاجة إليها. يؤدي قبول القيمة التلقائية الجديدة لهذا الخيار إلى تفعيل عمليات التحسين في عملية استيراد المشاريع، ما يؤدي إلى تقليل وقت الاستيراد لعمليات الإنشاء التي تتضمّن العديد من المشاريع الفرعية لمكتبة Android.
aandroid.enableAppCompileTimeRClass تجميع الرموز البرمجية في التطبيقات مع فئة R غير نهائية، ما يؤدي إلى تجميع التطبيقات بشكل متوافق مع تجميع المكتبات
يؤدي ذلك إلى تحسين الزيادة ويُمهّد الطريق لإجراء تحسينات مستقبلية على الأداء في ما يتعلّق بسير عمل معالجة الموارد.
falsetrue يمكن للعديد من المشاريع اعتماد السلوك الجديد بدون إجراء أي تغييرات على المصدر. إذا تم استخدام حقول الفئة R في أي مكان يتطلّب قيمة ثابتة، مثل حالات التبديل، أعِد تصميم الرمز البرمجي لاستخدام عبارات if متسلسلة.
android.sdk.defaultTargetSdkToCompileSdkIfUnset يستخدم إصدار حزمة SDK المخصّص للتجميع كقيمة تلقائية لإصدار حزمة SDK المستهدَف في التطبيقات والاختبارات.
قبل هذا التغيير، كان إصدار حزمة SDK المستهدَف يتم ضبطه تلقائيًا على إصدار حزمة SDK الأدنى.
falsetrue حدِّد إصدار حزمة SDK المستهدَف بشكلٍ صريح للتطبيقات والاختبارات.
android.onlyEnableUnitTestForTheTestedBuildType لا ينشئ سوى مكوّنات اختبار الوحدة لنوع الإصدار الذي تم اختباره.
في المشروع التلقائي، يؤدي ذلك إلى إنشاء اختبار وحدة واحد لتصحيح الأخطاء، بينما كان السلوك السابق هو تشغيل اختبارات الوحدات لتصحيح الأخطاء أو الإصدار.
falsetrue إذا كان مشروعك لا يتطلّب إجراء اختبارات لكل من إصدارات تصحيح الأخطاء والإصدارات العلنية، لن تحتاج إلى إجراء أي تغيير.
android.proguard.failOnMissingFiles تعذُّر الإنشاء مع ظهور خطأ إذا لم تكن أي من ملفات الاحتفاظ المحدّدة في AGP DSL متوفّرة على القرص قبل هذا التغيير، كانت الأخطاء الإملائية في أسماء الملفات تؤدي إلى تجاهل الملفات بدون إشعار. falsetrue إزالة أي بيانات غير صالحة لملفات Proguard
android.r8.optimizedResourceShrinking تتيح هذه السمة لبرنامج R8 الاحتفاظ بعدد أقل من موارد Android من خلال أخذ الفئات وموارد Android في الاعتبار معًا. falsetrue إذا كانت قواعد الاحتفاظ بمشروعك مكتملة، ليس عليك إجراء أي تغيير.
android.r8.strictFullModeForKeepRules تسمح أداة R8 بالاحتفاظ بعدد أقل من العناصر من خلال عدم الاحتفاظ بشكل ضمني بالدالة الإنشائية التلقائية عند الاحتفاظ بفئة. أي أنّ -keep class A لم يعُد يعني -keep class A { <init>(); }
falsetrue إذا كانت قواعد الاحتفاظ بمشروعك مكتملة، ليس عليك إجراء أي تغيير.

استبدِل -keep class A بالقيمة -keep class A { <init>(); } في قواعد الاحتفاظ الخاصة بمشروعك في أي حالات تحتاج فيها إلى الاحتفاظ بالدالة الإنشائية التلقائية.
android.defaults.buildfeatures.shaders تتيح هذه السمة تجميع برامج التظليل في جميع المشاريع الفرعية truefalse فعِّل تجميع برامج التظليل في المشاريع الفرعية التي تحتوي على برامج تظليل فقط ليتم تجميعها من خلال ضبط ما يلي في ملفات إنشاء Gradle الخاصة بهذه المشاريع:
android {
  buildFeatures {
    shaders = true
  }
}

الميزات التي تمت إزالتها

يزيل الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android الوظائف التالية:

تغيير DSL

يتضمّن الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android تغييرات DSL التالية التي تؤدي إلى إيقاف بعض الوظائف:

  • تمت إزالة تحديد المَعلمات لـ CommonExtension. في حد ذاته، هذا التغيير هو تغيير غير متوافق على مستوى المصدر فقط للمساعدة في تجنُّب التغييرات غير المتوافقة المستقبلية على مستوى المصدر، ولكنّه يعني أيضًا أنّه يجب نقل طرق كتلة DSL من CommonExtension إلى ApplicationExtension وLibraryExension وDynamicFeatureExtension وTestExtension.

إزالة DSL

يزيل الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android ما يلي:

إزالة خصائص Gradle

تمت إضافة خصائص Gradle التالية في البداية كطرق لإيقاف الميزات التي تم تفعيلها تلقائيًا على مستوى العالم.

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

الخاصية الوظيفة الاستبدال
android.defaults.buildfeatures.aidl تتيح هذه السمة تجميع AIDL في جميع المشاريع الفرعية فعِّل تجميع AIDL في المشاريع الفرعية التي تتضمّن مصادر AIDL فقط، وذلك من خلال ضبط السمة التالية في ملفات تصميم Gradle الخاصة بهذه المشاريع:
android {
  buildFeatures {
    aidl = true
  }
}
في ملف تصميم Gradle لكل مشروع فرعي يحتوي على مصادر AIDL
android.defaults.buildfeatures.renderscript تتيح تجميع RenderScript في جميع المشاريع الفرعية فعِّل تجميع renderscript في المشاريع الفرعية فقط التي تتضمّن مصادر renderscript من خلال ضبط السمة التالية في ملفات إنشاء Gradle الخاصة بهذه المشاريع:
android {
  buildFeatures {
    renderScript = true
  }
}

واجهات برمجة التطبيقات التي تمت إزالتها

يزيل الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android ما يلي:

  • واجهات برمجة التطبيقات BaseExtension.registerTransform المتوقّفة نهائيًا وغير المفعّلة، والتي تم الإبقاء عليها فقط للسماح بالتجميع باستخدام أحدث إصدار من "مكوّن Android الإضافي" مع استهداف الإصدار 4.2 أو الإصدارات الأقدم من "مكوّن Android الإضافي".

خصائص Gradle الإلزامية

يُظهر الإصدار 9.0 من "مكوّن Android الإضافي في Gradle" خطأً إذا ضبطت خصائص Gradle التالية.

لن يرقّي مساعد ترقية المكوّن الإضافي لنظام Gradle المتوافق مع Android المشاريع إلى الإصدار 9.0 من المكوّن الإضافي لنظام Gradle المتوافق مع Android التي تستخدم هذه الخصائص.

الخاصية الوظيفة
android.r8.integratedResourceShrinking يتم الآن دائمًا تنفيذ عملية تصغير حجم الموارد كجزء من R8، وتمت إزالة التنفيذ السابق.