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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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" إعدادًا جديدًا.

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

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

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

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

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

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

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

    الشكل 3 حفظ الإعدادات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تحديد العمليات التي يجب تنفيذها قبل الإطلاق

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ملاحظة: كان الإصدار 2.1.x والإصدارات الأقدم من "استوديو Android" تتضمّن نموذجًا لـ "تطبيق أصلي"، ولكن الإصدارات الأحدث لا تتضمّنه. إذا كان لديك نموذج تطبيق أصلي في مشروع، يحوّله "استوديو 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" من مجموعة حزمات التطبيق هذه حِزم APK المطلوبة فقط لنشر تطبيقك على الجهاز المتصل. ويُنصح عادةً باستخدام هذا الخيار عند اختبار مجموعة حزمات التطبيق التي تريد تحميلها على Google Play لأنّ النشر من مجموعة حزمات تطبيق يؤدي إلى زيادة إجمالي وقت الإنشاء. العنصر المخصّص: غير متوافق مع "استوديو Android". لا شيء: لا تثبِّت حزمة APK على جهاز. على سبيل المثال، إذا كنت تفضّل تثبيت حزمة APK يدويًا، لن تحتاج إلى "استوديو Android" لتثبيتها.
خيارات التثبيت: النشر كتطبيق فوري	إذا كان تطبيقك يتيح تجارب فورية، أي إذا أضفت إمكانية استخدام التطبيقات الفورية عند إنشاء مشروع جديد، أو إذا أنشأت وحدة أو أكثر من وحدات الميزات التي تم تفعيل ميزة التطبيقات الفورية فيها، يمكنك اختيار تفعيل هذه الوحدات التي تم تفعيل ميزة التطبيقات الفورية فيها من خلال وضع علامة في المربّع بجانب النشر كتطبيق فوري.
خيارات التثبيت: الميزات التي سيتم نشرها	إذا كان تطبيقك يتضمّن وحدات ميزات، ضَع علامة في المربّع بجانب كل ميزة تريد تضمينها عند نشر تطبيقك. لن يظهر لك هذا الخيار إلا إذا كان تطبيقك يتضمّن وحدات ميزات. ملاحظة: إذا أردت اختبار تنزيل وحدات الميزات وتثبيتها عند الطلب، عليك إجراء ذلك بعد نشر حِزمة تطبيقك، ثم استخدام مسار الاختبار الداخلي في Play Console. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة تحميل حزمة تطبيقك إلى Play Console.
خيارات التثبيت: علامات التثبيت	اكتب أي خيارات pm install adb تريد استخدامها. نسِّق الخيارات بالطريقة نفسها التي تستخدمها في سطر الأوامر، ولكن بدون مسار. وإليك بعض الأمثلة: -i foo.bar.baz -r /path/to/apk و -d -r القيمة التلقائية: بدون خيارات.
خيارات التشغيل: تشغيل	يجب تحديد أحد الخيارَين: لا شيء: لا يتم تشغيل أي شيء عند النقر على تشغيل أو تصحيح الأخطاء، ولكن إذا كان تطبيقك قيد التشغيل ونقرت على تصحيح الأخطاء، يربط "استوديو Android" أداة تصحيح الأخطاء بعملية تطبيقك. النشاط التلقائي: يتيح لك تشغيل النشاط الذي أشرت إليه كنشاط بدء التشغيل في ملف البيان. على سبيل المثال: <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): يفتح مربّع الحوار اختيار هدف النشر (Select Deployment Target) لاختيار جهاز افتراضي أو جهاز مادي. جهاز USB: استخدِم جهازًا متصلاً بجهاز الكمبيوتر المخصّص للتطوير من خلال منفذ USB. إذا كان هناك أكثر من جهاز واحد، سيظهر مربّع حوار يتيح لك اختيار الجهاز. المحاكي: استخدِم جهازًا افتراضيًا. في عملية الضبط، يمكنك اختيار جهاز محاكاة Android؛ وإلا سيتم استخدام جهاز محاكاة Android الأول في القائمة.
خيارات هدف النشر: استخدام الجهاز نفسه لعمليات الإطلاق المستقبلية	يتم إلغاء تحديد هذا الخيار تلقائيًا حتى يظهر مربّع الحوار اختيار عملية النشر في كل مرة تشغّل فيها تطبيقًا لتتمكّن من اختيار جهاز. عند تحديد هذا الخيار ثم تشغيل تطبيق، سيظهر مربّع الحوار اختيار عملية النشر لتحديد جهاز. بعد ذلك، سيتم تشغيل التطبيق على الجهاز الذي اخترته في كل مرة تشغّله فيها، بدون عرض مربّع الحوار اختيار النشر. لتشغيل التطبيق على جهاز مختلف، عليك إما إلغاء اختيار استخدام الجهاز نفسه في عمليات التشغيل المستقبلية، أو إيقاف التطبيق باستخدام تشغيل > إيقاف app أو إيقاف ، ثم إعادة تشغيله. سيظهر مربّع الحوار اختيار عملية النشر لتتمكّن من اختيار جهاز.
قبل الإطلاق	اطّلِع على تحديد عمليات Before Launch.

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

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

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

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

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

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

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

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

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

