عند تشغيل الرمز أو تصحيح أخطائه أو اختبارها، يستخدم "استوديو Android" إعدادات التشغيل/تصحيح الأخطاء لتحديد كيفية تنفيذ العملية. عادةً ما تكون الإعدادات التي تم إنشاؤها في البداية كافية لتشغيل تطبيق أو تصحيح أخطائه. ومع ذلك، يمكنك تعديل وإنشاء عمليات ضبط جديدة وتعديل نماذج الضبط لتلائم عملية التطوير كما هو موضّح في هذه الصفحة.
لمزيد من المعلومات، راجع أيضًا وثائق IntelliJ التالية:
لمحة عن إعدادات التشغيل/تصحيح الأخطاء
تحدد عمليات تهيئة التشغيل/تصحيح الأخطاء تفاصيل مثل خيارات تثبيت التطبيق وإطلاقه والاختبار. يمكنك تحديد تهيئة للاستخدام لمرة واحدة أو حفظها للاستخدام في المستقبل. بعد حفظه، يمكنك اختيار الإعدادات من القائمة المنسدلة اختيار إعدادات التشغيل/تصحيح الأخطاء ضمن شريط الأدوات. يحفظ "استوديو Android" الإعدادات كجزء من المشروع.
إعدادات التشغيل/تصحيح الأخطاء التي تم إنشاؤها مبدئيًا
عند إنشاء مشروع لأول مرة، ينشئ "استوديو Android" إعدادات للتشغيل/تصحيح الأخطاء للنشاط الرئيسي استنادًا إلى نموذج تطبيق Android. لتشغيل مشروعك أو تصحيح أخطائه، عليك دائمًا تحديد إعداد واحد على الأقل للتشغيل/تصحيح الأخطاء. ولهذا السبب، ننصحك بعدم حذف الإعدادات التي تم إنشاؤها في البداية.
نطاق المشروع والتحكم في الإصدار
تنطبق عمليات ضبط التشغيل/تصحيح الأخطاء وتغييرات النماذج على المشروع الحالي فقط. يمكنك مشاركة تهيئة تشغيل/تصحيح الأخطاء (وليس نموذجًا) من خلال نظام التحكم في الإصدار. لمزيد من المعلومات حول طريقة مشاركة الإعدادات، راجِع خيارات ضبط الاسم والمشاركة.
فتح مربّع الحوار "عمليات ضبط التشغيل/تصحيح الأخطاء"
لفتح مربع الحوار "عمليات ضبط التشغيل/تصحيح الأخطاء"، اختَر تشغيل > تعديل عمليات الضبط. يظهر مربع الحوار عمليات تهيئة التشغيل/تصحيح الأخطاء، كما هو موضح في الشكل 1.
تعمل اللوحة اليمنى من مربّع الحوار على تجميع عمليات الضبط المحدَّدة حسب نوع النموذج، والسماح لك بتعديل نماذج الضبط في أسفل الصفحة. يمكنك تعديل الإعدادات المحدَّدة في اللوحة اليسرى. غيِّر حجم مربّع الحوار للاطّلاع على أي عناصر مخفية.
في مربّع الحوار هذا، يمكنك إجراء ما يلي:
- إنشاء عمليات ضبط جديدة للتشغيل/تصحيح الأخطاء
- تعديل إعدادات التشغيل/تصحيح الأخطاء:
- تعديل نماذج الضبط.
- ترتيب عمليات الضبط وتجميعها:
إنشاء إعدادات جديدة للتشغيل/تصحيح الأخطاء
يمكنك تحديد عمليات ضبط التشغيل/تصحيح الأخطاء الجديدة من مربّع الحوار عمليات الضبط/التشغيل/تصحيح الأخطاء أو نافذة المشروع أو محرِّر الرموز. يجب أن تستند الإعدادات الجديدة إلى نموذج ضبط.
يعرض مربّع الحوار "عمليات ضبط التشغيل/تصحيح الأخطاء" عمليات ضبط التشغيل/تصحيح الأخطاء ونماذج الإعدادات المتاحة. يمكنك بدء عملية ضبط جديدة مباشرةً من نموذج أو من نسخة من إعدادات أخرى. يمكنك بعد ذلك تغيير قيم الحقول حسب الحاجة.
وبدلاً من ذلك، يمكنك النقر بزر الماوس الأيمن على عنصر في نافذة المشروع لإنشاء إعداد خاص بهذا العنصر تلقائيًا. على سبيل المثال، إذا كنت تريد تنفيذ نشاط معين، يمكنك النقر بزر الماوس الأيمن على ملف جافا للنشاط وتحديد تشغيل. بناءً على العنصر، يستخدم "استوديو Android" نموذج ضبط تطبيق Android أو اختبارات أداة Android أو JUnit لإنشاء الإعدادات.
في محرر التعليمات البرمجية، يمكنك بسهولة إنشاء اختبار وتشغيل/تصحيح أخطاء لفئة أو طريقة ما، ثم تنفيذه.
عند إنشاء عملية ضبط خارج مربّع الحوار التشغيل/تصحيح الأخطاء، تكون عملية الضبط مؤقتة ما لم تحفظها. يمكن أن يكون لديك تلقائيًا ما يصل إلى خمس إعدادات مؤقتة في المشروع قبل أن يبدأ "استوديو Android" في إزالتها. لتغيير هذا الخيار التلقائي، يمكنك فتح إعدادات "استوديو Android" وتغيير الإعدادات المتقدمة > التشغيل/تصحيح الأخطاء > الحد الأقصى لعمليات الضبط المؤقتة. لمزيد من المعلومات عن عمليات الضبط المؤقتة، راجِع إنشاء وحفظ عمليات ضبط التشغيل/تصحيح الأخطاء المؤقتة.
بدء عملية ضبط استنادًا إلى نموذج
لتحديد إعدادات التشغيل/تصحيح الأخطاء استنادًا إلى نموذج، اتّبِع الخطوات التالية:
- افتح مربّع الحوار "إعدادات التشغيل/تصحيح الأخطاء".
- انقر على إضافة ضبط جديد .
- اختَر نموذج ضبط.
- اكتب اسمًا في حقل الاسم.
- عدِّل الإعدادات حسب الحاجة.
- انقر على تطبيق أو حسنًا.
تأكد من تصحيح أي أخطاء تظهر في أسفل مربع الحوار.
بدء ضبط من نسخة
لتحديد إعدادات التشغيل/تصحيح الأخطاء بدءًا من نسخة من إعدادات أخرى، اتّبِع الخطوات التالية:
- افتح مربّع الحوار "إعدادات التشغيل/تصحيح الأخطاء".
- اختَر إعداد تشغيل/تصحيح أخطاء حالي في اللوحة اليمنى.
- انقر على نسخ الإعداد .
- اكتب اسمًا في حقل الاسم.
- عدِّل الإعدادات حسب الحاجة.
- انقر على تطبيق أو حسنًا.
احرص على تصحيح أي أخطاء تظهر في أسفل مربّع الحوار.
تحديد تهيئة لعنصر في المشروع
يمكن لاستوديو Android إنشاء تهيئة للتشغيل/تصحيح الأخطاء لبعض العناصر المعروضة في نافذة المشروع. يعتمد الضبط على نموذج ضبط على النحو التالي:
- ملف جافا للنشاط: نموذج تطبيق Android.
- الحزمة: نموذج اختبارات أداة Android أو Android JUnit، حسب مجموعة المصادر إذا اخترت اختبارًا قياسيًا، سيستخدم نموذج اختبارات أداة Android. إذا اخترت اختبار وحدة محلية، سيستخدم نموذج Android JUnit. بالنسبة إلى اختبار الوحدة المحلية، يمكنك اختياريًا إجراء تغطية الرموز البرمجية. لمزيد من المعلومات، يمكنك الاطّلاع على تغطية الترميز.
لإنشاء إعدادات تشغيل/تصحيح أخطاء لعنصر في مشروعك، اتّبِع الخطوات التالية:
- افتح مشروعًا في Android أو طريقة عرض "المشروع".
- في نافذة المشروع، انقر بزر الماوس الأيمن على عنصر قابل للاختبار واختَر إما تشغيل filename أو تصحيح الأخطاء filename. ينشئ "استوديو Android" إعدادًا مؤقتًا للتشغيل/تصحيح الأخطاء، ثم يُطلق تطبيقك.
- افتح القائمة المنسدلة اختيار ضبط التشغيل/تصحيح الأخطاء في شريط الأدوات.
- اختَر حفظ الضبط من الخيارات بجانب الإعدادات التي تريد حفظها.
ملاحظة: في حال النقر بزر الماوس الأيمن على العنصر نفسه وتشغيله أو تصحيح أخطائه (وليس نشاطًا)، سينشئ "استوديو Android" إعدادات جديدة.
تحديد تهيئة اختبار لفئة أو طريقة
يتيح لك "استوديو Android" تحديد إعدادات تشغيل اختبار لفئة معيّنة أو طريقة معيّنة، ومن ثم تنفيذها. على سبيل المثال، إذا أنشأت صفًا جديدًا، يمكنك إنشاء صف جديد وإجراء اختبار له. إذا تم اجتياز الاختبار، يمكنك بعد ذلك إجراء الاختبارات لبقية المشروع للتأكد من أن التعليمات البرمجية الجديدة لا تعطّل أي شيء في أي مكان آخر.
يستخدم "استوديو Android" نموذج Android instrumented Tests أو نموذج Android JUnit استنادًا إلى مجموعة المصدر. لإجراء اختبار وحدة محلية، يمكنك اختياريًا تنفيذه باستخدام تغطية الرموز.
لإنشاء إعدادات تشغيل/تصحيح أخطاء لفئة أو طريقة في رمز Java، اتّبِع الخطوات التالية:
- افتح مشروعًا في Android أو طريقة عرض "المشروع".
- افتح ملف Java في "أداة تعديل الرموز".
- اختَر فئة أو طريقة في الرمز، ثم اضغط على Control+Shift+T (Command+Shift+T).
- حدد إنشاء اختبار جديد من القائمة التي تظهر.
- في مربع الحوار إنشاء اختبار، يمكنك تغيير القيم أو ضبطها اختياريًا، ثم النقر على حسنًا.
- في مربّع الحوار اختيار دليل الوجهة، اختَر المكان الذي تريد من "استوديو Android" إجراء الاختبار فيه في المشروع. ويمكنك تحديد الموقع الجغرافي حسب بنية الدليل أو عن طريق اختيار فئة مجاورة.
- انقر على موافق.
يظهر الاختبار الجديد في نافذة المشروع في مجموعة مصدر الاختبار المقابلة.
- لإجراء الاختبار، نفِّذ أحد الإجراءات التالية:
- في نافذة المشروع، انقر بزر الماوس الأيمن على الاختبار واختَر تشغيل أو تصحيح الأخطاء.
- في "أداة تعديل الرموز"، انقر بزر الماوس الأيمن على تعريف الفئة أو اسم الطريقة في ملف الاختبار واختَر تشغيل أو تصحيح الأخطاء لاختبار جميع الطرق في الفئة.
- افتح القائمة المنسدلة اختيار ضبط التشغيل/تصحيح الأخطاء في شريط الأدوات.
- اختَر حفظ الإعدادات من الخيارات بجانب الإعدادات التي تريد حفظها.
تشغيل تطبيق أو تصحيح أخطائه باستخدام إعداد محفوظ
إذا حفظت تهيئة تشغيل/تصحيح أخطاء، يمكنك اختيارها قبل تشغيل تطبيقك أو تصحيح أخطائه.
لاستخدام إعداد محفوظ للتشغيل/تصحيح الأخطاء، اتَّبِع الخطوات التالية:
- حدد تهيئة التشغيل/تصحيح الأخطاء من القائمة المنسدلة اختيار تهيئة التشغيل/تصحيح الأخطاء داخل شريط الأدوات.
- اختَر تشغيل > تشغيل أو تشغيل > تصحيح الأخطاء.
تظهر القائمة المنسدلة على يمين Run وDebug ، على سبيل المثال، .
بدلاً من ذلك، انقر على تشغيل أو تصحيح الأخطاء .
تعديل إعدادات التشغيل/تصحيح الأخطاء
لتعديل إعدادات التشغيل/تصحيح الأخطاء، اتّبِع الخطوات التالية:
- افتح مربّع الحوار "إعدادات التشغيل/تصحيح الأخطاء".
- اختَر أحد الإعدادات في اللوحة اليمنى.
- عدِّل الإعدادات حسب الحاجة.
- انقر على تطبيق أو حسنًا.
احرص على تصحيح أي أخطاء تظهر في أسفل مربّع الحوار.
تعديل نموذج ضبط للتشغيل/تصحيح الأخطاء
يمكنك تعديل نماذج الضبط التي يوفّرها "استوديو Android" بما يتناسب مع عملية التطوير. عند تعديل نموذج، لا يؤثر ذلك في عمليات الضبط الحالية التي تستخدم النموذج. لذلك، على سبيل المثال، إذا كنت بحاجة إلى إنشاء عدد من عمليات الضبط من نوع معيّن، يمكنك تعديل النموذج ثم إعادته مرة أخرى عند الانتهاء.
على الرغم من أنّه لا يمكنك إنشاء نماذج جديدة، يمكنك إنشاء إعدادات لاستخدامها بشكل مشابه للنموذج. يمكنك نسخ تهيئة وتعديل النسخة لإنشاء تهيئات جديدة.
لتعديل نموذج، اتبع الخطوات التالية:
- افتح مربّع الحوار "إعدادات التشغيل/تصحيح الأخطاء".
- انقر على تعديل نماذج الضبط....
- اختَر نموذج ضبط.
- عدِّل الإعدادات حسب الحاجة.
- انقر على تطبيق أو حسنًا.
احرص على تصحيح أي أخطاء تظهر في أسفل مربّع الحوار.
فرز تكوينات المجموعة وتجميعها
في مربع الحوار عمليات ضبط التشغيل/تصحيح الأخطاء، يمكنك ترتيب الإعدادات للعثور عليها بسرعة. يمكنك فرز العناصر في المجلد أبجديًا، وإنشاء مجلدات جديدة لتجميع تكوينات.
لترتيب الإعدادات أبجديًا، اتّبِع الخطوات التالية:
- افتح مربّع الحوار "إعدادات التشغيل/تصحيح الأخطاء".
- اختَر مجلدًا يحتوي على عمليات ضبط.
- انقر على ترتيب عمليات الضبط .
- انقر على حسنًا لإغلاق مربّع الحوار.
لتجميع عمليات الضبط في المجلدات، اتّبِع الخطوات التالية:
- افتح مربّع الحوار "إعدادات التشغيل/تصحيح الأخطاء".
- اختَر مجلدًا يحتوي على عمليات ضبط.
- انقر على إنشاء مجلد جديد .
- اكتب اسمًا في حقل اسم المجلد.
- انقر على تطبيق لحفظ الاسم.
تحديد عمليات ما قبل الإطلاق
يمكنك تحديد المهام المطلوب تنفيذها قبل تطبيق إعداد التشغيل/تصحيح الأخطاء. يتم تنفيذ المهام بالترتيب الذي تظهر به في القائمة.
ملاحظة: تحديد مهام قبل الإطلاق هو ميزة متقدّمة. وبدلاً من
استخدام هذه الميزة، ننصحك بإضافة أي منطق تحضيري كمهام في ملف
build.gradle
حتى يتم تنفيذها عند إنشاء سطر الأوامر.
لإنشاء قائمة مهام، اتّبِع الخطوات التالية:
- في أسفل مربّع الحوار عمليات ضبط التشغيل/تصحيح الأخطاء ضمن قبل الإطلاق (قد تحتاج إلى الانتقال للأسفل)، انقر على رمز إضافة واختَر نوع المهمة. إذا ظهر مربّع حوار، املأ الحقول وانقر على حسنًا.
- أضف المزيد من المهام حسب الحاجة.
- لترتيب المهام، اسحبها أو اختَر مهمة وانقر على السهم المتّجه للأعلى والسهم المتّجه للأسفل لنقلها للأعلى أو للأسفل في القائمة.
- اختَر عرض هذه الصفحة إذا كنت تريد عرض إعدادات الضبط للتشغيل/تصحيح الأخطاء قبل تطبيقها.
يتم إلغاء اختيار هذا الخيار تلقائيًا.
- اختَر نافذة الأداة النشطة إذا كنت تريد تفعيل نافذة أداة تشغيل
أو
تصحيح الأخطاء عند تشغيل التطبيق أو تصحيح أخطائه.
ويتم تحديد هذا الخيار تلقائيًا.
لإزالة مهمة من القائمة، اتّبِع الخطوات التالية:
- اختَر مهمة.
- انقر على إزالة .
لتعديل مهمة، اتبع الخطوات التالية:
- اختَر مهمة.
- انقر على تعديل .
- عدِّل إعدادات المهام في مربع الحوار الذي يفتح، ثم انقر على حسنًا.
يسرد الجدول التالي المهام المتاحة التي يمكنك إضافتها.
المهمة | الوصف |
---|---|
تشغيل الأداة الخارجية | شغِّل تطبيقًا خارجيًا عن "استوديو Android". في مربع الحوار أدوات خارجية، اختَر تطبيقًا أو أكثر تريد تشغيله ثم انقر على حسنًا. إذا لم يتم تعريف التطبيق في "استوديو Android" بعد، أضِف تعريفه في مربّع الحوار إنشاء أدوات. لمزيد من المعلومات، يُرجى الاطّلاع على ضبط أدوات الجهات الخارجية والأدوات الخارجية. |
تشغيل إعداد آخر | نفِّذ إحدى عمليات الإعداد الحالية للتشغيل/تصحيح الأخطاء. في مربع الحوار اختيار تهيئة لتنفيذها، اختَر إعدادًا لتنفيذه، ثم انقر على حسنًا. |
إنشاء | قم بتجميع المشروع أو الوحدة. ينفِّذ استوديو Android أمر إنشاء وحدة إذا كانت إعدادات التشغيل/تصحيح الأخطاء تحدد وحدة معيّنة، أو ينفّذ الأمر إنشاء مشروع إذا لم يتم تحديد أي وحدات. |
إنشاء مشروع | قم بتجميع المشروع. ينفِّذ استوديو Android الأمر Make Project. |
الإنشاء، لا التحقق من الأخطاء | يشبه هذا الخيار إنشاء، باستثناء أنّ Android Studio ينفِّذ إعدادات التشغيل/تصحيح الأخطاء بغض النظر عن نتيجة التجميع. |
إنشاء الأدوات | هذه الميزة غير متاحة في "استوديو Android". |
تشغيل مهمة Gradle | شغِّل مهمة Gradle. في مربّع الحوار الذي يفتح، حدِّد التفاصيل، ثم انقر على حسنًا. لمزيد من المعلومات، اطّلِع على Gradle. |
إعداد مدرك لـ Gradle | اجمع المشروع وشغِّل Gradle. |
أداة إنشاء App Engine Gradle | تعمل مهمة إنشاء App Engine Gradle على مزامنة المشروع ثم إنشاء الوحدة. |
نماذج الضبط
يوفر "استوديو Android" نماذج ضبط لمساعدتك في البدء بسرعة. توضِّح الأقسام التالية النماذج التي تنطبق على تطوير Android باستخدام "استوديو Android":
- تطبيق Android
- اختبارات Android
- خادم App Engine DevAppServer
- الإضافة إلى نظام التشغيل Wear OS والشاشة وخلفية شاشة الساعة
ملاحظة: يحتوي الإصدار 2.1.1 من استوديو Android 2.1.x والإصدارات الأقدم على نموذج تطبيق أصلي لا تتوفّر في الإصدارات الأحدث. إذا كان لديك نموذج تطبيق أصلي في مشروع، ستحوّله "استوديو Android" إلى تطبيق Android عند تحميل المشروع. يرشدك مربّع الحوار تحويل المشروع خلال العملية.
نماذج غير متوافقة
إنّ النماذج التالية غير المتوافقة هي من IntelliJ IDEA وهي ليست خاصة بتطوير Android باستخدام "استوديو Android". لمزيد من المعلومات حول استخدام هذه القوالب، اتبع الروابط إلى وثائق IntelliJ IDEA.
- التطبيق
- مركَّب
- المخدّر
- رائع
- تطبيق 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: محو السجلّ قبل الإطلاق | حدِّد هذا الخيار إذا كنت تريد من "استوديو Android" إزالة البيانات من الجلسات السابقة من ملف السجلّ قبل بدء التطبيق. الإعداد التلقائي: غير محدَّد. |
خيارات التثبيت: يمكنك تخطّي التثبيت إذا لم يتم تغيير حزمة APK. | عند اختيار "استوديو Android"، لا يعيد نشر ملف APK إذا اكتشف عدم تغيّره. إذا أردت أن يفرض "استوديو Android" تثبيت حِزمة APK حتى إذا لم تتغيّر، ألغِ اختيار هذا الخيار. الخيار التلقائي: تم اختياره |
خيارات التثبيت: فرض إيقاف تشغيل التطبيق قبل بدء النشاط | إذا تم تحديد هذا الخيار، عندما يرصد "استوديو Android" أنّه لا حاجة إلى إعادة تثبيت حزمة APK بسبب عدم تغيّرها، سيتم فرض إيقاف التطبيق حتى يبدأ التطبيق من نشاط مشغّل التطبيقات التلقائي. وفي حال إلغاء اختيار هذا الخيار، لن يفرض "استوديو Android" إيقاف التطبيق من المؤسسة. يعمل هذا الخيار مع الخيار السابق الذي يتحكّم في تثبيت حزمة APK أم لا. في حقلَي خيارات التثبيت، اترُكهما على الإعداد التلقائي إلا إذا كنت تريد فرض التثبيت في كل مرة. وفي بعض الحالات، قد تريد إلغاء تحديد هذا الخيار. على سبيل المثال، في حال كتابة محرّك أسلوب إدخال (IME)، سيؤدي فرض إيقاف التطبيق إلى إلغاء اختياره ليكون لوحة المفاتيح الحالية التي قد لا تريدها. الخيار التلقائي: تم اختياره |
قبل طرح الميزة | يُرجى الاطّلاع على التحديد قبل العمليات. |
علامة التبويب "برنامج تصحيح الأخطاء"
حدِّد خيارات تصحيح الأخطاء في علامة التبويب برنامج تصحيح الأخطاء.
بالنسبة إلى رموز C وC++ ، يستخدم استوديو Android برنامج تصحيح الأخطاء LLDB. بالإضافة إلى واجهة مستخدم "استوديو Android" العادية، تتضمّن نافذة برنامج تصحيح الأخطاء علامة التبويب LLDB التي تتيح لك إدخال أوامر LLDB أثناء تصحيح الأخطاء. يمكنك إدخال الأوامر نفسها التي يستخدمها "استوديو Android" لعرض المعلومات في واجهة مستخدم برنامج تصحيح الأخطاء، ويمكنك إجراء عمليات إضافية.
بالنسبة إلى مشاريع C وC++، يمكنك إضافة أدلة رموز، بالإضافة إلى أوامر بدء تشغيل LLDB ونشر ما بعد إرفاق الأخطاء في علامة التبويب برنامج تصحيح الأخطاء. للقيام بذلك، يمكنك استخدام أزرار مشابهة لما يلي:
- الإضافة - لإضافة دليل أو أمر.
- إزالة - اختَر دليلاً أو أمرًا، ثم انقر على هذا الزر لإزالة العنصر.
- السهم المتّجه للأعلى - اختَر دليلاً أو أمرًا، ثم انقر على هذا الزر لنقل العنصر إلى أعلى القائمة.
- السهم المتّجه للأسفل - اختَر دليلاً أو أمرًا، ثم انقر على هذا الزر لنقل العنصر إلى أسفل القائمة.
يمكنك مراجعة تصحيح أخطاء تطبيقك للحصول على مزيد من المعلومات حول تصحيح الأخطاء في "استوديو Android".
الحقل | الوصف |
---|---|
نوع تصحيح الأخطاء | حدِّد أحد الخيارات التالية:
يُنصح باستخدام خيار الرصد تلقائيًا لأنّه يختار نوع تصحيح الأخطاء المناسب لمشروعك. |
دلائل الرموز | وإذا كنت تريد إضافة ملفات رموز لتزويد برنامج تصحيح الأخطاء بمعلومات C أو C++ التي يتم إنشاؤها خارج "استوديو Android"، يمكنك إضافة دليل واحد أو أكثر هنا. يستخدم استوديو Android أي ملفات داخل هذه الأدلة بشكل تفضيلي على الملفات التي تم إنشاؤها بواسطة المكوّن الإضافي لنظام Gradle المتوافق مع Android. يبحث برنامج تصحيح الأخطاء في الأدلة من أعلى إلى أسفل بالترتيب حتى يعثر على ما يحتاج إليه. فهي تبحث بشكل متكرر في الملفات في الدليل. لتحسين القائمة وتوفير الوقت، ضع الأدلة المستخدمة كثيرًا في أعلى القائمة. إذا حددت دليلاً في الشجرة، قد يستغرق البحث عن كل الأدلة الفرعية وقتًا أطول. إذا أضفت دليلاً محددًا جدًا، يستغرق البحث وقتًا أقل. عليك إيجاد التوازن الصحيح بين السرعة والعثور على الملفات التي تحتاجها لتصحيح الأخطاء. على سبيل المثال، إذا كان لديك دليل يحتوي على أدلة فرعية لواجهات Android الثنائية (ABIs) المختلفة، يمكنك اختيار إضافة دليل لواجهة ABI محددة أو لجميع واجهات التطبيق الثنائية (ABI). وعلى الرغم من أنّ البحث في دليل المستوى الأعلى قد يستغرق وقتًا أطول، إلا أنّ ذلك يكون أكثر سهولة إذا قررت تصحيح الأخطاء على جهاز مختلف. ملاحظة: ليس عليك إضافة أدلة تحتوي على ملفات رموز Gradle لأن برنامج تصحيح الأخطاء يستخدمها تلقائيًا. |
أوامر بدء تشغيل LLDB | أضِف أوامر LLDB التي تريد تنفيذها قبل أن يرفق برنامج تصحيح الأخطاء بالعملية. على سبيل المثال، يمكنك تحديد الإعدادات للبيئة، كما هو موضح في الأمر التالي:
ينفذ LLDB الأوامر بالترتيب من أعلى إلى أسفل. |
أوامر إرفاق LLDB | أضِف أوامر LLDB التي تريد تنفيذها مباشرةً بعد إرفاق برنامج تصحيح الأخطاء بالعملية. على سبيل المثال:
ينفذ LLDB الأوامر بالترتيب من أعلى إلى أسفل. |
دليل عمل المضيف | حدِّد دليل العمل LLDB. |
التسجيل: القنوات المستهدفة | حدِّد خيارات سجلّ LLDB. يضبط استوديو Android الخيارات التلقائية بناءً على تجربة الفريق، لذا فهو ليس بطيئًا جدًا ولكنه يحتوي على المعلومات المطلوبة لتحديد المشاكل وحلّها. غالبًا ما يتم طلب السجلّ لتقارير الأخطاء في "استوديو Android". هذا الوضع التلقائي هو
يمكنك تغيير الإعداد التلقائي لجمع مزيد من المعلومات. على سبيل المثال، تجمع خيارات السجلّ التالية معلومات حول lldb process
platform:gdb-remote packets
للحصول على قائمة كاملة بأوامر السجلّ، أدخِل الأمر
يضع "استوديو Android" سجلات الأجهزة في المكان التالي، حيث إنّ
أو إذا دخل عدة مستخدمين إلى جهاز، يتم وضع السجلّات في الموقع التالي، حيث يكون
وللحصول على معلومات عن استخدام LLDB لتصحيح الأخطاء عن بُعد، يُرجى الاطّلاع على تصحيح الأخطاء عن بُعد. |
قبل طرح الميزة | راجع التحديد قبل العمليات. |
علامة تبويب إنشاء الملفات التعريفية
يجب وضع علامة في المربّع تفعيل التحليل المتقدّم لتفعيل ميزات معيّنة في محلل Android عندما يعمل جهازك بالإصدار 7.1 من نظام التشغيل Android أو الإصدارات الأقدم.
اختبارات Android
يعتمد نموذج الاختبار الذي عليك استخدامه على مجموعة المصادر. نموذج الاختبارات المعدّة من Android مخصّص لاختبار قياس حالة التطبيق. إنّ نموذج Android JUnit مخصّص لاختبار وحدة محلية.
ملاحظة: إذا كنت تستخدم مركز الاختبار الافتراضي لمنصة Firebase لإجراء الاختبار على مجموعة متنوعة من الأجهزة، يمكنك استخدام نموذج Android JUnit لتحديد الاختبارات المستخدمة. ولمزيد من المعلومات، يُرجى الاطّلاع على مقالة إجراء الاختبارات باستخدام مركز الاختبار الافتراضي لمنصة Firebase.
تتناول أوصاف علامات التبويب التالية علامات التبويب والحقول الخاصة بنموذج اختبار معدات Android. للحصول على معلومات حول علامات التبويب والحقول الخاصة بنموذج اختبار Android JUnit، راجِع صفحة إعداد التشغيل/تصحيح الأخطاء في IntelliJ: JUnit.
علامة التبويب "إعدادات عامة"
في علامة التبويب إعدادات عامة، يمكنك تحديد خيارات النشر وموقع الاختبار، ومشغّل الأدوات، ونافذة شل adb.
الحقل | الوصف |
---|---|
الوحدة | اختَر وحدة لتطبيق هذه الإعدادات عليها. |
الاختبار | في هذه المنطقة، حدِّد الموقع الجغرافي للاختبارات التي تريد إجراءها:
|
برنامج تشغيل الأدوات المحددة (اختياري) | اكتب موقع أداة تشغيل الأدوات، وانقر على المزيد لاستخدام مربع حوار. يحدد ملف build.gradle موقع تشغيل الأداة، وتلغي هذه القيمة الموقع. وتكون الفئة التلقائية عادةً الفئة AndroidJUnitRunner
من AndroidX Test.
|
خيارات إضافية | اكتب أي خيارات adb الخيار التلقائي: لا تتوفّر خيارات. |
خيارات استهداف النشر: الاستهداف | حدِّد خيارًا:
|
خيارات استهداف النشر: استخدام الجهاز نفسه في عمليات الإطلاق المستقبلية | إذا كنت تريد استخدام الجهاز الذي اخترته تلقائيًا من خلال مربّع الحوار اختيار استهداف النشر لاحقًا، حدِّد هذا الخيار. إذا لم يكن الجهاز متاحًا، سيظهر مربّع حوار. الإعداد التلقائي: تم إلغاء اختياره |
قبل طرح الميزة | راجع التحديد قبل العمليات. |
علامة تبويب متنوعة
تحتوي علامة التبويب متنوع على خيارات Logcat والتثبيت.
الحقل | الوصف |
---|---|
Logcat: محو السجلّ قبل الإطلاق | حدِّد هذا الخيار إذا كنت تريد من "استوديو Android" إزالة البيانات من الجلسات السابقة من ملف السجلّ قبل بدء التطبيق. الإعداد التلقائي: غير محدَّد. |
خيارات التثبيت: تخطّي التثبيت إذا لم يتم تغيير حزمة APK | عند اختيار "استوديو Android"، لا يعيد نشر ملف APK إذا اكتشف أنّه لم يتم إجراء أي تغييرات عليه. إذا أردت أن يفرض تطبيق Android Studio تثبيت حزمة APK حتى لو لم تتغيّر، ألغِ تحديد هذا الخيار. الخيار التلقائي: تم اختياره |
خيارات التثبيت: فرض إيقاف تشغيل التطبيق قبل بدء النشاط | إذا تم تحديد هذا الخيار، عندما يرصد "استوديو Android" أنّه لا حاجة إلى إعادة تثبيت حزمة APK بسبب عدم تغيّرها، سيتم فرض إيقاف التطبيق حتى يبدأ التطبيق من نشاط مشغّل التطبيقات التلقائي. وفي حال إلغاء اختيار هذا الخيار، لن يفرض "استوديو Android" إيقاف التطبيق من المؤسسة. يعمل هذا الخيار إلى جانب الخيار السابق الذي يتحكّم في ما إذا كان قد تم تثبيت حزمة APK أم لا. في حقلَي خيارات التثبيت، اترُكهما على الإعداد التلقائي إلا إذا كنت تريد فرض التثبيت في كل مرة. وفي بعض الحالات، قد تريد إلغاء تحديد هذا الخيار. على سبيل المثال، في حال كتابة محرّك أسلوب إدخال (IME)، سيؤدي فرض إيقاف التطبيق إلى إلغاء اختياره ليكون لوحة المفاتيح الحالية التي قد لا تريدها. الخيار التلقائي: تم اختياره |
قبل طرح الميزة | راجع التحديد قبل العمليات. |
علامة التبويب "برنامج تصحيح الأخطاء"
حدِّد خيارات تصحيح الأخطاء في علامة التبويب برنامج تصحيح الأخطاء.
بالنسبة إلى رموز C وC++ ، يستخدم استوديو Android برنامج تصحيح الأخطاء LLDB. بالإضافة إلى واجهة مستخدم "استوديو Android" العادية، تتضمّن نافذة برنامج تصحيح الأخطاء علامة التبويب LLDB التي تتيح لك إدخال أوامر LLDB أثناء تصحيح الأخطاء. يمكنك إدخال الأوامر نفسها التي يستخدمها "استوديو Android" لعرض المعلومات في واجهة مستخدم برنامج تصحيح الأخطاء، ويمكنك إجراء عمليات إضافية.
بالنسبة إلى مشاريع C وC++، يمكنك إضافة أدلة رموز، بالإضافة إلى أوامر بدء تشغيل LLDB ونشر ما بعد إرفاق الأخطاء في علامة التبويب برنامج تصحيح الأخطاء. للقيام بذلك، يمكنك استخدام أزرار مشابهة لما يلي:
- الإضافة - لإضافة دليل أو أمر.
- إزالة - اختَر دليلاً أو أمرًا، ثم انقر على هذا الزر لإزالة العنصر.
- السهم المتّجه للأعلى - اختَر دليلاً أو أمرًا، ثم انقر على هذا الزر لنقل العنصر إلى أعلى القائمة.
- السهم المتّجه للأسفل - اختَر دليلاً أو أمرًا، ثم انقر على هذا الزر لنقل العنصر إلى أسفل القائمة.
يمكنك مراجعة تصحيح أخطاء تطبيقك للحصول على مزيد من المعلومات حول تصحيح الأخطاء في "استوديو Android".
الحقل | الوصف |
---|---|
نوع تصحيح الأخطاء | حدِّد أحد الخيارات التالية:
يُنصح باستخدام خيار الرصد تلقائيًا لأنّه يختار نوع تصحيح الأخطاء المناسب لمشروعك. |
دلائل الرموز | وإذا كنت تريد إضافة ملفات رموز لتزويد برنامج تصحيح الأخطاء بمعلومات C أو C++ التي يتم إنشاؤها خارج "استوديو Android"، يمكنك إضافة دليل واحد أو أكثر هنا. يستخدم استوديو Android أي ملفات داخل هذه الأدلة بشكل تفضيلي على الملفات التي تم إنشاؤها بواسطة المكوّن الإضافي لنظام Gradle المتوافق مع Android. يبحث برنامج تصحيح الأخطاء في الأدلة من أعلى إلى أسفل بالترتيب حتى يعثر على ما يحتاج إليه. فهي تبحث بشكل متكرر في الملفات في الدليل. لتحسين القائمة وتوفير الوقت، ضع الأدلة المستخدمة كثيرًا في أعلى القائمة. إذا حددت دليلاً في الشجرة، قد يستغرق البحث عن كل الأدلة الفرعية وقتًا أطول. إذا أضفت دليلاً محددًا جدًا، يستغرق البحث وقتًا أقل. عليك إيجاد التوازن الصحيح بين السرعة والعثور على الملفات التي تحتاجها لتصحيح الأخطاء. على سبيل المثال، إذا كان لديك دليل يحتوي على أدلة فرعية لواجهات Android الثنائية (ABIs) المختلفة، يمكنك اختيار إضافة دليل لواجهة ABI محددة أو لجميع واجهات التطبيق الثنائية (ABI). وعلى الرغم من أنّ البحث في دليل المستوى الأعلى قد يستغرق وقتًا أطول، إلا أنّ ذلك يكون أكثر سهولة إذا قررت تصحيح الأخطاء على جهاز مختلف. ملاحظة: ليس عليك إضافة أدلة تحتوي على ملفات رموز Gradle لأن برنامج تصحيح الأخطاء يستخدمها تلقائيًا. |
أوامر بدء تشغيل LLDB | أضِف أوامر LLDB التي تريد تنفيذها قبل أن يرفق برنامج تصحيح الأخطاء بالعملية. على سبيل المثال، يمكنك تحديد الإعدادات للبيئة، كما هو موضح في الأمر التالي:
ينفذ LLDB الأوامر بالترتيب من أعلى إلى أسفل. |
أوامر إرفاق LLDB | أضِف أوامر LLDB التي تريد تنفيذها مباشرةً بعد إرفاق برنامج تصحيح الأخطاء بالعملية. على سبيل المثال:
ينفذ LLDB الأوامر بالترتيب من أعلى إلى أسفل. |
دليل عمل المضيف | حدِّد دليل العمل LLDB. |
التسجيل: القنوات المستهدفة | حدِّد خيارات سجلّ LLDB. يضبط استوديو Android الخيارات التلقائية بناءً على تجربة الفريق، لذا فهو ليس بطيئًا جدًا ولكنه يحتوي على المعلومات المطلوبة لتحديد المشاكل وحلّها. غالبًا ما يتم طلب السجلّ لتقارير الأخطاء في "استوديو Android". هذا الوضع التلقائي هو
يمكنك تغيير الإعداد التلقائي لجمع مزيد من المعلومات. على سبيل المثال، تجمع خيارات السجلّ التالية معلومات حول lldb process
platform:gdb-remote packets
للحصول على قائمة كاملة بأوامر السجلّ، أدخِل الأمر
يضع "استوديو Android" سجلات الأجهزة في المكان التالي، حيث إنّ
أو إذا دخل عدة مستخدمين إلى جهاز، يتم وضع السجلّات في الموقع التالي، حيث يكون
وللحصول على معلومات عن استخدام LLDB لتصحيح الأخطاء عن بُعد، يُرجى الاطّلاع على تصحيح الأخطاء عن بُعد. |
قبل طرح الميزة | راجع التحديد قبل العمليات. |
خادم App Engine DevAppServer
تنطبق إعدادات التشغيل/تصحيح الأخطاء هذه على Google Cloud Platform. لمزيد من المعلومات، راجع
التشغيل والاختبار ونشر الخلفية. عند اتّباع هذه الخطوات ومزامنة مشروعك مع ملف build.gradle
، ينشئ "استوديو Android" إعدادات App Engine DevAppServer
من أجلك.
يُرجى العِلم أنّ نموذج AppEngine Server في IntellJ IDEA هو نموذج مختلف غير متوفّر في "استوديو Android".
الحقل | الوصف |
---|---|
مثيل واحد فقط | إذا كنت تريد التأكّد من تنفيذ مثيل واحد فقط من تهيئة التشغيل/تصحيح الأخطاء حاليًا، حدّد هذا الخيار. ولا يسمح بإجراء عمليات تشغيل متعددة لنفس التهيئة في نفس الوقت. الخيار التلقائي: تم اختياره |
الوحدة | اختَر وحدة لتطبيق هذه الإعدادات عليها. |
المزامنة مع إعدادات Build.gradle | إذا أضفت وحدة App Engine وزامنتها مع ملف build.gradle ،
فسيتم ملء حقول إعداد App Engine DevAppServer نيابةً عنك (إجراء مقترَح).
يؤدي تحديد ملف > مزامنة المشروع مع ملفات Gradle إلى مزامنة المشروع أيضًا. الخيار التلقائي: تم اختياره
|
حزمة تطوير البرامج (SDK) لـ App Engine | اكتب مسارًا إلى Google App Engine SDK للغة Java على الجهاز المحلي. انقر على ... لتحديده من مربّع حوار. |
مسار الحرب | اكتب مسارًا إلى دليل أرشيف تطبيقات الويب (WAR) للتطبيق الذي تنشره على خادم التطوير المحلي. انقر على ... لتحديده من مربّع حوار. |
وسيطات افتراضي | حدِّد خيارات سطر الأوامر التي تريد تمريرها إلى الجهاز الافتراضي لإطلاق DevAppServer. عند تحديد الخيارات:
للمزيد من المعلومات حول خيارات الجهاز الافتراضي، يمكنك الاطّلاع على مستندات إصدار J2SE، مثل
الإعدادات التلقائية: ما مِن خيارات |
عنوان الخادم | اكتب عنوان المضيف المطلوب استخدامه للخادم. قد تحتاج إلى توفير العنوان لتتمكن من الوصول إلى خادم التطوير من جهاز كمبيوتر آخر على شبكتك. يتيح العنوان 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، عليك أيضًا اختيار نوع بيانات الإضافة التي يوفّرها مصدر بيانات الإضافة. تقتصر الأنواع التي يمكنك الاختيار من بينها على تلك التي يوفّرها مصدر بيانات الإضافة المحدّد والمتوافقة مع الخانة المحدّدة. للحصول على قائمة بأنواع بيانات الإضافة، راجِع الأنواع والحقول.
بدلاً من ذلك، يمكنك أيضًا تشغيل هذه الأسطح من رمز هامش التوثيق الواقع بجانب بيان السطح، كما هو موضّح في الصورة التالية.