إنشاء وتعديل إعدادات التشغيل/تصحيح الأخطاء

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

لمزيد من المعلومات، يمكنك أيضًا الاطّلاع على مستندات IntelliJ التالية:

• إعدادات التشغيل/تصحيح الأخطاء

لمحة عن إعدادات التشغيل/تصحيح الأخطاء

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

إعدادات التشغيل/تصحيح الأخطاء التي تم إنشاؤها في البداية

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

نطاق المشروع والتحكّم في الإصدار

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

فتح مربّع الحوار "إعدادات التشغيل/تصحيح الأخطاء"

لفتح مربّع الحوار "إعدادات التشغيل/تصحيح الأخطاء"، اختَر تشغيل > تعديل الإعدادات. يظهر مربّع الحوار إعدادات التشغيل/تصحيح الأخطاء، كما هو موضّح في الشكل 1.

الشكل 1 مربّع الحوار إعدادات التشغيل/تصحيح الأخطاء

تُصنّف اللوحة اليمنى من مربّع الحوار عمليات الضبط المحدّدة حسب نوع النموذج، وتتيح لك تعديل نماذج الضبط في أسفل الصفحة. يمكنك تعديل الإعدادات المحدّدة في اللوحة اليمنى. غيِّر حجم مربع الحوار للاطّلاع على أي عناصر مخفية.

في مربّع الحوار هذا، يمكنك إجراء ما يلي:

• إنشاء إعدادات تشغيل/تصحيح أخطاء جديدة
• تعديل إعدادات التشغيل/تصحيح الأخطاء
• تعديل نماذج الإعدادات
• فرز عمليات الضبط وتجميعها

إنشاء إعدادات تشغيل/تصحيح أخطاء جديدة

يمكنك تحديد إعدادات تشغيل/تصحيح أخطاء جديدة من مربّع الحوار إعدادات التشغيل/تصحيح الأخطاء أو نافذة المشروع أو "محرّر الرموز". يجب أن يستند الإعداد الجديد إلى نموذج إعداد.

يعرض مربّع الحوار "إعدادات التشغيل/تصحيح الأخطاء" إعدادات التشغيل/تصحيح الأخطاء ونماذج الإعدادات المتاحة. يمكنك بدء عملية إعداد جديدة مباشرةً من نموذج أو من نسخة من عملية إعداد أخرى. يمكنك بعد ذلك تغيير قيم الحقول حسب الحاجة.

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

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

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

بدء عملية إعداد استنادًا إلى نموذج

لتحديد إعداد التشغيل/تصحيح الأخطاء استنادًا إلى نموذج، اتّبِع الخطوات التالية:

1. افتح مربّع الحوار "إعدادات التشغيل/تصحيح الأخطاء".
2. انقر على إضافة إعداد جديد .
3. اختَر نموذج إعداد.
4. اكتب اسمًا في الحقل الاسم.
5. عدِّل الإعدادات حسب الحاجة.

احرص على تصحيح أي أخطاء تظهر في أسفل مربّع الحوار.

6. انقر على تطبيق أو حسنًا.

بدء عملية إعداد من نسخة

لتحديد إعداد تشغيل/تصحيح أخطاء بدءًا من نسخة من إعداد آخر، اتّبِع الخطوات التالية:

1. افتح مربّع الحوار "إعدادات التشغيل/تصحيح الأخطاء".
2. اختَر إعدادًا حاليًا للتنفيذ/تصحيح الأخطاء في اللوحة اليمنى.
3. انقر على نسخ الإعداد .
4. اكتب اسمًا في الحقل الاسم.
5. عدِّل الإعدادات حسب الحاجة.

احرص على تصحيح أي أخطاء تظهر في أسفل مربع الحوار.

6. انقر على تطبيق أو حسنًا.

تحديد إعدادات لعنصر في المشروع

يمكن أن ينشئ "استوديو Android" إعدادات تشغيل/تصحيح أخطاء لبعض العناصر المعروضة في نافذة المشروع. يستند الإعداد إلى نموذج إعداد على النحو التالي:

• ملف Java الخاص بالنشاط: نموذج تطبيق Android
• الحزمة: نموذج اختبارات Android المزوّدة بأدوات أو نموذج Android JUnit، وذلك حسب مجموعة المصادر. في حال اختيار اختبار مزوَّد بأدوات، سيتم استخدام نموذج "الاختبارات المزوَّدة بأدوات" في Android. إذا اخترت اختبار وحدة محلية، سيتم استخدام نموذج Android JUnit. بالنسبة إلى اختبار الوحدة المحلّي، يمكنك اختياريًا تشغيله مع تغطية الرمز البرمجي. لمزيد من المعلومات، اطّلِع على تغطية الرمز.

لإنشاء إعداد تشغيل/تصحيح أخطاء لعنصر في مشروعك، اتّبِع الخطوات التالية:

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

   الشكل 2 حفظ التهيئة

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

تحديد إعدادات اختبار لفئة أو طريقة

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

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

لإنشاء إعدادات تشغيل/تصحيح أخطاء لفئة أو طريقة في رمز Java، اتّبِع الخطوات التالية:

1. افتح مشروعًا في طريقة عرض Android أو طريقة عرض المشروع.
2. افتح ملف Java في "محرّر الرموز".
3. اختَر فئة أو طريقة في الرمز، ثم اضغط على Control+Shift+T (Command+Shift+T).
4. انقر على إنشاء اختبار جديد من القائمة التي تظهر.
5. في مربّع الحوار إنشاء اختبار، يمكنك اختياريًا تغيير القيم أو ضبطها، ثم النقر على حسنًا.
6. في مربّع الحوار اختيار دليل الوجهة، اختَر المكان الذي تريد أن يضع فيه "استوديو Android" الاختبار في المشروع. يمكنك تحديد الموقع الجغرافي من خلال بنية الدليل أو عن طريق اختيار فئة مجاورة.
7. انقر على موافق.

   يظهر الاختبار الجديد في نافذة المشروع في مجموعة مصادر الاختبار المقابلة.

