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

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

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

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

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

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

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

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

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

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

لفتح مربّع الحوار "إعدادات التشغيل/التصحيح"، اختَر تشغيل > تعديل الإعدادات. يظهر مربّع الحوار Run/Debug Configurations (إعدادات التشغيل/التصحيح)، كما هو موضّح في الشكل 1.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    الشكل 2: حفظ الإعدادات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ترتيب الإعدادات وتجميعها

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

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

  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، باستثناء أنّ Android IDE ينفذ إعدادات التشغيل/تصحيح الأخطاء بغض النظر عن نتيجة الترجمة.
    إنشاء العناصر غير متاح في Android Studio.
    تنفيذ مهمة Gradle شغِّل إحدى مهام Gradle. في مربّع الحوار الذي يظهر، حدِّد التفاصيل ثم انقر على حسنًا. لمزيد من المعلومات، اطّلِع على Gradle.
    أداة الإنشاء المتوافقة مع Gradle اجمع المشروع وشغِّل Gradle.
    أداة إنشاء Gradle في App Engine تعمل مهمة أداة إنشاء Gradle في App Engine على مزامنة المشروع ثم إنشاء الوحدة.

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

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

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

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

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

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

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

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

    تطبيق Android

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

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

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

    الحقل الوصف
    الوحدة اختَر وحدة لتطبيق هذه الإعدادات عليها.
    خيارات التثبيت: النشر

    حدِّد خيارًا:

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

    ملاحظة: إذا كنت تريد اختبار تنزيل وحدات الميزات وتثبيتها عند الطلب، يجب إجراء ذلك بعد نشر حِزمة تطبيقك ثم استخدام مسار الاختبار الداخلي في Play Console. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تحميل حِزمة تطبيقك إلى Play Console.

    خيارات التثبيت: علامات التثبيت اكتب أي خيارات adb pm install تريد استخدامها. تنسيق الخيارات بالطريقة نفسها التي تستخدمها في سطر الأوامر، ولكن بدون مسار في ما يلي بعض الأمثلة:

    -i foo.bar.baz -r /path/to/apk

    و

    -d -r

    الإعداد التلقائي: ما مِن خيارات.

    خيارات الإطلاق: الإطلاق

    حدِّد خيارًا:

    • بدون إجراء: لا يتم تشغيل أي تطبيق عند اختيار تشغيل أو تصحيح الأخطاء. ومع ذلك، إذا كان تطبيقك قيد التشغيل واخترت تصحيح الأخطاء، يمرن "استوديو Android" IDE أداة تصحيح الأخطاء بمعالجة تطبيقك.
    • النشاط التلقائي: يمكنك تشغيل النشاط الذي وضعت علامة عليه كنشاط بدء في البيان. مثلاً:
      <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.

    خيارات الإطلاق: علامات الإطلاق اكتب أي خيارات adb am start تريد استخدامها. يمكنك تنسيق الخيارات بالطريقة نفسها التي تستخدمها في سطر الأوامر، ولكن بدون نية. مثلاً:

    -W

    لا يظهر هذا الخيار إذا اخترت قيمة التشغيل بدون إجراء.

    الإعداد التلقائي: ما مِن خيارات.

    خيارات استهداف النشر: الاستهداف

    حدِّد خيارًا:

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

    خيارات استهداف النشر: استخدام الجهاز نفسه لعمليات الإطلاق المستقبلية

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

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

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

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

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

    يعمل هذا الخيار مع الخيار السابق الذي يتحكّم في ما إذا كان سيتم تثبيت حزمة APK أم لا. بالنسبة إلى حقلَي خيارات التثبيت ، اتركهما على الإعداد التلقائي ما لم تكن تريد فرض تثبيت في كل مرة.

    في بعض الحالات، قد تحتاج إلى إلغاء اختيار هذا الخيار. على سبيل المثال، إذا كنت تكتب باستخدام محرك أسلوب إدخال (IME)، يؤدي إيقاف التطبيق بشكلٍ قسري إلى إلغاء اختياره كأحد لوحات المفاتيح الحالية، وهو ما قد لا تريده.

    الإعداد التلقائي: محدّد

    قبل الإطلاق راجِع تحديد عمليات ما قبل الإطلاق.

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

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

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

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

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

    اطّلِع على مقالة تصحيح أخطاء التطبيق للحصول على مزيد من المعلومات حول تصحيح الأخطاء في Android Studio.

    الحقل الوصف
    نوع تصحيح الأخطاء

    حدِّد أحد الخيارات التالية:

    • Java فقط: تصحيح أخطاء رمز Java فقط
    • الاكتشاف التلقائي: يمكنك السماح لخدمة "استوديو Android" باختيار أفضل نوع لتصحيح الأخطاء لمشروعك.
    • الرمز البرمجي الأصلي فقط: تصحيح أخطاء الرمز البرمجي الأصلي باللغة C أو C++
    • مزدوج (Java + رمز أصلي): يمكنك تصحيح أخطاء Java والرمز الأصلي في جلستَي تصحيح أخطاء منفصلتَين.

    ننصحك باستخدام الخيار الرصد تلقائيًا لأنّه يختار نوع تصحيح الأخطاء المناسب لمشروعك.

    أدلة الرموز

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

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

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

    أوامر بدء تشغيل LLDB

    أضِف أوامر LLDB التي تريد تنفيذها قبل أن ينضم مصحِّح الأخطاء إلى العملية. على سبيل المثال، يمكنك تحديد إعدادات للبيئة، كما هو موضّح في العبارة التالية:

    settings set target.max-memory-read-size 2048

    تنفِّذ LLDB الأوامر بالترتيب من الأعلى إلى الأسفل.

    أوامر LLDB Post Attach

    أضِف أوامر LLDB التي تريد تنفيذها مباشرةً بعد تثبيت مصحِّح الأخطاء على العملية. مثلاً:

    process handle SIGPIPE -n true -p true -s false

    تنفِّذ LLDB الأوامر بالترتيب من الأعلى إلى الأسفل.

    دليل العمل الخاص بالمضيف حدِّد دليل عمل LLDB.
    التسجيل: القنوات المستهدَفة

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

    lldb process:gdb-remote packets

    يمكنك تغيير الإعداد التلقائي لجمع المزيد من المعلومات. على سبيل المثال، تجمع خيارات السجلّ التالية معلومات عن platform معيّن:

    lldb process platform:gdb-remote packets

    للحصول على قائمة كاملة بتسجيل الطلبات، أدخِل الأمر log list من نافذة shell في LLDB في "استوديو Android".

    يضع Android Studio سجلات الجهاز في الموقع التالي، حيث يكون ApplicationId هو معرّف التطبيق الفريد المستخدَم في بيان حزمة APK المُنشأة، ويحدِّد تطبيقك على جهازك وفي "متجر Google Play":

    /data/data/ApplicationId/lldb/log

    أو إذا كان هناك عدة مستخدمين يصلون إلى جهاز، يتم وضع السجلّات في الموقع التالي، حيث يكون AndroidUserId معرّفًا فريدًا لمستخدم على الجهاز:

    /data/user/AndroidUserId/ApplicationId/lldb/log

    للحصول على معلومات عن استخدام LLDB لتصحيح الأخطاء عن بُعد، يُرجى الاطّلاع على مقالة تصحيح الأخطاء عن بُعد.

    قبل الإطلاق راجِع مقالة تحديد عمليات "قبل الإطلاق".

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

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

    اختبارات Android

    يعتمد نموذج الاختبار الذي يجب استخدامه على مجموعة المصادر. نموذج اختبارات أدوات قياس الأداء في Android مخصّص لاختبار أدوات قياس الأداء. نموذج JUnit لنظام التشغيل Android مخصّص لاختبار الوحدة على الجهاز.

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

    تتناول أوصاف علامات التبويب التالية علامات التبويب والحقول الخاصة بنموذج اختبار Android Instrumented. للحصول على معلومات عن علامات التبويب والحقول لنموذج اختبار JUnit في Android، اطّلِع على صفحة IntelliJ Run/Debug Configuration: JUnit.

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

    في علامة التبويب الإعدادات العامة، يمكنك تحديد موقع الاختبار، ومسار تشغيل أداة الاختبار، وshell adb، وخيارات النشر.

    الحقل الوصف
    الوحدة اختَر وحدة لتطبيق هذه الإعدادات عليها.
    الاختبار

    في هذه المنطقة، حدِّد موقع الاختبارات التي تريد إجراؤها:

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

    اكتب أي خيارات adb am instrument تريد استخدامها. لا تكتب المكوّن. على سبيل المثال، إذا كنت تستخدم AndroidJUnitRunner من AndroidX Test، يمكنك استخدام حقل هذا لتمرير خيارات إضافية إلى أداة التشغيل، مثل -e size small.

    الإعداد التلقائي: ما مِن خيارات

    خيارات استهداف النشر: الاستهداف

    حدِّد خيارًا:

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

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

    تحتوي علامة التبويب غير ذلك على logcat وخيارات التثبيت.

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

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

    يعمل هذا الخيار مع الخيار السابق الذي يتحكّم في ما إذا كان سيتم تثبيت حزمة APK أم لا. بالنسبة إلى حقلَي خيارات التثبيت ، اتركهما على الإعداد التلقائي ما لم تكن تريد فرض تثبيت في كل مرة.

    في بعض الحالات، قد تحتاج إلى إلغاء اختيار هذا الخيار. على سبيل المثال، إذا كنت تكتب باستخدام محرك أسلوب إدخال (IME)، يؤدي إيقاف التطبيق بشكلٍ قسري إلى إلغاء اختياره كأحد لوحات المفاتيح الحالية، وهو ما قد لا تريده.

    الإعداد التلقائي: محدّد

    قبل الإطلاق راجِع مقالة تحديد عمليات "قبل الإطلاق".

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

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

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

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

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

    اطّلِع على مقالة تصحيح أخطاء التطبيق للحصول على مزيد من المعلومات حول تصحيح الأخطاء في Android Studio.

    الحقل الوصف
    نوع تصحيح الأخطاء

    حدِّد أحد الخيارات التالية:

    • Java فقط: تصحيح أخطاء رمز Java فقط
    • الاكتشاف التلقائي: يمكنك السماح لخدمة "استوديو Android" باختيار أفضل نوع لتصحيح الأخطاء لمشروعك.
    • الرمز البرمجي الأصلي فقط: تصحيح أخطاء الرمز البرمجي الأصلي باللغة C أو C++
    • مزدوج (Java + رمز أصلي): يمكنك تصحيح أخطاء Java والرمز الأصلي في جلستَي تصحيح أخطاء منفصلتَين.

    ننصحك باستخدام الخيار الرصد تلقائيًا لأنّه يختار نوع تصحيح الأخطاء المناسب لمشروعك.

    أدلة الرموز

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

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

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

    أوامر بدء تشغيل LLDB

    أضِف أوامر LLDB التي تريد تنفيذها قبل أن ينضم مصحِّح الأخطاء إلى العملية. على سبيل المثال، يمكنك تحديد إعدادات للبيئة، كما هو موضّح في العبارة التالية:

    settings set target.max-memory-read-size 2048

    تنفِّذ LLDB الأوامر بالترتيب من الأعلى إلى الأسفل.

    أوامر LLDB Post Attach

    أضِف أوامر LLDB التي تريد تنفيذها مباشرةً بعد تثبيت مصحِّح الأخطاء على العملية. مثلاً:

    process handle SIGPIPE -n true -p true -s false

    تنفِّذ LLDB الأوامر بالترتيب من الأعلى إلى الأسفل.

    دليل العمل الخاص بالمضيف حدِّد دليل عمل LLDB.
    التسجيل: القنوات المستهدَفة

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

    lldb process:gdb-remote packets

    يمكنك تغيير الإعداد التلقائي لجمع المزيد من المعلومات. على سبيل المثال، تجمع خيارات السجلّ التالية معلومات عن platform معيّن:

    lldb process platform:gdb-remote packets

    للحصول على قائمة كاملة بتسجيل الطلبات، أدخِل الأمر log list من نافذة shell في LLDB في "استوديو Android".

    يضع Android Studio سجلات الجهاز في الموقع التالي، حيث يكون ApplicationId هو معرّف التطبيق الفريد المستخدَم في بيان حزمة APK المُنشأة، ويحدِّد تطبيقك على جهازك وفي "متجر Google Play":

    /data/data/ApplicationId/lldb/log

    أو إذا كان هناك عدة مستخدمين يصلون إلى جهاز، يتم وضع السجلّات في الموقع التالي، حيث يكون AndroidUserId معرّفًا فريدًا لمستخدم على الجهاز:

    /data/user/AndroidUserId/ApplicationId/lldb/log

    للحصول على معلومات عن استخدام LLDB لتصحيح الأخطاء عن بُعد، يُرجى الاطّلاع على مقالة تصحيح الأخطاء عن بُعد.

    قبل الإطلاق راجِع مقالة تحديد عمليات "قبل الإطلاق".

    App Engine DevAppServer

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

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

    الحقل الوصف
    نسخة واحدة فقط إذا كنت تريد التأكّد من تنفيذ مثيل واحد فقط من إعدادات التشغيل/تصحيح الأخطاء حاليًا، حدِّد هذا الخيار. ولا يسمح بتنفيذ عمليات متعددة للإعداد نفسه في الوقت نفسه. الإعداد التلقائي: محدّد
    الوحدة اختَر وحدة لتطبيق هذه الإعدادات عليها.
    المزامنة مع إعدادات build.gradle في حال إضافة وحدة App Engine ومزامنتها مع ملف build.gradle ، ستتم تعبئة حقول إعدادات App Engine DevAppServer نيابةً عنك (إجراء يُنصح به). يؤدي اختيار ملف > مزامنة المشروع مع ملفات Gradle إلى مزامنة المشروع أيضًا. الإعداد التلقائي: محدّد
    حزمة تطوير البرامج (SDK) لـ App Engine اكتب مسارًا إلى حزمة تطوير البرامج (SDK) لـ Google App Engine لنظام Java على الجهاز المحلي. انقر على ... لاختياره من مربّع حوار.
    War Path اكتب مسارًا إلى دليل "أرشيف تطبيق الويب" (WAR) للتطبيق الذي يتم نشره على خادم التطوير المحلي. انقر على ... لاختياره من مربّع حوار.
    VM Args

    حدِّد خيارات سطر الأوامر التي تريد تمريرها إلى الجهاز الافتراضي لبدء DevAppServer. عند تحديد الخيارات:

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

    لمزيد من المعلومات عن خيارات آلة افتراضية، اطّلِع على مستندات إصدار J2SE، مثل java JDK 7 وjava JDK 8.

    الإعداد التلقائي: لا تتوفّر خيارات.

    عنوان الخادم اكتب عنوان المضيف المراد استخدامه للخادم. قد تحتاج إلى تقديم العنوان لتتمكّن من الوصول إلى خادم التطوير من جهاز كمبيوتر آخر على شبكتك. يسمح العنوان 0.0.0.0 بالوصول إلى المضيف المحلي واسم المضيف. الإعداد التلقائي: localhost
    منفذ الخادم أدخِل رقم المنفذ المراد استخدامه للخادم. الإعداد التلقائي: 8080
    إيقاف ميزة "البحث عن تحديثات حزمة تطوير البرامج (SDK) لمحرك التطبيقات" في حال توفّر هذا الخيار، لن يتواصل خادم التطوير مع App Engine للتحقّق من توفّر إصدار جديد من IDE. يتحقّق الخادم تلقائيًا من توفّر إصدار جديد عند بدء التشغيل، ويطبع رسالة إذا كان هناك إصدار جديد متاحًا.
    قبل الإطلاق راجِع مقالة تحديد عمليات "قبل الإطلاق".

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

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

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

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

    زر التشغيل في الشريط الجانبي بجانب فئة WatchFaceService
    الشكل 1. تشغيل واجهة Wear OS مباشرةً باستخدام رمز الفاصل