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

‫Android Studio هي بيئة التطوير المتكاملة الرسمية لتطوير تطبيقات Android، وتتضمّن كل ما تحتاج إليه لإنشاء تطبيقات Android.

تسرد هذه الصفحة الميزات والتحسينات الجديدة في أحدث إصدار من قناة الإصدار الثابت، وهو تحديث Narwhal 3 الذي يحتوي على ميزات جديدة في "استوديو Android". يمكنك تنزيلها من هنا أو تحديثها داخل "استوديو Android" من خلال النقر على مساعدة > البحث عن تحديثات (استوديو Android > البحث عن تحديثات على نظام التشغيل macOS).

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

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

للاطّلاع على ملاحظات الإصدارات القديمة من "استوديو Android"، يُرجى الرجوع إلى الإصدارات السابقة.

للحصول على إمكانية الوصول المبكر إلى الميزات والتحسينات القادمة، راجِع إصدارات المعاينة من "استوديو Android".

إذا واجهت مشاكل في "استوديو Android"، راجِع صفحة المشاكل المعروفة أو تحديد المشاكل وحلّها.

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

يستند نظام التصميم في "استوديو Android" إلى Gradle، ويضيف المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) العديد من الميزات الخاصة بإنشاء تطبيقات Android. يسرد الجدول التالي إصدار AGP المطلوب لكل إصدار من "استوديو Android".

إصدار Android Studio	إصدار AGP المطلوب
تحديث Narwhal 3 | 2025.1.3	‫4.0-8.13
تحديث Narwhal Feature Drop‏ | 2025.1.2	4.0-8.12
Narwhal | 2025.1.1	‫3.2-8.11
تحديث Meerkat | الإصدار 2024.3.2	‫3.2-8.10
Meerkat | 2024.3.1	‫3.2-8.9
Ladybug Feature Drop | 2024.2.2	3.2-8.8
Ladybug | 2024.2.1	‫3.2-8.7
تحديث "ميزات كوالا" | 2024.1.2	‫3.2-8.6
Koala | 2024.1.1	‫3.2-8.5
Jellyfish | 2023.3.1	‫3.2-8.4
Iguana | 2023.2.1	‫3.2-8.3
Hedgehog | 2023.1.1	‫3.2-8.2
Giraffe | 2022.3.1	3.2-8.1
Flamingo | 2022.2.1	‫3.2-8.0

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

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

تتوفّر إصدارات دنيا من Android Studio وAGP تتوافق مع مستوى معيّن من واجهة برمجة التطبيقات. قد يؤدي استخدام إصدارات أقدم من "استوديو Android" أو "مكوّن Android الإضافي في Gradle" من الإصدارات المطلوبة في targetSdk أو compileSdk لمشروعك إلى حدوث مشاكل غير متوقّعة. ننصحك باستخدام أحدث إصدار مبكر حصري من "استوديو Android" وAGP للعمل على المشاريع التي تستهدف إصدارات مبكرة حصرية من نظام التشغيل Android. يمكنك تثبيت إصدارات معاينة من "استوديو Android" إلى جانب إصدار ثابت.

في ما يلي الحد الأدنى لإصدارَي "استوديو Android" وAGP:

مستوى واجهة برمجة التطبيقات	أدنى إصدار من "استوديو Android"	الحد الأدنى لإصدار "مكوّن Android الإضافي لنظام Gradle"
36.0	Meerkat | 2024.3.1 Patch 1	‫8.9.1
35	تحديث "كوالا" | 2024.2.1	8.6.0
34	Hedgehog | 2023.1.1	8.1.1
33	Flamingo | 2022.2.1	7.2

التوافق مع "استوديو Android" وخدمات السحابة الإلكترونية

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

إصدارات "استوديو Android" المتوافقة حاليًا مع الخدمات السحابية

اعتبارًا من إصدار قناة الإصدار الثابت من تحديث Meerkat من "استوديو Android"، تتوافق جميع إصدارات "استوديو Android" مع الخدمات السحابية. سيبدأ تنفيذ التغيير مع إصدار Narwhal من "استوديو Android" الذي يتضمّن ميزات جديدة.

‫Studio Labs

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

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

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

في ما يلي ميزات جديدة في تحديث Narwhal 3 من "استوديو Android".

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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) كوضع مزامنة المشروع.

مرفق الصورة في Gemini

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

@سياق الملف في Gemini

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