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

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

لمزيد من المعلومات، يُرجى الاطّلاع أيضًا على وثائق IntelliJ التالية:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

حدد تهيئة لعنصر ما في المشروع

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

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

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

    الشكل 2. حفظ الضبط

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

من خلال تحديد تهيئة اختبار لفئة أو طريقة

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

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

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

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

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

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

    الشكل 3. حفظ الضبط

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    نماذج الضبط

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

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

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

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

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

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

    يخزِّن "استوديو 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.

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

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

    و

    -d -r

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

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

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

    • لا شيء: لا تبدأ تشغيل أي شيء عند اختيار تشغيل أو تصحيح الأخطاء. ومع ذلك، إذا كان تطبيقك قيد التشغيل واخترت تصحيح الأخطاء، سيربط Android Studio برنامج تصحيح الأخطاء بعملية التطبيق.
    • النشاط الافتراضي - يمكنك إطلاق النشاط الذي وضعت علامة عليه كنشاط بدء في ملف البيان. مثلاً:
      <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
      
    • النشاط المحدّد: يمكنك إطلاق نشاط معيّن على التطبيقات في وحدتك. عند اختيار هذا الحقل، سيظهر حقل النشاط أدناه، حيث يمكنك كتابة اسم النشاط الذي تريد إطلاقه، أو النقر على المزيد لاختيار نشاط من قائمة.
    • عنوان URL: يمكنك إطلاق عنوان URL يطابق أحد فلاتر الأهداف في بيان تطبيقك. عند اختيار عنوان URL، سيظهر الحقل عنوان URL أدناه، حيث يمكنك إدخال عنوان URL.

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

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

    -W

    لا يظهر هذا الخيار إذا اخترت قيمة Launch (إطلاق) لـ Nothing (لا شيء).

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

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

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

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

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

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

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

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

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

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

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

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

    الخيار التلقائي: تم اختياره

    قبل الإطلاق راجع التعريف قبل الإطلاق.

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

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

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

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

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

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

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

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

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

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

    دلائل الرموز

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

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

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

    /data/data/ApplicationId/lldb/log

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

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

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

    قبل الإطلاق راجع التعريف قبل عمليات الإطلاق.

    علامة تبويب إنشاء الملفات التعريفية

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

    اختبارات Android

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    الخيار التلقائي: تم اختياره

    قبل الإطلاق راجع التعريف قبل عمليات الإطلاق.

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

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

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

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

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

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

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

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

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

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

    دلائل الرموز

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

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

    يضع "استوديو Android" سجلات الأجهزة في الموقع التالي، حيث إن 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" إعدادات App Engine DevAppServer من أجلك.

    تجدر الإشارة إلى أنّ نموذج App Engine Server IntellJ IDEA هو نموذج مختلف غير متوفّر في "استوديو Android".

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

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

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

    ولمزيد من المعلومات حول خيارات الأجهزة الافتراضية، يُرجى الاطّلاع على المستندات الخاصة بإصدار J2SE، مثل java JDK 7 وjava JDK 8.

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

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

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

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

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

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

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