8. لإجراء الاختبار، اتّبِع أحد الإجراءَين التاليَين:
   • في نافذة المشروع، انقر بزر الماوس الأيمن على الاختبار واختَر تشغيل أو تصحيح الأخطاء.
   • في "محرّر الرموز" (Code Editor)، انقر بزر الماوس الأيمن على تعريف فئة أو اسم طريقة في ملف الاختبار، ثم اختَر تشغيل (Run) أو تصحيح الأخطاء (Debug) لاختبار جميع الطرق في الفئة.
9. افتح القائمة المنسدلة اختيار إعداد التشغيل/تصحيح الأخطاء في شريط الأدوات.
10. انقر على حفظ الضبط من الخيارات بجانب الضبط الذي تريد حفظه.
    

    الشكل 3 حفظ التهيئة

تشغيل تطبيق أو تصحيح أخطائه باستخدام إعدادات محفوظة

إذا كنت قد حفظت إعداد تشغيل/تصحيح أخطاء، يمكنك اختياره قبل تشغيل تطبيقك أو تصحيح أخطائه.

لاستخدام إعدادات التشغيل/تصحيح الأخطاء المحفوظة، اتّبِع الخطوات التالية:

1. اختَر إعداد التشغيل/تصحيح الأخطاء من القائمة المنسدلة اختيار إعداد التشغيل/تصحيح الأخطاء ضمن شريط الأدوات.

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

2. اختَر تشغيل (Run) > تشغيل (Run) أو تشغيل (Run) > تصحيح الأخطاء (Debug).

يمكنك بدلاً من ذلك النقر على تشغيل أو تصحيح الأخطاء .

تعديل إعدادات التشغيل/تصحيح الأخطاء

لتعديل إعدادات التشغيل/تصحيح الأخطاء، اتّبِع الخطوات التالية:

1. افتح مربّع الحوار "إعدادات التشغيل/تصحيح الأخطاء".
2. اختَر إعدادًا في اللوحة اليمنى.
3. عدِّل الإعدادات حسب الحاجة.

احرص على تصحيح أي أخطاء تظهر في أسفل مربع الحوار.

4. انقر على تطبيق أو حسنًا.

تعديل نموذج إعدادات التشغيل/تصحيح الأخطاء

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

على الرغم من أنّه لا يمكنك إنشاء نماذج جديدة، يمكنك إنشاء إعدادات لاستخدامها بشكل مشابه للنموذج. يمكنك نسخ إعدادات وتعديل النسخة لإنشاء إعدادات جديدة.

لتعديل نموذج، اتّبِع الخطوات التالية:

1. افتح مربّع الحوار "إعدادات التشغيل/تصحيح الأخطاء".
2. انقر على تعديل نماذج الإعدادات....
3. اختَر نموذج إعداد.
4. عدِّل الإعدادات حسب الحاجة.

احرص على تصحيح أي أخطاء تظهر في أسفل مربع الحوار.

5. انقر على تطبيق أو حسنًا.

ترتيب عمليات الضبط وتجميعها

في مربع الحوار Run/Debug Configurations، يمكنك ترتيب إعداداتك للعثور عليها بسرعة. يمكنك ترتيب العناصر في المجلد أبجديًا، وإنشاء مجلدات جديدة لتجميع عمليات الضبط.

لترتيب الإعدادات أبجديًا، اتّبِع الخطوات التالية:

1. افتح مربّع الحوار "إعدادات التشغيل/تصحيح الأخطاء".
2. اختَر مجلدًا يحتوي على إعدادات.
3. انقر على ترتيب عمليات التهيئة .
4. انقر على حسنًا لإغلاق مربّع الحوار.

لتجميع الإعدادات في مجلدات، اتّبِع الخطوات التالية:

1. افتح مربّع الحوار "إعدادات التشغيل/تصحيح الأخطاء".
2. اختَر مجلدًا يحتوي على إعدادات.
3. انقر على إنشاء مجلد جديد .
4. اكتب اسمًا في الحقل اسم المجلد.
5. انقر على تطبيق لحفظ الاسم.

اسحب العناصر من فئة النموذج نفسها إلى المجلد.

رتِّب المجلدات والإعدادات في فئة النموذج نفسها عن طريق سحبها إلى الموضع المطلوب.

انقر على حسنًا لإغلاق مربّع الحوار.

تحديد العمليات التي تتم قبل الإطلاق

يمكنك تحديد المهام التي سيتم تنفيذها قبل تطبيق إعدادات التشغيل/تصحيح الأخطاء. يتم تنفيذ المهام بالترتيب الذي تظهر به في القائمة.

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

لإنشاء قائمة مهام، اتّبِع الخطوات التالية:

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

   يتم إلغاء تحديد هذا الخيار تلقائيًا.

5. اختَر نافذة أداة نشطة إذا كنت تريد تفعيل نافذة الأداة تشغيل أو تصحيح الأخطاء عند تشغيل تطبيقك أو تصحيح أخطائه.

   ويتم تحديد هذا الخيار تلقائيًا.

لإزالة مهمة من القائمة، اتّبِع الخطوات التالية:

1. اختَر مهمة.
2. انقر على إزالة .

لتعديل مهمة، اتّبِع الخطوات التالية:

1. اختَر مهمة.
2. انقر على تعديل .
3. عدِّل إعدادات المهمة في مربّع الحوار الذي يفتح، ثم انقر على حسنًا.

يعرض الجدول التالي المهام المتاحة التي يمكنك إضافتها.