الحقل	الوصف
نوع تصحيح الأخطاء	اختر أحد الخيارين التاليين: Java فقط: لتصحيح أخطاء رمز Java فقط الرصد التلقائي: يتيح هذا الخيار لـ "استوديو Android" اختيار أفضل نوع تصحيح أخطاء لمشروعك. المحلية فقط: لتصحيح أخطاء الرموز البرمجية المحلية المكتوبة بلغة C أو ++C وضع التصحيح المزدوج (Java + الرمز الأصلي): لتصحيح أخطاء رموز Java والرموز البرمجية الأصلية في جلستَي تصحيح أخطاء منفصلتَين يُنصح باستخدام الخيار الرصد تلقائيًا لأنّه يختار نوع تصحيح الأخطاء المناسب لمشروعك.
أدلة الرموز	إذا أردت إضافة ملفات رموز لتزويد مصحّح الأخطاء بمعلومات C أو C++ تم إنشاؤها خارج "استوديو Android"، يمكنك إضافة دليل واحد أو أكثر هنا. يستخدم "استوديو Android" بشكل تفضيلي أي ملفات ضمن هذه الدلائل بدلاً من الملفات التي ينشئها المكوّن الإضافي لنظام 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 الخيارات التلقائية استنادًا إلى خبرة الفريق، لذا لن يكون بطيئًا جدًا ولكنه سيتضمّن المعلومات اللازمة لتحديد المشاكل وحلّها. ويُطلب غالبًا الحصول على السجلّ عند إرسال تقارير عن أخطاء في "استوديو 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" مخصّص لاختبار قياس حالة التطبيق. نموذج JUnit لنظام التشغيل Android مخصّص لاختبار الوحدة المحلية.

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

تتضمّن أوصاف علامات التبويب التالية علامات التبويب والحقول الخاصة بنموذج "اختبارات Android المزوّدة بأدوات". للحصول على معلومات حول علامات التبويب والحقول الخاصة بنموذج اختبار 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): يفتح مربّع الحوار اختيار هدف النشر (Select Deployment Target) لاختيار جهاز افتراضي أو جهاز مادي. جهاز USB: استخدِم جهازًا متصلاً بجهاز الكمبيوتر المخصّص للتطوير من خلال منفذ USB. إذا كان هناك أكثر من جهاز واحد، سيظهر مربّع حوار يتيح لك اختيار الجهاز. المحاكي: استخدِم جهازًا افتراضيًا. في عملية الضبط، يمكنك اختيار جهاز محاكاة Android؛ وإلا سيتم استخدام جهاز محاكاة Android الأول في القائمة. مصفوفة الأجهزة في مختبر Firebase الافتراضي - يمكنك الاطّلاع على إجراء اختباراتك باستخدام مختبر Firebase الافتراضي.
خيارات هدف النشر: استخدام الجهاز نفسه لعمليات الإطلاق المستقبلية	إذا أردت استخدام الجهاز الذي اخترته تلقائيًا من خلال مربع الحوار اختيار هدف النشر في المستقبل، ضَع علامة في هذا المربّع. وإذا لم يكن الجهاز متاحًا، سيظهر لك مربع حوار. القيمة التلقائية: غير محدّد
قبل الإطلاق	اطّلِع على تحديد عمليات Before Launch.

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

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

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

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

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

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

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

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

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

الحقل	الوصف
نوع تصحيح الأخطاء	اختر أحد الخيارين التاليين: Java فقط: لتصحيح أخطاء رمز Java فقط الرصد التلقائي: يتيح هذا الخيار لـ "استوديو Android" اختيار أفضل نوع تصحيح أخطاء لمشروعك. المحلية فقط: لتصحيح أخطاء الرموز البرمجية المحلية المكتوبة بلغة C أو ++C وضع التصحيح المزدوج (Java + الرمز الأصلي): لتصحيح أخطاء رموز Java والرموز البرمجية الأصلية في جلستَي تصحيح أخطاء منفصلتَين يُنصح باستخدام الخيار الرصد تلقائيًا لأنّه يختار نوع تصحيح الأخطاء المناسب لمشروعك.
أدلة الرموز	إذا أردت إضافة ملفات رموز لتزويد مصحّح الأخطاء بمعلومات C أو C++ تم إنشاؤها خارج "استوديو Android"، يمكنك إضافة دليل واحد أو أكثر هنا. يستخدم "استوديو Android" بشكل تفضيلي أي ملفات ضمن هذه الدلائل بدلاً من الملفات التي ينشئها المكوّن الإضافي لنظام Android المتوافق مع Gradle. يبحث مصحّح الأخطاء في الدلائل من الأعلى إلى الأسفل، بالترتيب، إلى أن يعثر على ما يحتاج إليه. يبحث بشكل متكرر في الملفات الموجودة في الدليل. لتحسين القائمة وتوفير الوقت، ضَع الأدلة الأكثر استخدامًا في أعلى القائمة. في حال تحديد دليل في أعلى الشجرة، قد يستغرق البحث في جميع الدلائل الفرعية وقتًا أطول. إذا أضفت دليلًا محدّدًا جدًا، سيستغرق البحث وقتًا أقل. عليك تحقيق التوازن المناسب بين السرعة والعثور على الملفات التي تحتاج إليها لتصحيح الأخطاء. على سبيل المثال، إذا كان لديك دليل يحتوي على أدلة فرعية لواجهات Android الثنائية (ABI) المختلفة، يمكنك اختيار إضافة دليل لواجهة 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 الخيارات التلقائية استنادًا إلى خبرة الفريق، لذا لن يكون بطيئًا جدًا ولكنه سيتضمّن المعلومات اللازمة لتحديد المشاكل وحلّها. ويُطلب غالبًا الحصول على السجلّ عند إرسال تقارير عن أخطاء في "استوديو 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" إعداد 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 بالوصول إلى كل من المضيف المحلي واسم المضيف. القيمة التلقائية: المضيف المحلي
منفذ الخادم	اكتب رقم المنفذ الذي تريد استخدامه للخادم. القيمة التلقائية: 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 مباشرةً باستخدام رمز الحاشية