عند تشغيل الرمز أو تصحيح الأخطاء أو اختباره، يستخدم "استوديو Android" إعدادات التشغيل/تصحيح الأخطاء لتحديد كيفية تنفيذ العملية. تكون عادةً الإعدادات التي تم إنشاؤها في البداية كافية لتشغيل تطبيق أو تصحيح أخطائه. ومع ذلك، يمكنك تعديل إعدادات جديدة وإنشاؤها، وكذلك تعديل نماذج الإعدادات لتناسب عملية التطوير كما هو موضّح في هذه الصفحة.
للحصول على مزيد من المعلومات، يُرجى الاطّلاع أيضًا على وثائق IntelliJ التالية:
لمحة عن إعدادات التشغيل/تصحيح الأخطاء
تحدد عمليات تهيئة التشغيل/تصحيح الأخطاء تفاصيل مثل خيارات تثبيت التطبيق وإطلاقه واختباره. يمكنك تحديد إعداد للاستخدام لمرة واحدة، أو حفظه للاستخدام في المستقبل. بعد حفظه، يمكنك اختيار التهيئة من القائمة المنسدلة تحديد تشغيل/تصحيح الأخطاء ضمن شريط الأدوات. يحفظ "استوديو Android" الإعدادات كجزء من المشروع.
إعدادات التشغيل/تصحيح الأخطاء التي تم إنشاؤها في البداية
عند إنشاء مشروع لأول مرة، يُنشئ "استوديو Android" إعدادات التشغيل/تصحيح الأخطاء للنشاط الرئيسي استنادًا إلى نموذج تطبيق Android. لتشغيل مشروعك أو تصحيح أخطائه، يجب دائمًا تحديد إعداد تشغيل/تصحيح أخطاء واحد على الأقل. ولهذا السبب، ننصح بعدم حذف الإعدادات التي تم إنشاؤها في البداية.
نطاق المشروع والتحكم في الإصدار
تنطبق إعدادات التشغيل/تصحيح الأخطاء وتغييرات النموذج على المشروع الحالي فقط. يمكنك مشاركة إعدادات التشغيل أو تصحيح الأخطاء (وليس نموذجًا) من خلال نظام التحكّم في الإصدار. لمزيد من المعلومات حول كيفية مشاركة إعداد، راجِع خيارات ضبط الاسم والمشاركة.
فتح مربع حوار إعدادات التشغيل/تصحيح الأخطاء
لفتح مربع حوار تشغيل/تصحيح الإعدادات، حدد تشغيل > تعديل الإعدادات. سيظهر مربع الحوار عمليات ضبط التشغيل/تصحيح الأخطاء، كما هو موضّح في الشكل 1.
الشكل 1. مربّع الحوار إعدادات التشغيل/تصحيح الأخطاء
تعمل اللوحة اليمنى لمربّع الحوار على تجميع الإعدادات التي حدّدتها حسب نوع النموذج، وتسمح لك بتعديل نماذج الضبط في أسفل الصفحة. يمكنك تعديل الإعدادات المحدَّدة في اللوحة اليسرى. غيّر حجم مربع الحوار للاطلاع على أي عناصر مخفية.
في مربّع الحوار هذا، يمكنك إجراء ما يلي:
- إنشاء عمليات ضبط جديدة للتشغيل/تصحيح الأخطاء
- تعديل إعدادات التشغيل/تصحيح الأخطاء:
- تعديل نماذج الضبط.
- الترتيب وإعداد المجموعات:
إنشاء إعدادات جديدة للتشغيل/تصحيح الأخطاء
يمكنك تحديد عمليات ضبط جديدة للتشغيل/تصحيح الأخطاء من مربّع الحوار إعدادات التشغيل/تصحيح الأخطاء أو نافذة المشروع أو "محرِّر الرموز". يجب أن تستند الإعدادات الجديدة إلى نموذج ضبط.
يعرض مربّع حوار "عمليات ضبط التشغيل/تصحيح الأخطاء" عمليات ضبط التشغيل/تصحيح الأخطاء ونماذج الضبط المتاحة. يمكنك بدء تهيئة جديدة مباشرةً من نموذج أو من نسخة من تهيئة أخرى. يمكنك بعد ذلك تغيير قيم الحقول حسب الحاجة.
بدلاً من ذلك، يمكنك النقر بزر الماوس الأيمن على عنصر في نافذة المشروع لإنشاء إعدادات خاصة بهذا العنصر تلقائيًا. على سبيل المثال، إذا أردت تشغيل نشاط معيّن، يمكنك النقر بزر الماوس الأيمن على ملف "النشاط Java" واختيار تشغيل. استنادًا إلى العنصر، يستخدم "استوديو Android" نموذج الإعداد تطبيق Android أو اختبارات آلة نظام Android أو JUnit لإنشاء الإعدادات.
في "محرِّر الرموز"، يمكنك بسهولة إنشاء إعدادات اختبار وتشغيل/تصحيح الأخطاء لفئة أو طريقة، ثم تنفيذها.
عند إنشاء تهيئة خارج مربع حوار تشغيل/تصحيح الأخطاء، تكون التهيئة مؤقتة ما لم تحفظها. بشكل تلقائي، يمكنك إجراء ما يصل إلى خمس إعدادات مؤقتة في المشروع قبل أن يبدأ "استوديو Android" في إزالتها. لتغيير هذا الإعداد التلقائي، افتح إعدادات "استوديو Android" وغيِّر الإعدادات المتقدّمة > تشغيل/تصحيح الأخطاء > الحدّ الأقصى لعمليات الضبط المؤقتة. للمزيد من المعلومات عن عمليات الضبط المؤقتة، يُرجى الاطّلاع على إنشاء إعدادات التشغيل/تصحيح الأخطاء المؤقتة وحفظها.
بدء عملية ضبط استنادًا إلى نموذج
لتحديد عملية ضبط تشغيل/تصحيح الأخطاء استنادًا إلى نموذج، اتّبِع الخطوات التالية:
- افتح مربّع حوار "إعدادات التشغيل/تصحيح الأخطاء".
- انقر على إضافة إعدادات جديدة
.
- اختَر نموذج ضبط.
- اكتب اسمًا في الحقل الاسم.
- عدِّل الإعدادات حسب الحاجة.
- انقر على تطبيق أو حسنًا.
تأكَّد من تصحيح أي أخطاء تظهر في أسفل مربّع الحوار.
بدء عملية ضبط من نسخة
لتحديد ضبط تشغيل/تصحيح الأخطاء بدءًا من نسخة من عملية ضبط أخرى، اتّبِع الخطوات التالية:
- افتح مربّع حوار "إعدادات التشغيل/تصحيح الأخطاء".
- اختَر إعدادًا حاليًا للتشغيل/تصحيح الأخطاء في اللوحة اليمنى.
- انقر على رمز نسخ الإعداد
.
- اكتب اسمًا في الحقل الاسم.
- عدِّل الإعدادات حسب الحاجة.
- انقر على تطبيق أو حسنًا.
تأكَّد من تصحيح أي أخطاء تظهر في أسفل مربّع الحوار.
تحديد تهيئة لعنصر في المشروع
يمكن أن ينشئ "استوديو Android" إعدادات تشغيل/تصحيح الأخطاء لبعض العناصر المعروضة في نافذة المشروع. تستند عملية الضبط إلى نموذج ضبط على النحو التالي:
- ملف Java للنشاط: نموذج تطبيق Android.
- الحزمة: اختبارات Android Widget أو نموذج Android JUnit حسب مجموعة المصادر إذا اخترت اختبار قياس حالة التطبيق، سيتم استخدام نموذج "اختبارات الأدوات المستندة إلى Android". إذا اختَرت اختبار وحدة محلية، سيتم استخدام نموذج Android JUnit. بالنسبة إلى اختبار وحدة محلية، يمكنك إجراؤها اختياريًا من خلال تغطية الرمز البرمجي لمزيد من المعلومات، يُرجى الاطّلاع على تغطية الرموز.
لإنشاء تهيئة تشغيل/تصحيح الأخطاء لعنصر في مشروعك، اتبع الخطوات التالية:
- افتح مشروعًا في Android أو Project View.
- في نافذة المشروع، انقر بزر الماوس الأيمن على عنصر قابل للاختبار واختَر تشغيل filename أو تصحيح الأخطاء filename. يُنشئ "استوديو Android" إعدادات مؤقتة للتشغيل/تصحيح الأخطاء، ويطلق تطبيقك.
- افتح القائمة المنسدلة اختيار إعداد/تصحيح الأخطاء في شريط الأدوات.
- اختَر حفظ الإعداد من الخيارات بجانب الإعدادات التي تريد حفظها.
الشكل 2. حفظ الإعدادات
ملاحظة: إذا نقرت بزر الماوس الأيمن على العنصر نفسه وشغّلته أو تصحيح الأخطاء فيه (وليس نشاطًا)، سيتم إنشاء إعدادات جديدة من خلال "استوديو Android".
حدِّد تهيئة اختبارية لفئة أو طريقة
يتيح لك "استوديو Android" تحديد إعدادات إجراء اختبار لفئة أو طريقة، ثم تنفيذها. على سبيل المثال، إذا أنشأت صفًا جديدًا، يمكنك إنشاء وإجراء اختبار له. إذا تم اجتياز الاختبار، يمكنك إجراء الاختبارات لبقية المشروع للتأكد من أن الكود الجديد لا يعطل أي شيء في أي مكان آخر.
ويستخدم "استوديو Android" نموذج اختبارات Android Widgets أو Android JUnit، استنادًا إلى مجموعة المصادر. بالنسبة إلى اختبار الوحدة المحلية، يمكنك إجراء ذلك اختياريًا من خلال تغطية الرمز.
لإنشاء تهيئة تشغيل/تصحيح الأخطاء لفئة أو طريقة في رمز Java، اتبع الخطوات التالية:
- افتح مشروعًا في Android أو Project View.
- افتح ملف Java في "محرِّر الرموز البرمجية".
- حدد فئة أو طريقة في التعليمة البرمجية، ثم اضغط على Control+Shift+T (Command+Shift+T).
- اختر إنشاء اختبار جديد من القائمة التي تظهر.
- في مربّع الحوار إنشاء اختبار، يمكنك تغيير القيم أو ضبطها اختياريًا ثم النقر على حسنًا.
- في مربّع الحوار اختيار دليل الوجهة، اختَر المكان الذي تريد أن يجري فيه "استوديو Android" الاختبار في المشروع. ويمكنك تحديد الموقع الجغرافي حسب بنية الدليل أو من خلال اختيار فئة مجاورة.
- انقر على حسنًا.
يظهر الاختبار الجديد في نافذة مشروع في مجموعة مصادر الاختبار المقابلة.
- لإجراء الاختبار، نفِّذ أحد الإجراءات التالية:
- في نافذة المشروع، انقر بزر الماوس الأيمن على الاختبار واختَر تشغيل أو تصحيح الأخطاء.
- في "أداة تعديل الرموز"، انقر بزر الماوس الأيمن على تعريف فئة أو اسم طريقة في ملف الاختبار، واختَر تشغيل أو تصحيح الأخطاء لاختبار جميع الطرق في الفئة.
- افتح القائمة المنسدلة اختيار إعداد/تصحيح الأخطاء في شريط الأدوات.
- اختَر حفظ الإعداد من الخيارات بجانب الإعدادات التي تريد حفظها.
الشكل 3. حفظ الإعدادات
تشغيل تطبيق أو تصحيح الأخطاء فيه باستخدام إعدادات محفوظة
إذا حفظت إعدادات التشغيل/تصحيح الأخطاء، يمكنك اختيارها قبل تشغيل التطبيق أو تصحيح الأخطاء فيه.
لاستخدام إعدادات تشغيل/تصحيح أخطاء محفوظة، اتّبِع الخطوات التالية:
- اختَر إعداد التشغيل/تصحيح الأخطاء من القائمة المنسدلة اختيار إعداد التشغيل/تصحيح الأخطاء ضمن شريط الأدوات.
- اختَر تشغيل > تشغيل أو تشغيل > تصحيح الأخطاء.
تقع القائمة المنسدلة على يمين Run
وDebug
،
على سبيل المثال،
.
بدلاً من ذلك، انقر على تشغيل أو تصحيح الأخطاء
.
تعديل إعدادات التشغيل/تصحيح الأخطاء
لتعديل إعدادات التشغيل/تصحيح الأخطاء، اتّبِع الخطوات التالية:
- افتح مربّع حوار "إعدادات التشغيل/تصحيح الأخطاء".
- اختَر إعدادات في اللوحة اليمنى.
- عدِّل الإعدادات حسب الحاجة.
- انقر على تطبيق أو حسنًا.
تأكَّد من تصحيح أي أخطاء تظهر في أسفل مربّع الحوار.
تعديل نموذج ضبط تشغيل/تصحيح الأخطاء
يمكنك تعديل نماذج الضبط التي يوفّرها "استوديو Android" لتناسب عملية التطوير. عند تعديل نموذج، لا يؤثر ذلك في الإعدادات الحالية التي تستخدم النموذج. لذلك، على سبيل المثال، إذا كنت بحاجة إلى إنشاء عدد من عمليات التهيئة من نوع معين، فيمكنك تحرير القالب ثم تغييره مرة أخرى عند الانتهاء.
على الرغم من أنّه لا يمكنك إنشاء نماذج جديدة، يمكنك إنشاء عمليات ضبط لاستخدامها بشكل مشابه للنموذج. يمكنك نسخ إعداد وتعديل النسخة لإنشاء عمليات ضبط جديدة.
لتعديل نموذج، اتبع الخطوات التالية:
- افتح مربّع حوار "إعدادات التشغيل/تصحيح الأخطاء".
- انقر على تعديل نماذج الضبط....
- اختَر نموذج ضبط.
- عدِّل الإعدادات حسب الحاجة.
- انقر على تطبيق أو حسنًا.
تأكَّد من تصحيح أي أخطاء تظهر في أسفل مربّع الحوار.
فرز تكوينات المجموعة
في مربع الحوار إعدادات التشغيل/تصحيح الأخطاء، يمكنك ترتيب عمليات الضبط للعثور عليها بسرعة. يمكنك فرز العناصر في المجلد أبجديًا، وإنشاء مجلدات جديدة لتجميع عمليات التهيئة.
لترتيب الإعدادات أبجديًا، اتّبِع الخطوات التالية:
- افتح مربّع حوار "إعدادات التشغيل/تصحيح الأخطاء".
- اختَر مجلدًا يحتوي على عمليات ضبط.
- انقر على ترتيب الإعدادات
.
- انقر على حسنًا لإغلاق مربّع الحوار.
لتجميع الإعدادات في المجلدات، اتّبِع الخطوات التالية:
- افتح مربّع حوار "إعدادات التشغيل/تصحيح الأخطاء".
- اختَر مجلدًا يحتوي على عمليات ضبط.
- انقر على إنشاء مجلد جديد
.
- اكتب اسمًا في حقل اسم المجلد.
- انقر على تطبيق لحفظ الاسم.
تحديد عمليات ما قبل الإطلاق
يمكنك تحديد المهام المطلوب تنفيذها قبل تطبيق إعداد التشغيل/تصحيح الأخطاء. يتم تنفيذ المهام بالترتيب الذي تظهر به في القائمة.
ملاحظة: يُعدّ تحديد المهام قبل الإطلاق ميزة متقدّمة. وبدلاً من
استخدام هذه الميزة، ننصحك بإضافة أي منطق تحضيري كمهام في ملف
build.gradle
الخاص بك، ليتم تنفيذها عند الإنشاء من سطر الأوامر.
لإنشاء قائمة مهام، اتبع الخطوات التالية:
- في أسفل مربّع الحوار إعدادات التشغيل/تصحيح الأخطاء ضمن قبل الإطلاق
(قد تحتاج إلى الانتقال للأسفل)،
انقر على إضافة
واختَر نوع مهمّة. إذا ظهر مربع حوار، املأ الحقول وانقر على حسنًا.
- يمكنك إضافة المزيد من المهام حسب الحاجة.
- لترتيب المهام، اسحبها أو اختَر مهمة وانقر على السهم المتّجه للأعلى
والسهم المتّجه للأسفل
لنقلها للأعلى أو للأسفل في القائمة.
- اختَر إظهار هذه الصفحة إذا كنت تريد عرض إعدادات ضبط التشغيل/تصحيح الأخطاء قبل تطبيقها.
يتم إلغاء اختيار هذا الخيار تلقائيًا.
- اختَر نافذة الأداة النشطة إذا كنت تريد تفعيل نافذة أداة
التشغيل
أو
تصحيح الأخطاء
عند تشغيل تطبيقك أو تصحيح الأخطاء فيه.
ويتم تحديد هذا الخيار تلقائيًا.
لإزالة مهمة من القائمة، اتّبِع الخطوات التالية:
- اختَر مهمة.
- انقر على إزالة
.
لتعديل مهمة، اتبع الخطوات التالية:
- اختَر مهمة.
- النقر على رمز التعديل
- عدِّل إعدادات المهمة في مربّع الحوار الذي يفتح، ثم انقر على حسنًا.
يسرد الجدول التالي المهام المتاحة التي يمكنك إضافتها.
المهمة | الوصف |
---|---|
تشغيل الأداة الخارجية | يمكنك تشغيل تطبيق غير متوافق مع "استوديو Android". في مربّع الحوار أدوات خارجية، اختَر تطبيقًا واحدًا أو أكثر تريد تشغيله، ثم انقر على حسنًا. إذا لم يكن التطبيق محدّدًا في "استوديو Android" بعد، يُرجى إضافة تعريفه في مربّع الحوار إنشاء أدوات. لمزيد من المعلومات، يُرجى الاطّلاع على ضبط الأدوات التابعة لجهات خارجية والأدوات الخارجية. |
تشغيل إعداد آخر | نفِّذ أحد إعدادات التشغيل/تصحيح الأخطاء الحالية. في مربع الحوار اختيار إعداد لتنفيذه، اختَر إعدادًا لتنفيذه، ثم انقر على حسنًا. |
إنشاء | قم بتجميع المشروع أو الوحدة. ينفِّذ "استوديو Android" أمر "إنشاء وحدة" إذا كان الإعداد "تشغيل/تصحيح الأخطاء" يحدّد وحدة معيّنة، أو ينفّذ أمر "إنشاء مشروع" إذا لم يتم تحديد أي وحدات. |
إنشاء مشروع | قم بتجميع المشروع. ينفِّذ "استوديو Android" أمر "إنشاء" في المشروع. |
التنفيذ، ما مِن أخطاء للتحقّق من الأخطاء | يشبه هذا الخيار Make، باستثناء أنّ "استوديو Android" ينفّذ إعدادات التشغيل/تصحيح الأخطاء بغض النظر عن نتيجة التجميع. |
بناء العناصر | غير متاح في "استوديو Android". |
تشغيل مهمة Gradle | قم بتشغيل مهمة Gradle. في مربع الحوار الذي سيظهر، حدِّد التفاصيل ثم انقر على حسنًا. لمزيد من المعلومات، يُرجى الاطّلاع على Gradle. |
التصميم المتوافق مع Gradle | قم بتجميع المشروع وتشغيل Gradle. |
أداة إنشاء Gradle لـ App Engine | تعمل مهمة إنشاء Gradle لـ App Engine على مزامنة المشروع ثم إنشاء الوحدة. |
نماذج الضبط
ويوفّر "استوديو Android" نماذج ضبط لمساعدتك على البدء بسرعة. توضّح الأقسام التالية النماذج التي تنطبق على تطوير تطبيقات Android باستخدام "استوديو Android":
- تطبيق Android
- اختبارات Android
- DevAppServer في App Engine
- الإضافة على Wear OS والمربّع وخلفية شاشة الساعة
ملاحظة: كان للإصدار 2.1.x من Android Studio والإصدارات الأقدم نموذج "تطبيق محلي" لا تتوفّر في الإصدارات الأحدث. إذا كان لديك نموذج تطبيق محلي في مشروع، سيحوّله "استوديو Android" إلى تطبيق Android عند تحميل المشروع. يرشدك مربع حوار تحويل المشروع خلال العملية.
نماذج غير متوافقة
تأتي النماذج التالية غير المتوافقة من IntelliJ IDEA، وهي ليست مخصّصة لتطوير Android باستخدام "استوديو Android". للحصول على معلومات حول استخدام هذه القوالب، اتبع الروابط إلى وثائق IntelliJ IDEA.
- التطبيق
- مجمّع
- أداة Gradle
- رائع
- تطبيق JAR
- Java Scratch
- JUnit
- Kotlin
- نص Kotlin
- تصحيح الأخطاء عن بُعد
- نص واجهة المستخدم
- اختبار NG
خيارات الضبط الشائعة
تعتبر الخيارات الاسم والسماح بالتشغيل الموازي والحفظ كملف مشروع شائعة في نماذج ضبط متعددة. للحصول على مزيد من المعلومات حول هذه الإعدادات، راجِع الإعدادات الشائعة.
يخزِّن "استوديو Android" إعدادات التشغيل/تصحيح الأخطاء المشتركة في ملفات XML الفردية ضمن مجلد project_directory/.idea/runConfigurations/
.
للمزيد من المعلومات، يُرجى الاطّلاع على التنسيق المستند إلى الدليل في مستندات مشاريع IntelliJ.
تطبيق Android
يمكنك تشغيل أو تصحيح الأخطاء لتطبيقات Android وأنشطته على الأجهزة الافتراضية أو الأجهزة باستخدام الإعدادات التي تستند إلى هذا النموذج.
علامة التبويب "إعدادات عامة"
في علامة التبويب الإعدادات العامة، يمكنك تحديد خيارات التثبيت والإطلاق والنشر. تحتوي علامة التبويب متنوعات أيضًا على خيارات التثبيت.
الحقل | الوصف |
---|---|
الوحدة | اختَر وحدة لتطبيق هذه الإعدادات عليها. |
خيارات التثبيت: نشر | حدِّد خيارًا:
|
خيارات التثبيت: نشر كتطبيق فوري | إذا كان تطبيقك يوفّر التجارب الفورية، أي يمكنك إضافة دعم للتطبيقات الفورية عند إنشاء مشروع جديد أو إنشاء وحدة أو أكثر من وحدات الميزات المفعَّلة بشكل فوري. يمكنك اختيار نشر تلك الوحدات التي تم تفعيل ميزة التطبيقات الفورية فيها من خلال وضع علامة في المربّع بجانب نشر كتطبيق فوري. |
خيارات التثبيت: الميزات المطلوب نشرها |
إذا كان تطبيقك يتضمّن
وحدات ميزات،
ضَع علامة في المربّع بجانب كل ميزة تريد تضمينها عند نشر تطبيقك. لن يظهر لك هذا الخيار إلا إذا كان تطبيقك يتضمّن وحدات ميزات.
ملاحظة: إذا أردت اختبار تنزيل وحدات الميزات وتثبيتها عند الطلب، عليك إجراء ذلك بعد نشر حِزمة التطبيق ثم استخدام مسار الاختبار الداخلي في Play Console. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تحميل حِزمة تطبيقك على Play Console. |
خيارات التثبيت: تثبيت العلامات | اكتب أي خيارات Adb pm
install تريد استخدامها. قم بتنسيق الخيارات بنفس الطريقة التي تستخدمها في
سطر الأوامر، ولكن بدون مسار. في ما يلي بعض الأمثلة:
و
الإعداد التلقائي: لا تتوفّر خيارات. |
خيارات الإطلاق: الإطلاق | حدِّد خيارًا:
|
خيارات الإطلاق: علامات الإطلاق | اكتب أي خيارات Adb am
start تريد استخدامها. قم بتنسيق الخيارات بنفس الطريقة التي تستخدمها في
سطر الأوامر، ولكن بدون النية. على سبيل المثال:
ولا يظهر هذا الخيار إذا اخترت قيمة إطلاق هي لا شيء. الإعداد التلقائي: لا تتوفّر خيارات. |
خيارات هدف النشر: الهدف | حدِّد خيارًا:
|
خيارات هدف النشر: استخدام الجهاز نفسه مع عمليات الإطلاق المستقبلية |
يتم إلغاء تحديد هذا الخيار تلقائيًا حتى يظهر لك مربّع الحوار اختيار النشر لاختيار جهاز في كل مرة يتم فيها تشغيل تطبيق. عند تحديد هذا الخيار ثم تشغيل تطبيق، سيظهر مربّع الحوار اختيار النشر لاختيار جهاز. وبعد ذلك،
يتم تشغيل التطبيق في كل مرة يتم فيها تشغيل التطبيق على الجهاز الذي اخترته بدون عرض
مربّع الحوار اختيار عملية نشر. لتشغيل التطبيق على جهاز مختلف، يمكنك إما إلغاء اختيار استخدام
الجهاز نفسه مع عمليات التشغيل المستقبلية أو إيقاف التطبيق من خلال تشغيل > إيقاف app
أو إيقاف ![]() |
قبل الإطلاق | راجع تحديد العمليات قبل الإطلاق. |
علامة تبويب متنوعة
في علامة التبويب متنوعات، يمكنك تحديد خيارات Logcat والتثبيت والتشغيل والنشر. تحتوي علامة التبويب عام على خيارات التثبيت أيضًا.
الحقل | الوصف |
---|---|
Logcat: عرض Logcat تلقائيًا | عند تحديد هذا الخيار، يتم فتح نافذة Logcat في كل مرة يتم فيها نشر تطبيق وإطلاقه بنجاح باستخدام هذه الإعدادات. الإعداد التلقائي: تم اختياره. |
Logcat: محو السجلّ قبل التشغيل | حدِّد هذا الخيار إذا كنت تريد من "استوديو Android" إزالة البيانات من الجلسات السابقة من ملف السجلّ قبل بدء تشغيل التطبيق. الخيار التلقائي: تم إلغاء اختياره. |
خيارات التثبيت: يمكنك تخطّي التثبيت في حال عدم تغيير حزمة APK. | عند تحديده، لا يعيد "استوديو Android" نشر ملف APK إذا اكتشف أنه لم يتم تغييره. إذا أردت أن يفرض "استوديو Android" تثبيت حزمة APK، حتى لو لم تتغير، ألغِ اختيار هذا الخيار. الإعداد التلقائي: تم اختياره |
خيارات التثبيت: فرض إيقاف تشغيل التطبيق قبل بدء النشاط | إذا تم تحديده، سيتم فرض إيقاف التطبيق حتى يبدأ التطبيق من نشاط مشغّل التطبيقات التلقائي إذا تم اكتشاف أنّه لا يجب إعادة تثبيت حزمة APK بسبب عدم تغييرها. وإذا تم إلغاء تحديد هذا الخيار، لن يفرض "استوديو Android" إيقاف التطبيق. يعمل هذا الخيار مع الخيار السابق الذي يتحكّم في ما إذا كان سيتم تثبيت حزمة APK أم لا. بالنسبة إلى كلا حقلَي خيارات التثبيت، اترُكهما على الإعداد التلقائي ما لم تكن تريد فرض عملية تثبيت بشكل صريح في كل مرة. وفي بعض الحالات، قد تحتاج إلى إلغاء تحديد هذا الخيار. على سبيل المثال، إذا كنت تكتب محرك أسلوب إدخال (IME)، فإن فرض إيقاف التطبيق يؤدي إلى إلغاء تحديده كلوحة المفاتيح الحالية، وهو الأمر الذي قد لا ترغب في شرائه. الإعداد التلقائي: تم اختياره |
قبل الإطلاق | راجع تحديد قبل إطلاق العمليات. |
علامة تبويب "برنامج تصحيح الأخطاء"
حدِّد خيارات تصحيح الأخطاء في علامة التبويب برنامج تصحيح الأخطاء.
بالنسبة إلى رمزَي C وC++ ، يستخدم "استوديو Android" برنامج تصحيح الأخطاء LLDB. بالإضافة إلى واجهة مستخدم "استوديو Android" العادية، تحتوي نافذة برنامج تصحيح الأخطاء على علامة تبويب LLDB تتيح لك إدخال أوامر LLDB أثناء تصحيح الأخطاء. يمكنك إدخال الأوامر نفسها التي يستخدمها "استوديو Android" لعرض المعلومات في واجهة مستخدم برنامج تصحيح الأخطاء، ويمكنك تنفيذ عمليات إضافية.
بالنسبة إلى مشاريع C وC++ ، يمكنك إضافة أدلة رموز، وكذلك أوامر بدء تشغيل LLDB ونشر أوامر إرفاق، في علامة التبويب Debugger. للقيام بذلك، يمكنك استخدام أزرار مشابهة لما يلي:
- إضافة
- لإضافة دليل أو أمر
- الإزالة
- اختَر دليلاً أو أمرًا، ثم انقر على هذا الزر لإزالة العنصر.
- السهم المتّجه للأعلى
- اختَر دليلاً أو أمرًا، ثم انقر على هذا الزر لنقل العنصر للأعلى في القائمة.
- السهم المتّجه للأسفل
- اختَر دليلاً أو أمرًا، ثم انقر على هذا الزر لنقل العنصر إلى أسفل القائمة.
راجِع صفحة تصحيح أخطاء التطبيق لمزيد من المعلومات حول تصحيح الأخطاء في "استوديو Android".
الحقل | الوصف |
---|---|
نوع تصحيح الأخطاء | حدِّد أحد الخيارات التالية:
يُنصح باستخدام الخيار الرصد تلقائيًا لأنّه يختار نوع تصحيح الأخطاء المناسب لمشروعك. |
دلائل الرموز | إذا كنت تريد إضافة ملفات رموز لتزويد برنامج تصحيح الأخطاء بمعلومات C أو C++ تم إنشاؤها خارج "استوديو Android"، يمكنك إضافة دليل واحد أو أكثر من هنا. ويفضّل "استوديو Android" استخدام أي ملفات ضِمن هذه الأدلة بدلاً من الملفات التي تم إنشاؤها باستخدام مكوّن Android الإضافي لنظام Gradle. يبحث برنامج تصحيح الأخطاء في الأدلة من أعلى إلى أسفل بالترتيب، حتى يعثر على ما يحتاج إليه. يبحث بشكل متكرر عبر الملفات في الدليل. لتحسين القائمة وتوفير الوقت، ضع الأدلة المستخدمة في كثير من الأحيان في أعلى القائمة. وإذا حددت دليلاً عاليًا في الشجرة، يمكن أن يستغرق البحث في جميع الأدلة الفرعية وقتًا أطول. إذا أضفت دليلاً محددًا جدًا، ستستغرق عملية البحث وقتًا أقل. تحتاج إلى إيجاد التوازن الصحيح بين السرعة والعثور على الملفات التي تحتاجها لتصحيح الأخطاء. على سبيل المثال، إذا كان لديك دليل يحتوي على أدلة فرعية لمختلف واجهات Android الثنائية (ABI)، يمكنك اختيار إضافة دليل لـ ABI محدّدين أو لجميع واجهات ABI. على الرغم من أن البحث في دليل المستوى الأعلى قد يستغرق وقتًا أطول، إلا أنه مضمون أكثر إذا قررت تصحيح الأخطاء على جهاز مختلف. وتجدر الإشارة إلى أنّه لا داعي لإضافة أدلة تحتوي على ملفات رموز Gradle لأن برنامج تصحيح الأخطاء يستخدمها تلقائيًا. |
أوامر بدء تشغيل LLDB | أضِف أوامر LLDB التي تريد تنفيذها قبل إرفاق برنامج تصحيح الأخطاء بالعملية. على سبيل المثال، يمكنك تحديد إعدادات البيئة كما هو موضح في الأمر التالي:
ينفذ LLDB الأوامر بالترتيب من أعلى إلى أسفل. |
أوامر إرفاق مشاركة LLDB | أضِف أوامر LLDB التي تريد تنفيذها بعد إرفاق برنامج تصحيح الأخطاء بالعملية مباشرةً. على سبيل المثال:
ينفذ LLDB الأوامر بالترتيب من أعلى إلى أسفل. |
استضافة دليل العمل | حدِّد دليل عمل LLDB. |
التسجيل: استهداف القنوات | حدِّد خيارات سجلّ LLDB. ويضبط Android Studio الخيارات التلقائية بناءً على تجربة الفريق، لذلك فهو لا يبطئ أداءه كثيرًا ولكنّه يحتوي على المعلومات المطلوبة لتحديد المشاكل وحلّها. وغالبًا ما يكون السجلّ مطلوبًا لتقارير الأخطاء في "استوديو Android" هذا الإعداد الافتراضي هو
ويمكنك تغيير الإعدادات التلقائية لجمع المزيد من المعلومات. على سبيل المثال، تجمع خيارات السجلّ التالية معلومات حول lldb process
platform:gdb-remote packets
للحصول على قائمة كاملة بأوامر السجلّ، أدخِل الأمر
يضع "استوديو Android" سجلات الجهاز في الموقع التالي، حيث
بدلاً من ذلك، في حال وصول عدة مستخدمين إلى جهاز، يتم وضع السجلّات في الموقع التالي، حيث يكون
للحصول على معلومات عن استخدام LLDB لتصحيح الأخطاء عن بُعد، راجع تصحيح الأخطاء عن بُعد. |
قبل الإطلاق | راجع تحديد العمليات قبل الإطلاق. |
علامة التبويب "إنشاء ملف شخصي"
يجب تحديد خيار تفعيل التحليل المتقدم لتفعيل ميزات معيّنة في برنامج تحليل إعدادات Android عندما يكون جهازك يعمل بإصدار 7.1 من نظام التشغيل Android أو إصدار أقدم.
اختبارات Android
ويعتمد نموذج الاختبار الذي عليك استخدامه على مجموعة المصدر. ويُعد نموذج "اختبارات قياس شاشة Android" مخصصًا لاختبار قياس حالة التطبيق. نموذج Android JUnit مخصّص لاختبار وحدة محلية.
ملاحظة: إذا كنت تستخدم مركز الاختبار الافتراضي لمنصة Firebase لإجراء اختبار على مجموعة متنوعة من الأجهزة، يمكنك استخدام نموذج Android JUnit لتحديد اختبارات الأدوات. لمزيد من المعلومات، يرجى الاطّلاع على إجراء الاختبارات باستخدام مركز الاختبار الافتراضي لمنصة Firebase.
تتناول الأوصاف التالية في علامات التبويب علامات التبويب والحقول الخاصة بنموذج اختبار Android Detected. للحصول على معلومات عن علامات التبويب والحقول في نموذج اختبار Android JUnit، يمكنك الاطّلاع على صفحة إعداد التشغيل/تصحيح الأخطاء من IntelliJ: JUnit.
علامة التبويب "إعدادات عامة"
في علامة التبويب الإعدادات العامة، يمكنك تحديد خيارات النشر والموقع الجغرافي للاختبار وأداة تشغيل الأدوات وأداة adb Shell.
الحقل | الوصف |
---|---|
الوحدة | اختَر وحدة لتطبيق هذه الإعدادات عليها. |
الاختبار | في هذه المنطقة، حدِّد موقع الاختبارات التي تريد إجراؤها:
|
أداة تشغيل أدوات محددة (اختياري) | اكتب موقع مشغّل الأدوات، وانقر على المزيد لاستخدام مربّع حوار. ويحدِّد ملف build.gradle موقع مشغّل الأدوات، وتتجاهله هذه القيمة. تكون الفئة التلقائية عادةً هي الفئة AndroidJUnitRunner
من AndroidX Test.
|
خيارات إضافية | اكتب أي خيارات Adb تلقائي: ما مِن خيارات |
خيارات هدف النشر: الهدف | حدِّد خيارًا:
|
خيارات هدف النشر: استخدام الجهاز نفسه مع عمليات الإطلاق المستقبلية | إذا كنت تريد أن يتم تلقائيًا استخدام الجهاز الذي اخترته من خلال مربّع الحوار اختيار هدف النشر في المستقبل، حدِّد هذا الخيار. إذا لم يكن الجهاز متاحًا، سيظهر لك مربّع حوار. الإعداد التلقائي: غير محدَّد |
قبل الإطلاق | راجع تحديد العمليات قبل الإطلاق. |
علامة تبويب متنوعة
تتضمّن علامة التبويب متنوعات سجلّ Logcat وخيارات التثبيت.
الحقل | الوصف |
---|---|
Logcat: محو السجلّ قبل التشغيل | حدِّد هذا الخيار إذا كنت تريد من "استوديو Android" إزالة البيانات من الجلسات السابقة من ملف السجلّ قبل بدء تشغيل التطبيق. الخيار التلقائي: تم إلغاء اختياره. |
خيارات التثبيت: تخطّي التثبيت في حال عدم تغيير حزمة APK | عند تحديده، لا يعيد "استوديو Android" نشر ملف APK إذا اكتشف أنه لم يتم تغييره. إذا أردت أن يفرض "استوديو Android" تثبيت حزمة APK، حتى لو لم تتغير، ألغِ اختيار هذا الخيار. الإعداد التلقائي: تم اختياره |
خيارات التثبيت: فرض إيقاف تشغيل التطبيق قبل بدء النشاط | إذا تم تحديده، سيتم فرض إيقاف التطبيق حتى يبدأ التطبيق من نشاط مشغّل التطبيقات التلقائي إذا تم اكتشاف أنّه لا يجب إعادة تثبيت حزمة APK بسبب عدم تغييرها. وإذا تم إلغاء تحديد هذا الخيار، لن يفرض "استوديو Android" إيقاف التطبيق. يعمل هذا الخيار مع الخيار السابق الذي يتحكّم في تحديد ما إذا كان سيتم تثبيت حزمة APK أم لا. بالنسبة إلى كلا حقلَي خيارات التثبيت، اترُكهما على الإعداد التلقائي ما لم تكن تريد فرض عملية تثبيت بشكل صريح في كل مرة. وفي بعض الحالات، قد تحتاج إلى إلغاء تحديد هذا الخيار. على سبيل المثال، إذا كنت تكتب محرك أسلوب إدخال (IME)، فإن فرض إيقاف التطبيق يؤدي إلى إلغاء تحديده كلوحة المفاتيح الحالية، وهو الأمر الذي قد لا ترغب في شرائه. الإعداد التلقائي: تم اختياره |
قبل الإطلاق | راجع تحديد العمليات قبل الإطلاق. |
علامة تبويب "برنامج تصحيح الأخطاء"
حدِّد خيارات تصحيح الأخطاء في علامة التبويب برنامج تصحيح الأخطاء.
بالنسبة إلى رمزَي C وC++ ، يستخدم "استوديو Android" برنامج تصحيح الأخطاء LLDB. بالإضافة إلى واجهة مستخدم "استوديو Android" العادية، تحتوي نافذة برنامج تصحيح الأخطاء على علامة تبويب LLDB تتيح لك إدخال أوامر LLDB أثناء تصحيح الأخطاء. يمكنك إدخال الأوامر نفسها التي يستخدمها "استوديو Android" لعرض المعلومات في واجهة مستخدم برنامج تصحيح الأخطاء، ويمكنك تنفيذ عمليات إضافية.
بالنسبة إلى مشاريع C وC++ ، يمكنك إضافة أدلة رموز، وكذلك أوامر بدء تشغيل LLDB ونشر أوامر إرفاق، في علامة التبويب Debugger. للقيام بذلك، يمكنك استخدام أزرار مشابهة لما يلي:
- إضافة
- لإضافة دليل أو أمر
- الإزالة
- اختَر دليلاً أو أمرًا، ثم انقر على هذا الزر لإزالة العنصر.
- السهم المتّجه للأعلى
- اختَر دليلاً أو أمرًا، ثم انقر على هذا الزر لنقل العنصر للأعلى في القائمة.
- السهم المتّجه للأسفل
- اختَر دليلاً أو أمرًا، ثم انقر على هذا الزر لنقل العنصر إلى أسفل القائمة.
راجِع صفحة تصحيح أخطاء التطبيق لمزيد من المعلومات حول تصحيح الأخطاء في "استوديو Android".
الحقل | الوصف |
---|---|
نوع تصحيح الأخطاء | حدِّد أحد الخيارات التالية:
يُنصح باستخدام الخيار الرصد تلقائيًا لأنّه يختار نوع تصحيح الأخطاء المناسب لمشروعك. |
دلائل الرموز | إذا كنت تريد إضافة ملفات رموز لتزويد برنامج تصحيح الأخطاء بمعلومات C أو C++ تم إنشاؤها خارج "استوديو Android"، يمكنك إضافة دليل واحد أو أكثر من هنا. ويفضّل "استوديو Android" استخدام أي ملفات ضِمن هذه الأدلة بدلاً من الملفات التي تم إنشاؤها باستخدام مكوّن Android الإضافي لنظام Gradle. يبحث برنامج تصحيح الأخطاء في الأدلة من أعلى إلى أسفل بالترتيب، حتى يعثر على ما يحتاج إليه. يبحث بشكل متكرر عبر الملفات في الدليل. لتحسين القائمة وتوفير الوقت، ضع الأدلة المستخدمة في كثير من الأحيان في أعلى القائمة. وإذا حددت دليلاً عاليًا في الشجرة، يمكن أن يستغرق البحث في جميع الأدلة الفرعية وقتًا أطول. إذا أضفت دليلاً محددًا جدًا، ستستغرق عملية البحث وقتًا أقل. تحتاج إلى إيجاد التوازن الصحيح بين السرعة والعثور على الملفات التي تحتاجها لتصحيح الأخطاء. على سبيل المثال، إذا كان لديك دليل يحتوي على أدلة فرعية لمختلف واجهات Android الثنائية (ABI)، يمكنك اختيار إضافة دليل لـ ABI محدّدين أو لجميع واجهات ABI. على الرغم من أن البحث في دليل المستوى الأعلى قد يستغرق وقتًا أطول، إلا أنه مضمون أكثر إذا قررت تصحيح الأخطاء على جهاز مختلف. وتجدر الإشارة إلى أنّه لا داعي لإضافة أدلة تحتوي على ملفات رموز Gradle لأن برنامج تصحيح الأخطاء يستخدمها تلقائيًا. |
أوامر بدء تشغيل LLDB | أضِف أوامر LLDB التي تريد تنفيذها قبل إرفاق برنامج تصحيح الأخطاء بالعملية. على سبيل المثال، يمكنك تحديد إعدادات البيئة كما هو موضح في الأمر التالي:
ينفذ LLDB الأوامر بالترتيب من أعلى إلى أسفل. |
أوامر إرفاق مشاركة LLDB | أضِف أوامر LLDB التي تريد تنفيذها بعد إرفاق برنامج تصحيح الأخطاء بالعملية مباشرةً. على سبيل المثال:
ينفذ LLDB الأوامر بالترتيب من أعلى إلى أسفل. |
استضافة دليل العمل | حدِّد دليل عمل LLDB. |
التسجيل: استهداف القنوات | حدِّد خيارات سجلّ LLDB. ويضبط Android Studio الخيارات التلقائية بناءً على تجربة الفريق، لذلك فهو لا يبطئ أداءه كثيرًا ولكنّه يحتوي على المعلومات المطلوبة لتحديد المشاكل وحلّها. وغالبًا ما يكون السجلّ مطلوبًا لتقارير الأخطاء في "استوديو Android" هذا الإعداد الافتراضي هو
ويمكنك تغيير الإعدادات التلقائية لجمع المزيد من المعلومات. على سبيل المثال، تجمع خيارات السجلّ التالية معلومات حول lldb process
platform:gdb-remote packets
للحصول على قائمة كاملة بأوامر السجلّ، أدخِل الأمر
يضع "استوديو Android" سجلات الجهاز في الموقع التالي، حيث
بدلاً من ذلك، في حال وصول عدة مستخدمين إلى جهاز، يتم وضع السجلّات في الموقع التالي، حيث يكون
للحصول على معلومات عن استخدام LLDB لتصحيح الأخطاء عن بُعد، راجع تصحيح الأخطاء عن بُعد. |
قبل الإطلاق | راجع تحديد العمليات قبل الإطلاق. |
خادم App Engine DevAppServer
تنطبق إعدادات التشغيل/تصحيح الأخطاء هذه على Google Cloud Platform. للحصول على مزيد من المعلومات، يمكنك الاطّلاع على
تشغيل الخلفية واختبارها ونشر الخلفية. عند اتّباع هذه الخطوات ومزامنة مشروعك مع ملف build.gradle
، ينشئ "استوديو Android" عملية إعداد لك في App Engine DevAppServer.
تجدر الإشارة إلى أنّ نموذج خادم التطبيقات "محرك التطبيقات" IntellJ IDEA هو نموذج مختلف غير متوفّر في "استوديو Android".
الحقل | الوصف |
---|---|
نسخة افتراضية واحدة فقط | إذا كنت تريد التأكّد من أنّه يتم حاليًا تنفيذ مثيل واحد فقط لإعداد التشغيل/تصحيح الأخطاء، حدِّد هذا الخيار. ولا يسمح بعمليات تشغيل متعددة لنفس التهيئة في نفس الوقت. الإعداد التلقائي: تم اختياره |
الوحدة | اختَر وحدة لتطبيق هذه الإعدادات عليها. |
المزامنة مع إعداد Build.gradle | إذا أضفت وحدة App Engine وأجريت مزامنة مع ملف build.gradle ،
سيتم ملء حقول إعداد App Engine DevAppServer نيابةً عنك (إجراء مقترَح).
يؤدي اختيار ملف > مزامنة المشروع مع ملفات Gradle إلى مزامنة المشروع أيضًا. الإعداد التلقائي: تم اختياره
|
حزمة تطوير البرامج لـ App Engine | اكتب مسارًا إلى حزمة تطوير برامج Google App Engine لـ Java على الجهاز المحلي. انقر على ... لاختياره من مربّع حوار. |
مسار الحرب | اكتب مسارًا إلى دليل أرشيف تطبيق الويب (WAR) للتطبيق الذي تنشره على خادم التطوير المحلي. انقر على ... لاختياره من مربّع حوار. |
وسيطات الجهاز الافتراضي | حدِّد خيارات سطر الأوامر التي تريد تمريرها إلى الجهاز الافتراضي لتشغيل DevAppServer. عند تحديد الخيارات:
لمزيد من المعلومات حول خيارات الأجهزة الافتراضية، يمكنك مراجعة مستندات إصدار J2SE، مثل الإعداد التلقائي: ما مِن خيارات |
عنوان الخادم | اكتب عنوان المضيف المطلوب استخدامه للخادم. وقد تحتاج إلى تقديم العنوان لتتمكن من الوصول إلى خادم التطوير من جهاز كمبيوتر آخر على شبكتك. يسمح العنوان 0.0.0.0 بوصول المضيف المحلي والوصول إلى اسم المضيف. الإعداد التلقائي: localhost |
منفذ الخادم | اكتب رقم المنفذ المراد استخدامه للخادم. القيمة التلقائية: 8080 |
إيقاف ميزة "البحث عن تحديثات حزمة تطوير البرامج (SDK) لـ App Engine" | إذا تم توفيره، لن يتصل خادم التطوير بـ App Engine للتحقق من توفر إصدار جديد من حزمة SDK. ويتحقق الخادم افتراضيًا من وجود إصدار جديد عند بدء التشغيل، ثم يطبع رسالة في حالة توفر إصدار جديد. |
قبل الإطلاق | راجع تحديد العمليات قبل الإطلاق. |
إعدادات التشغيل أو تصحيح الأخطاء في Wear OS
تتيح لك نماذج "الإضافة على Wear OS" و"شاشة المعلومات" و"خلفية شاشة الساعة" تشغيل تطبيقات Wear OS أو تصحيح الأخطاء فيها على الأجهزة الافتراضية أو على الأجهزة. معظم خيارات إعداد النماذج مماثلة لخيارات تطبيقات Android. في ما يلي الخيارات الأكثر تحديدًا لإعدادات التشغيل أو تصحيح الأخطاء في Wear OS:
- بالنسبة إلى جميع إعدادات التشغيل أو تصحيح الأخطاء في Wear، عليك اختيار مصدر بيانات أو مربّع أو خلفية شاشة ساعة (حسب النموذج) لتطبيق الإعدادات عليه. وبشكل عام، يتطابق كل كيان من هذه الكيانات مع فئة في الرمز البرمجي الخاص بك.
- عند إعداد إضافة Wear OS أو تصحيح الأخطاء، عليك اختيار فتحة (خانة) حيث تريد وضع بيانات الإضافة التي يوفّرها مصدر بيانات الإضافة. يمكنك اختيار وضعه في الجزء العلوي أو الأيمن أو السفلي أو الأيسر أو خلف خلفية شاشة الساعة.
- بالنسبة إلى إعدادات التشغيل أو تصحيح الأخطاء في إضافة Wear OS، عليك أيضًا اختيار نوع بيانات الإضافة التي يوفّرها مصدر بيانات الإضافة. تقتصر الأنواع التي يمكنك الاختيار من بينها على الأنواع التي يوفّرها مصدر بيانات الإضافة الذي تم اختياره والمتوافقة مع الخانة التي تم اختيارها. للحصول على قائمة بأنواع بيانات الإضافات، راجِع الأنواع والحقول.
بدلاً من ذلك، يمكنك أيضًا تشغيل هذه الأسطح من رمز هامش التوثيق بجانب بيان السطح، كما هو موضّح في الصورة التالية.
![تشغيل الزر في هامش التوثيق بجانب فئة WatchFaceService](https://developer.android.com/static/studio/images/run/wearos_os_gutter_run.png?authuser=5&hl=ar)