المهمة	الوصف
تشغيل أداة خارجية	تشغيل تطبيق خارجي عن "استوديو Android" في مربع الحوار الأدوات الخارجية، اختَر تطبيقًا واحدًا أو أكثر تريد تشغيله، ثم انقر على موافق. إذا لم يتم تحديد التطبيق في Android Studio بعد، أضِف تعريفه في مربّع الحوار إنشاء أدوات. لمزيد من المعلومات، يُرجى الاطّلاع على ضبط أدوات الجهات الخارجية والأدوات الخارجية.
تشغيل إعداد آخر	نفِّذ أحد إعدادات التشغيل/تصحيح الأخطاء الحالية. في مربّع الحوار اختيار الإعدادات المطلوب تنفيذها، اختَر الإعدادات المطلوب تنفيذها، ثم انقر على حسنًا.
طراز الجهاز	تجميع المشروع أو الوحدة ينفّذ Android Studio الأمر Make Module إذا كان إعداد التشغيل/تصحيح الأخطاء يحدّد وحدة معيّنة، أو ينفّذ الأمر Make Project إذا لم يتم تحديد أي وحدات.
إنشاء مشروع	تجميع المشروع ينفِّذ "استوديو Android" الأمر Make Project.
Make, no error check	هذا الخيار هو نفسه الخيار إنشاء، إلا أنّ Android Studio ينفّذ إعداد التشغيل/تصحيح الأخطاء بغض النظر عن نتيجة التجميع.
إنشاء عناصر	غير متاح في Android Studio.
تنفيذ مهمة Gradle	تشغيل مهمة Gradle في مربع الحوار الذي يفتح، حدِّد التفاصيل ثم انقر على موافق. لمزيد من المعلومات، اطّلِع على Gradle.
Make المتوافق مع Gradle	جمِّع المشروع وشغِّل Gradle.
أداة إنشاء App Engine Gradle	تتم مزامنة المشروع من خلال مهمة App Engine Gradle builder، ثم يتم إنشاء الوحدة.

نماذج الإعداد

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

• تطبيق Android
• اختبارات Android
• App Engine DevAppServer
• إضافة ومربّع وخلفية شاشة ساعة Wear OS

ملاحظة: كان الإصدار 2.1.x من Android Studio والإصدارات الأقدم يتضمّن نموذجًا لتطبيق Native، ولكن الإصدارات الأحدث لا تتضمّنه. إذا كان لديك نموذج "تطبيق أصلي" في مشروع، يحوّله "استوديو Android" إلى "تطبيق Android" عند تحميل المشروع. يرشدك مربّع الحوار تحويل المشروع خلال العملية.

نماذج غير متوافقة

تأتي النماذج غير المتوافقة التالية من IntelliJ IDEA، وهي غير مخصّصة لتطوير تطبيقات Android باستخدام "استوديو Android". للحصول على معلومات حول استخدام هذه النماذج، اتّبِع الروابط إلى مستندات IntelliJ IDEA.

• التطبيق
• مركّب
• Gradle
• Groovy
• JAR Application
• Java Scratch
• JUnit
• Kotlin
• Kotlin Script
• تصحيح الأخطاء عن بُعد
• Shell Script
• TestNG

خيارات الضبط الشائعة

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

يخزِّن "استوديو Android" إعدادات التشغيل/تصحيح الأخطاء المشترَكة في ملفات XML فردية ضمن المجلد project_directory/.idea/runConfigurations/. لمزيد من المعلومات، يُرجى الاطّلاع على التنسيق المستند إلى الدليل في مستندات مشاريع IntelliJ.

تطبيق Android

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

علامة التبويب "إعدادات عامة"

في علامة التبويب عام، يمكنك تحديد خيارات التثبيت والتشغيل والنشر. تحتوي علامة التبويب متنوّعة أيضًا على خيارات التثبيت.

الحقل	الوصف
الوحدة	اختَر وحدة لتطبيق هذا الإعداد عليها.
خيارات التثبيت: النشر	حدِّد خيارًا: حِزمة APK التلقائية: يمكنك إنشاء حِزمة APK ونشرها للمتغير المحدّد حاليًا. حزمة APK من مجموعة حزمات التطبيق: يمكنك إنشاء تطبيقك ونشره من خلال مجموعة حزمات تطبيق Android. أي أنّ "استوديو Android" يحوّل مشروع تطبيقك أولاً إلى حِزمة تطبيق تتضمّن جميع الرموز البرمجية المجمّعة والموارد الخاصة بتطبيقك. بعد ذلك، لا ينشئ Android Studio من حِزمة التطبيق هذه سوى حِزم APK المطلوبة لنشر تطبيقك على الجهاز المتصل. يجب عادةً استخدام هذا الخيار عند اختبار حِزمة التطبيق التي تنوي تحميلها على Google Play، لأنّ نشر التطبيق من حِزمة تطبيق يؤدي إلى زيادة إجمالي وقت الإنشاء. Custom Artifact: غير متوافق مع "استوديو Android". لا شيء: لا تثبِّت حزمة APK على جهاز. على سبيل المثال، إذا كنت تفضّل تثبيت حزمة APK يدويًا، لن تحتاج إلى Android Studio لتثبيتها.
خيارات التثبيت: النشر كتطبيق فوري	إذا كان تطبيقك يتيح تجارب فورية، أي إذا أضفت إمكانية استخدام التطبيقات الفورية عند إنشاء مشروع جديد أو أنشأت وحدة ميزات واحدة أو أكثر تتيح استخدام التطبيقات الفورية، يمكنك اختيار نشر وحدات الميزات التي تتيح استخدام التطبيقات الفورية من خلال وضع علامة في المربّع بجانب النشر كتطبيق فوري.
خيارات التثبيت: الميزات التي سيتم نشرها	إذا كان تطبيقك يتضمّن وحدات ميزات، ضَع علامة في المربّع بجانب كل ميزة تريد تضمينها عند نشر تطبيقك. لن يظهر لك هذا الخيار إلا إذا كان تطبيقك يتضمّن وحدات ميزات. ملاحظة: إذا أردت اختبار تنزيل وحدات الميزات وتثبيتها عند الطلب، عليك إجراء ذلك بعد نشر حزمة تطبيقك ثم استخدام مسار الاختبار الداخلي في Play Console. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تحميل حِزمة تطبيقك إلى Play Console.
خيارات التثبيت: علامات التثبيت	اكتب أي خيارات pm install adb تريد استخدامها. نسِّق الخيارات بالطريقة نفسها التي تستخدمها في سطر الأوامر، ولكن بدون مسار. في ما يلي بعض الأمثلة: -i foo.bar.baz -r /path/to/apk و -d -r القيمة التلقائية: لا توجد خيارات.
خيارات التشغيل: تشغيل	حدِّد خيارًا: لا شيء: لا يتم تشغيل أي شيء عند النقر على تشغيل أو تصحيح الأخطاء. ومع ذلك، إذا كان تطبيقك قيد التشغيل حاليًا ونقرت على تصحيح الأخطاء، سيربط &quot;استوديو Android&quot; أداة تصحيح الأخطاء بعملية تطبيقك. النشاط التلقائي: يتيح لك تشغيل النشاط الذي أشرت إليه على أنّه نشاط بدء التشغيل في ملف البيان. مثلاً: <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> نشاط محدّد: يتيح لك هذا الخيار تشغيل نشاط تطبيق معيّن في الوحدة. عند تحديد هذا الخيار، يظهر الحقل النشاط أدناه، حيث يمكنك كتابة اسم النشاط الذي تريد تشغيله، أو النقر على المزيد لاختيار نشاط من القائمة. عنوان URL: يمكنك تشغيل عنوان URL يتطابق مع فلتر intent في بيان تطبيقك. عند تحديد هذا الخيار، يظهر الحقل عنوان URL أدناه، حيث يمكنك إدخال عنوان URL. يجب ملء هذا الحقل لتشغيل تطبيق فوري على Android. ويمكنك أيضًا استخدامه لاختبار روابط التطبيقات على Android.
خيارات التشغيل: علامات التشغيل	اكتب أي خيارات am start adb تريد استخدامها. نسِّق الخيارات بالطريقة نفسها التي تستخدمها في سطر الأوامر، ولكن بدون هدف. مثلاً: -W لا يظهر هذا الخيار إذا اخترت القيمة بلا في الإطلاق. القيمة التلقائية: لا توجد خيارات.
خيارات استهداف النشر: الاستهداف	حدِّد خيارًا: فتح مربّع الحوار "اختيار جهاز النشر" (Open Select Deployment Target Dialog): يفتح مربّع الحوار اختيار جهاز النشر لاختيار جهاز افتراضي أو جهاز مادي. جهاز USB: استخدِم جهازًا متصلاً بجهاز الكمبيوتر المخصّص للتطوير من خلال منفذ USB. إذا كان هناك أكثر من جهاز واحد، سيظهر مربع حوار يتيح لك اختيار الجهاز. المحاكي: استخدِم جهازًا افتراضيًا. في عملية الإعداد، يمكنك اختيار جهاز AVD، وإلا سيتم استخدام جهاز AVD الأول في القائمة.
خيارات هدف النشر: استخدام الجهاز نفسه لعمليات الإطلاق المستقبلية	يتم إلغاء تحديد هذا الخيار تلقائيًا حتى يظهر لك مربع الحوار اختيار عملية النشر في كل مرة تشغّل فيها تطبيقًا لتتمكّن من اختيار جهاز. عند تحديد هذا الخيار ثم تشغيل تطبيق، سيظهر مربّع الحوار اختيار عملية النشر لتحديد جهاز. بعد ذلك، سيتم تشغيل التطبيق على الجهاز الذي اخترته في كل مرة تشغّله فيها، بدون عرض مربّع الحوار اختيار النشر. لتشغيل التطبيق على جهاز آخر، عليك إما إلغاء اختيار استخدام الجهاز نفسه لعمليات التشغيل المستقبلية، أو إيقاف التطبيق باستخدام تشغيل > إيقاف app أو إيقاف ، ثم إعادة تشغيله. سيظهر مربّع الحوار اختيار عملية النشر لتتمكّن من اختيار جهاز.
قبل الإطلاق	اطّلِع على تحديد عمليات Before Launch.

علامة التبويب "متنوّعة"

في علامة التبويب متنوعة، يمكنك تحديد خيارات logcat والتثبيت والتشغيل والنشر. تحتوي علامة التبويب عام أيضًا على خيارات التثبيت.

الحقل	الوصف
Logcat: عرض سجلّ logcat تلقائيًا	عند تحديد هذا الخيار، سيتم فتح نافذة Logcat في كل مرة يتم فيها نشر تطبيق وتشغيله بنجاح باستخدام هذا الإعداد. القيمة التلقائية: تم الاختيار.
Logcat: محو السجلّ قبل الإطلاق	اختَر هذا الخيار إذا كنت تريد أن يزيل Android Studio البيانات من الجلسات السابقة من ملف السجلّ قبل بدء تشغيل التطبيق. القيمة التلقائية: غير محدّد.
خيارات التثبيت: تخطّي التثبيت إذا لم تتغيّر حزمة APK.	عند تحديد هذا الخيار، لن يعيد "استوديو Android" نشر حِزمة APK إذا رصد أنّها لم تتغيّر. إذا أردت أن يفرض "استوديو Android" تثبيت حزمة APK، حتى إذا لم يتم تغييرها، عليك إلغاء تحديد هذا الخيار. القيمة التلقائية: تم الاختيار
خيارات التثبيت: فرض إيقاف التطبيق قيد التشغيل قبل تشغيل النشاط	في حال تحديد هذا الخيار، عندما يرصد Android Studio أنّه ليس عليه إعادة تثبيت حزمة APK لأنّها لم تتغيّر، سيوقف التطبيق بالقوة لكي يبدأ من نشاط مشغّل التطبيقات التلقائي. إذا تم إلغاء تحديد هذا الخيار، لن يفرض Android Studio إيقاف التطبيق. يعمل هذا الخيار مع الخيار السابق الذي يتحكّم في ما إذا كان سيتم تثبيت حزمة APK أم لا. بالنسبة إلى حقلَي خيارات التثبيت، اتركهما على الإعداد التلقائي ما لم تكن تريد فرض التثبيت في كل مرة. في بعض الحالات، قد تحتاج إلى إلغاء تحديد هذا الخيار. على سبيل المثال، إذا كنت تكتب محرك طريقة إدخال (IME)، سيؤدي إيقاف التطبيق بالقوة إلى إلغاء اختياره كلوحة مفاتيح حالية، وهو ما قد لا تريده. القيمة التلقائية: تم الاختيار
قبل الإطلاق	راجِع تحديد عمليات "التشغيل قبل الإطلاق".

علامة التبويب "برنامج تصحيح الأخطاء"

حدِّد خيارات تصحيح الأخطاء في علامة التبويب برنامج تصحيح الأخطاء.

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

بالنسبة إلى مشاريع C وC++، يمكنك إضافة أدلة الرموز، بالإضافة إلى أوامر بدء تشغيل LLDB وأوامر ما بعد الربط، في علامة التبويب المصحّح. لإجراء ذلك، يمكنك استخدام أزرار مشابهة لما يلي:

• إضافة - إضافة دليل أو أمر
• إزالة - حدِّد دليلاً أو أمرًا، ثم انقر على هذا الزر لإزالة العنصر.
• للأعلى - اختَر دليلاً أو أمرًا، ثم انقر على هذا الزر لنقل العنصر إلى أعلى القائمة.
• للأسفل - اختَر دليلاً أو أمرًا، ثم انقر على هذا الزر لنقل العنصر إلى أسفل القائمة.

يمكنك الاطّلاع على تصحيح أخطاء تطبيقك للحصول على مزيد من المعلومات حول تصحيح الأخطاء في "استوديو Android".

الحقل	الوصف
نوع تصحيح الأخطاء	حدِّد أحد الخيارات التالية: Java فقط: لتصحيح أخطاء رمز Java فقط الرصد التلقائي: يتيح هذا الخيار لـ "استوديو Android" اختيار أفضل نوع تصحيح أخطاء لمشروعك. الإصدار الأصلي فقط: لتصحيح أخطاء رمز C أو C++ الأصلي وضع التصحيح المزدوج (Java + الرمز البرمجي الأصلي): لتصحيح أخطاء رموز Java والرموز الأصلية في جلستَي تصحيح أخطاء منفصلتَين ننصحك باستخدام الخيار الرصد تلقائيًا لأنّه يختار نوع تصحيح الأخطاء المناسب لمشروعك.
أدلة الرموز	إذا أردت إضافة ملفات رموز لتزويد مصحّح الأخطاء بمعلومات C أو C++‎ تم إنشاؤها خارج Android Studio، يمكنك إضافة دليل واحد أو أكثر هنا. يستخدم Android Studio بشكل تفضيلي أي ملفات ضمن هذه الدلائل بدلاً من الملفات التي تم إنشاؤها بواسطة المكوّن الإضافي لنظام Android في Gradle. يبحث مصحّح الأخطاء في الدلائل من الأعلى إلى الأسفل، بالترتيب، إلى أن يعثر على ما يحتاج إليه. يبحث بشكل متكرر في الملفات الموجودة في الدليل. لتحسين القائمة وتوفير الوقت، ضَع الدلائل الأكثر استخدامًا في أعلى القائمة. في حال تحديد دليل في أعلى الشجرة، قد يستغرق البحث في جميع الأدلة الفرعية وقتًا أطول. إذا أضفت دليلًا محدّدًا جدًا، سيستغرق البحث وقتًا أقل. عليك تحقيق التوازن المناسب بين السرعة والعثور على الملفات التي تحتاج إليها لتصحيح الأخطاء. على سبيل المثال، إذا كان لديك دليل يحتوي على أدلة فرعية لواجهات التطبيق الثنائية (ABI) لنظام Android المختلفة، يمكنك اختيار إضافة دليل لواجهة تطبيق ثنائية (ABI) معيّنة أو لجميع واجهات التطبيق الثنائية (ABI). على الرغم من أنّ البحث في الدليل ذي المستوى الأعلى قد يستغرق وقتًا أطول، إلا أنّه أكثر أمانًا إذا قررت تصحيح الأخطاء على جهاز مختلف. يُرجى العِلم أنّه ليس عليك إضافة أدلة تحتوي على ملفات رموز Gradle لأنّ مصحّح الأخطاء يستخدمها تلقائيًا.
أوامر بدء تشغيل LLDB	أضِف أوامر LLDB التي تريد تنفيذها قبل أن ينضم برنامج تصحيح الأخطاء إلى العملية. على سبيل المثال، يمكنك تحديد إعدادات للبيئة، كما هو موضّح في الأمر التالي: settings set target.max-memory-read-size 2048 ينفِّذ LLDB الأوامر بالترتيب من الأعلى إلى الأسفل.
أوامر LLDB بعد الربط	أضِف أوامر LLDB التي تريد تنفيذها مباشرةً بعد أن يربط مصحّح الأخطاء بالعملية. مثلاً: process handle SIGPIPE -n true -p true -s false ينفِّذ LLDB الأوامر بالترتيب من الأعلى إلى الأسفل.
دليل العمل الخاص بالمضيف	تحديد دليل عمل LLDB
تسجيل البيانات: القنوات المستهدَفة	حدِّد خيارات سجلّ LLDB. يضبط Android Studio الخيارات التلقائية استنادًا إلى خبرة الفريق، لذا لن يكون بطيئًا جدًا ولكنه سيتضمّن المعلومات اللازمة لتحديد المشاكل وحلّها. ويُطلب غالبًا الحصول على السجلّ عند إرسال تقارير عن أخطاء في "استوديو Android". هذه القيمة التلقائية هي lldb process:gdb-remote packets يمكنك تغيير الإعداد التلقائي لجمع المزيد من المعلومات. على سبيل المثال، تجمع خيارات السجلّ التالية معلومات حول platform معيّن: lldb process platform:gdb-remote packets للحصول على قائمة كاملة بأوامر السجلّ، أدخِل الأمر log list من نافذة LLDB shell في "استوديو Android". يضع "استوديو Android" سجلّات الجهاز في الموقع الجغرافي التالي، حيث يمثّل ApplicationId معرّف التطبيق الفريد المستخدَم في بيان حزمة APK الذي تم إنشاؤه، ويحدّد تطبيقك على جهازك وفي "متجر Google Play": /data/data/ApplicationId/lldb/log أو إذا كان عدّة مستخدمين يصلون إلى جهاز، سيتم وضع السجلّات في الموقع التالي، حيث AndroidUserId هو معرّف فريد لمستخدم على الجهاز: /data/user/AndroidUserId/ApplicationId/lldb/log للحصول على معلومات حول استخدام LLDB لتصحيح الأخطاء عن بُعد، راجِع تصحيح الأخطاء عن بُعد.
قبل الإطلاق	اطّلِع على تحديد عمليات Before Launch.

علامة التبويب "إنشاء الملفات الشخصية"

يجب وضع علامة في المربّع بجانب الخيار تفعيل إنشاء الملفات الشخصية المتقدّمة لتفعيل ميزات معيّنة في Android Profiler عندما يعمل جهازك بالإصدار 7.1 من نظام التشغيل Android أو إصدار أقدم.

اختبارات Android

يعتمد نموذج الاختبار الذي يجب استخدامه على مجموعة المصادر. نموذج "اختبارات Android المزوّدة بأدوات" مخصّص للاختبارات المزوّدة بأدوات. نموذج Android JUnit مخصّص لاختبار الوحدات المحلية.

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

تتضمّن أوصاف علامات التبويب التالية علامات التبويب والحقول الخاصة بنموذج اختبار Android Instrumented. للحصول على معلومات حول علامات التبويب والحقول الخاصة بنموذج اختبار Android JUnit، راجِع صفحة إعدادات التشغيل/تصحيح الأخطاء في IntelliJ: JUnit.

علامة التبويب "إعدادات عامة"

في علامة التبويب عام، يمكنك تحديد موقع الاختبار، وInstrumentation Runner، وadb shell، وخيارات النشر.

الحقل	الوصف
الوحدة	اختَر وحدة لتطبيق هذا الإعداد عليها.
الاختبار	في هذا القسم، حدِّد موقع الاختبارات التي تريد إجراؤها: الكل في الوحدة: لبدء جميع الاختبارات من الوحدة المحدّدة الكل في الحزمة: تشغيل جميع الاختبارات من الحزمة المحدّدة في حقل الحزمة اكتب الاسم أو انقر على المزيد لاختيار الحزمة من مربّع حوار. الفئة: لتشغيل اختبارات الفئة المحدّدة في حقل الفئة اكتب الاسم أو انقر على المزيد لاختيار الصف من مربّع حوار. الطريقة: إطلاق طريقة اختبار في حقل الفئة، حدِّد الفئة التي تتضمّن الطريقة. في حقل الطريقة، حدِّد الطريقة. اكتب الاسم أو انقر على المزيد لاختيار الفئة أو الطريقة من مربّع حوار.
أداة تشغيل أدوات القياس المحدّدة (اختياري)	اكتب الموقع الجغرافي لمشغّل أدوات القياس، ثم انقر على المزيد لاستخدام مربّع حوار. يحدّد الملف build.gradle موقع أداة تشغيل الاختبار، وتلغي هذه القيمة الموقع المحدّد. يكون الإعداد التلقائي عادةً هو الفئة AndroidJUnitRunner من AndroidX Test.
خيارات إضافية	اكتب أي خيارات am instrument adb تريد استخدامها. لا تكتب المكوّن. على سبيل المثال، إذا كنت تستخدم AndroidJUnitRunner من AndroidX Test، يمكنك استخدام هذا الحقل لتمرير خيارات إضافية إلى المشغّل، مثل -e size small. القيمة التلقائية: ما مِن خيارات
خيارات استهداف النشر: الاستهداف	حدِّد خيارًا: فتح مربّع الحوار "اختيار جهاز النشر" (Open Select Deployment Target Dialog): يفتح مربّع الحوار اختيار جهاز النشر لاختيار جهاز افتراضي أو جهاز مادي. جهاز USB: استخدِم جهازًا متصلاً بجهاز الكمبيوتر المخصّص للتطوير من خلال منفذ USB. إذا كان هناك أكثر من جهاز واحد، سيظهر مربع حوار يتيح لك اختيار الجهاز. المحاكي: استخدِم جهازًا افتراضيًا. في عملية الإعداد، يمكنك اختيار جهاز AVD، وإلا سيتم استخدام جهاز AVD الأول في القائمة. مصفوفة الأجهزة في مركز الاختبار الافتراضي لمنصة Firebase: يمكنك الاطّلاع على إجراء اختباراتك باستخدام مركز الاختبار الافتراضي لمنصة Firebase.
خيارات هدف النشر: استخدام الجهاز نفسه لعمليات الإطلاق المستقبلية	إذا أردت استخدام الجهاز الذي اخترته تلقائيًا من خلال مربع الحوار اختيار هدف النشر في المستقبل، ضَع علامة في هذا المربّع. إذا لم يكن الجهاز متاحًا، سيظهر لك مربّع حوار. الإعداد التلقائي: غير محدّد
قبل الإطلاق	اطّلِع على تحديد عمليات Before Launch.

علامة التبويب "متنوّعة"

تحتوي علامة التبويب متنوّعة على خيارات logcat والتثبيت.

الحقل	الوصف
Logcat: محو السجلّ قبل الإطلاق	اختَر هذا الخيار إذا كنت تريد أن يزيل Android Studio البيانات من الجلسات السابقة من ملف السجلّ قبل بدء تشغيل التطبيق. القيمة التلقائية: غير محدّد.
خيارات التثبيت: تخطّي التثبيت إذا لم تتغيّر حزمة APK	عند تحديد هذا الخيار، لن يعيد "استوديو Android" نشر حزمة APK إذا رصد أنّها لم تتغيّر. إذا أردت أن يفرض "استوديو Android" تثبيت حِزمة APK، حتى إذا لم تتغيّر، عليك إلغاء تحديد هذا الخيار. القيمة التلقائية: تم الاختيار
خيارات التثبيت: فرض إيقاف التطبيق قيد التشغيل قبل تشغيل النشاط	في حال تحديد هذا الخيار، عندما يرصد Android Studio أنّه ليس عليه إعادة تثبيت حزمة APK لأنّها لم تتغيّر، سيوقف التطبيق بالقوة لكي يبدأ من نشاط مشغّل التطبيقات التلقائي. إذا تم إلغاء تحديد هذا الخيار، لن يفرض Android Studio إيقاف التطبيق. يعمل هذا الخيار بالتزامن مع الخيار السابق الذي يتحكّم في ما إذا كان سيتم تثبيت حزمة APK أم لا. بالنسبة إلى حقلَي خيارات التثبيت، اتركهما على الإعداد التلقائي ما لم تكن تريد فرض التثبيت في كل مرة. في بعض الحالات، قد تحتاج إلى إلغاء تحديد هذا الخيار. على سبيل المثال، إذا كنت تكتب محرك طريقة إدخال (IME)، سيؤدي إيقاف التطبيق بالقوة إلى إلغاء اختياره كلوحة مفاتيح حالية، وهو ما قد لا تريده. القيمة التلقائية: تم الاختيار
قبل الإطلاق	اطّلِع على تحديد عمليات Before Launch.

علامة التبويب "برنامج تصحيح الأخطاء"

حدِّد خيارات تصحيح الأخطاء في علامة التبويب برنامج تصحيح الأخطاء.

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

بالنسبة إلى مشاريع C وC++، يمكنك إضافة أدلة الرموز، بالإضافة إلى أوامر بدء تشغيل LLDB وأوامر ما بعد الربط، في علامة التبويب المصحّح. لإجراء ذلك، يمكنك استخدام أزرار مشابهة لما يلي:

• إضافة - إضافة دليل أو أمر
• إزالة - حدِّد دليلاً أو أمرًا، ثم انقر على هذا الزر لإزالة العنصر.
• للأعلى - اختَر دليلاً أو أمرًا، ثم انقر على هذا الزر لنقل العنصر إلى أعلى القائمة.
• للأسفل - اختَر دليلاً أو أمرًا، ثم انقر على هذا الزر لنقل العنصر إلى أسفل القائمة.

يمكنك الاطّلاع على تصحيح أخطاء تطبيقك للحصول على مزيد من المعلومات حول تصحيح الأخطاء في "استوديو Android".

الحقل	الوصف
نوع تصحيح الأخطاء	حدِّد أحد الخيارات التالية: Java فقط: لتصحيح أخطاء رمز Java فقط الرصد التلقائي: يتيح هذا الخيار لـ "استوديو Android" اختيار أفضل نوع تصحيح أخطاء لمشروعك. الإصدار الأصلي فقط: لتصحيح أخطاء رمز C أو C++ الأصلي وضع التصحيح المزدوج (Java + الرمز البرمجي الأصلي): لتصحيح أخطاء رموز Java والرموز الأصلية في جلستَي تصحيح أخطاء منفصلتَين ننصحك باستخدام الخيار الرصد تلقائيًا لأنّه يختار نوع تصحيح الأخطاء المناسب لمشروعك.
أدلة الرموز	إذا أردت إضافة ملفات رموز لتزويد مصحّح الأخطاء بمعلومات C أو C++‎ تم إنشاؤها خارج Android Studio، يمكنك إضافة دليل واحد أو أكثر هنا. يستخدم Android Studio بشكل تفضيلي أي ملفات ضمن هذه الدلائل بدلاً من الملفات التي تم إنشاؤها بواسطة المكوّن الإضافي لنظام Android في Gradle. يبحث مصحّح الأخطاء في الدلائل من الأعلى إلى الأسفل، بالترتيب، إلى أن يعثر على ما يحتاج إليه. يبحث بشكل متكرر في الملفات الموجودة في الدليل. لتحسين القائمة وتوفير الوقت، ضَع الدلائل الأكثر استخدامًا في أعلى القائمة. في حال تحديد دليل في أعلى الشجرة، قد يستغرق البحث في جميع الأدلة الفرعية وقتًا أطول. إذا أضفت دليلًا محدّدًا جدًا، سيستغرق البحث وقتًا أقل. عليك تحقيق التوازن المناسب بين السرعة والعثور على الملفات التي تحتاج إليها لتصحيح الأخطاء. على سبيل المثال، إذا كان لديك دليل يحتوي على أدلة فرعية لواجهات التطبيق الثنائية (ABI) لنظام Android المختلفة، يمكنك اختيار إضافة دليل لواجهة تطبيق ثنائية (ABI) معيّنة أو لجميع واجهات التطبيق الثنائية (ABI). على الرغم من أنّ البحث في الدليل ذي المستوى الأعلى قد يستغرق وقتًا أطول، إلا أنّه أكثر أمانًا إذا قررت تصحيح الأخطاء على جهاز مختلف. يُرجى العِلم أنّه ليس عليك إضافة أدلة تحتوي على ملفات رموز Gradle لأنّ مصحّح الأخطاء يستخدمها تلقائيًا.
أوامر بدء تشغيل LLDB	أضِف أوامر LLDB التي تريد تنفيذها قبل أن ينضم برنامج تصحيح الأخطاء إلى العملية. على سبيل المثال، يمكنك تحديد إعدادات للبيئة، كما هو موضّح في الأمر التالي: settings set target.max-memory-read-size 2048 ينفِّذ LLDB الأوامر بالترتيب من الأعلى إلى الأسفل.
أوامر LLDB بعد الربط	أضِف أوامر LLDB التي تريد تنفيذها مباشرةً بعد أن يربط مصحّح الأخطاء بالعملية. مثلاً: process handle SIGPIPE -n true -p true -s false ينفِّذ LLDB الأوامر بالترتيب من الأعلى إلى الأسفل.
دليل العمل الخاص بالمضيف	تحديد دليل عمل LLDB
تسجيل البيانات: القنوات المستهدَفة	حدِّد خيارات سجلّ LLDB. يضبط Android Studio الخيارات التلقائية استنادًا إلى خبرة الفريق، لذا لن يكون بطيئًا جدًا ولكنه سيتضمّن المعلومات اللازمة لتحديد المشاكل وحلّها. ويُطلب غالبًا الحصول على السجلّ عند إرسال تقارير عن أخطاء في "استوديو Android". هذه القيمة التلقائية هي lldb process:gdb-remote packets يمكنك تغيير الإعداد التلقائي لجمع المزيد من المعلومات. على سبيل المثال، تجمع خيارات السجلّ التالية معلومات حول platform معيّن: lldb process platform:gdb-remote packets للحصول على قائمة كاملة بأوامر السجلّ، أدخِل الأمر log list من نافذة LLDB shell في "استوديو Android". يضع "استوديو Android" سجلّات الجهاز في الموقع الجغرافي التالي، حيث يمثّل ApplicationId معرّف التطبيق الفريد المستخدَم في بيان حزمة APK الذي تم إنشاؤه، ويحدّد تطبيقك على جهازك وفي "متجر Google Play": /data/data/ApplicationId/lldb/log أو إذا كان عدّة مستخدمين يصلون إلى جهاز، سيتم وضع السجلّات في الموقع التالي، حيث AndroidUserId هو معرّف فريد لمستخدم على الجهاز: /data/user/AndroidUserId/ApplicationId/lldb/log للحصول على معلومات حول استخدام LLDB لتصحيح الأخطاء عن بُعد، راجِع تصحيح الأخطاء عن بُعد.
قبل الإطلاق	اطّلِع على تحديد عمليات Before Launch.

App Engine DevAppServer

تنطبق إعدادات التشغيل/تصحيح الأخطاء هذه على Google Cloud Platform. عند اتّباع هذه الخطوات ومزامنة مشروعك مع الملف build.gradle، ينشئ Android Studio إعداد App Engine DevAppServer لك.

يُرجى العِلم أنّ نموذج خادم App Engine في IntellJ IDEA هو نموذج مختلف غير متوفّر في Android Studio.

الحقل	الوصف
مثيل واحد فقط	إذا أردت التأكّد من تنفيذ مثيل واحد فقط من إعدادات التشغيل/تصحيح الأخطاء حاليًا، حدِّد هذا الخيار. ولا يسمح بتنفيذ عمليات متعددة للإعداد نفسه في الوقت نفسه. القيمة التلقائية: تم الاختيار
الوحدة	اختَر وحدة لتطبيق هذا الإعداد عليها.
المزامنة مع إعدادات build.gradle	في حال إضافة وحدة App Engine ومزامنتها مع الملف build.gradle، سيتم ملء حقول إعداد App Engine DevAppServer تلقائيًا (يُنصح بذلك). يؤدي اختيار ملف > مزامنة المشروع مع ملفات Gradle أيضًا إلى مزامنة المشروع. القيمة التلقائية: تم الاختيار
حزمة تطوير البرامج (SDK) في App Engine	اكتب مسارًا إلى حزمة تطوير البرامج (SDK) في Google App Engine للغة Java على الجهاز المحلي. انقر على ... لاختيارها من مربّع حوار.
War Path	اكتب مسارًا إلى دليل Web Application Archive (WAR) الخاص بالتطبيق الذي تريد نشره على خادم التطوير المحلي. انقر على ... لاختياره من مربّع حوار.
وسيطات الجهاز الافتراضي	حدِّد خيارات سطر الأوامر التي تريد تمريرها إلى الجهاز الافتراضي لتشغيل DevAppServer. عند تحديد الخيارات: استخدِم المسافات للفصل بين الخيارات المختلفة. بالنسبة إلى الخيارات التي تتضمّن مسافات، ضَع المسافة بين علامتَي اقتباس (" "). إذا كان أحد الخيارات يتضمّن علامات اقتباس، أضِف شرطة مائلة عكسية قبل علامة الاقتباس (\"). لمزيد من المعلومات حول خيارات الجهاز الافتراضي، راجِع المستندات الخاصة بإصدار J2SE، مثل java JDK 7 وjava JDK 8. القيمة التلقائية: لا تتوفّر أي خيارات
عنوان الخادم	اكتب عنوان المضيف الذي تريد استخدامه للخادم. قد تحتاج إلى تقديم العنوان لتتمكّن من الوصول إلى خادم التطوير من جهاز كمبيوتر آخر على شبكتك. يسمح العنوان 0.0.0.0 بالوصول إلى كل من المضيف المحلي واسم المضيف. القيمة التلقائية: localhost
منفذ الخادم	اكتب رقم المنفذ الذي سيتم استخدامه للخادم. القيمة التلقائية: 8080
إيقاف ميزة "التحقّق من توفّر تحديثات لحزمة تطوير البرامج (SDK) في App Engine"	في حال توفُّرها، لن يتواصل خادم التطوير مع App Engine للتحقّق من توفّر إصدار جديد من حزمة تطوير البرامج (SDK). يتأكّد الخادم تلقائيًا من توفّر إصدار جديد عند بدء التشغيل، ويعرض رسالة في حال توفّر إصدار جديد.
قبل الإطلاق	اطّلِع على تحديد عمليات Before Launch.

إعدادات التشغيل/تصحيح الأخطاء في Wear OS

تتيح لك نماذج الإضافات والشاشات والمعلومات في Wear OS تشغيل تطبيقات Wear OS أو تصحيح أخطائها على أجهزة افتراضية أو فعلية. تتشابه معظم خيارات إعداد النموذج مع خيارات تطبيق Android. في ما يلي الخيارات الأكثر تحديدًا لإعدادات التشغيل/تصحيح الأخطاء في Wear OS:

• بالنسبة إلى جميع إعدادات التشغيل/تصحيح الأخطاء على Wear، عليك اختيار مصدر بيانات محدد لعنصر واجهة مستخدم معقّد أو لوحة أو خلفية ساعة (حسب النموذج) لتطبيق الإعدادات عليه. بشكل عام، يتوافق كل عنصر من هذه العناصر مع فئة في الرمز البرمجي.
• بالنسبة إلى إعدادات تشغيل/تصحيح أخطاء "عنصر واجهة مستخدم" في Wear OS، عليك اختيار الفتحة التي تريد وضع بيانات عنصر واجهة المستخدم المقدَّمة من مصدر بيانات عنصر واجهة المستخدم فيها. يمكنك اختيار وضعه في أعلى خلفية شاشة الساعة أو يمينها أو أسفلها أو يسارها أو في الخلفية.
• بالنسبة إلى إعدادات تشغيل/تصحيح أخطاء "إضافة Wear OS"، عليك أيضًا اختيار النوع الخاص ببيانات الإضافة التي يوفّرها مصدر بيانات الإضافة. تقتصر الأنواع التي يمكنك الاختيار من بينها على تلك التي يوفّرها مصدر بيانات المضاعفات المحدّد والتي تتوافق مع الخانة المحدّدة. للاطّلاع على قائمة بأنواع بيانات العناصر الإضافية، راجِع الأنواع والحقول.

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

الشكل 1. تشغيل مساحة Wear OS مباشرةً باستخدام رمز "حاشية الصفحة"