عند تشغيل الرمز أو تصحيح أخطائه أو اختباره، يستخدم "استوديو Android" مسار التشغيل/تصحيح الأخطاء. لتحديد كيفية تنفيذ العملية. وعادةً ما تكون تُعتبر التهيئة التي تم إنشاؤها في البداية كافية للتشغيل أو تصحيح أخطاء تطبيق. ومع ذلك، يمكنك تعديل عمليات الضبط وإنشاء جديدة لها وتعديل الإعدادات. النماذج لتناسب عملية التطوير كما هو موضح في هذه الصفحة.
للحصول على مزيد من المعلومات، يُرجى الاطّلاع أيضًا على وثائق IntelliJ التالية:
لمحة عن إعدادات التشغيل/تصحيح الأخطاء
تحدِّد إعدادات التشغيل/تصحيح الأخطاء تفاصيل مثل خيارات تثبيت التطبيق وإطلاقه واختباره. يمكنك تحديد إعداد للاستخدام لمرة واحدة، أو حفظه للاستخدام في المستقبل. وبعد حفظه، يمكنك تحديد التهيئة من اختر القائمة المنسدلة Run/Debug Configuration (ضبط التشغيل/تصحيح الأخطاء) ضمن شريط الأدوات. يحفظ "استوديو Android" الإعدادات كجزء من المشروع.
إعدادات التشغيل/تصحيح الأخطاء التي تم إنشاؤها في البداية
عند إنشاء مشروع لأول مرة، ينشئ "استوديو Android" عملية تشغيل/تصحيح أخطاء النشاط الرئيسي استنادًا إلى نموذج تطبيق Android. للتشغيل أو تصحيح الأخطاء يجب عليك دائمًا تحديد إعداد تشغيل/تصحيح أخطاء واحد على الأقل. ولهذا السبب، ننصح بعدم حذف الإعدادات التي تم إنشاؤها في البداية.
نطاق المشروع والتحكم في الإصدار
تنطبق إعدادات التشغيل/تصحيح الأخطاء وتغييرات النموذج على المشروع الحالي فقط. يمكنك مشاركة إعداد تشغيل/تصحيح الأخطاء (وليس نموذجًا) من خلال نظام التحكم في الإصدار. لمزيد من المعلومات حول كيفية مشاركة إعداد، يُرجى اتّباع الخطوات التالية: راجِع خيارات ضبط الاسم والمشاركة.
فتح مربع حوار إعدادات التشغيل/تصحيح الأخطاء
لفتح مربع حوار إعدادات التشغيل/تصحيح الأخطاء، اختيار تشغيل > تعديل الإعدادات. تشير رسالة الأشكال البيانية سيظهر مربّع الحوار عمليات ضبط التشغيل/تصحيح الأخطاء، كما هو موضّح في الشكل 1-
الشكل 1. مربّع الحوار إعدادات التشغيل/تصحيح الأخطاء
تجمع اللوحة اليمنى لمربّع الحوار عمليات الضبط المحدّدة حسب نوع النموذج. لتعديل نماذج الضبط في أسفل الصفحة. يمكنك تعديل الإعدادات المحدَّدة في اللوحة اليسرى. غيّر حجم مربع الحوار للاطلاع على أي عناصر مخفية.
في مربّع الحوار هذا، يمكنك إجراء ما يلي:
- إنشاء عمليات ضبط جديدة للتشغيل/تصحيح الأخطاء
- تعديل إعدادات التشغيل/تصحيح الأخطاء:
- تعديل نماذج الضبط.
- الترتيب وإعداد المجموعات:
إنشاء إعدادات جديدة للتشغيل/تصحيح الأخطاء
يمكنك تحديد عمليات ضبط جديدة للتشغيل/تصحيح الأخطاء من خلال الانتقال إلى صفحة التشغيل/تصحيح الأخطاء. مربّع حوار "الإعدادات" أو نافذة المشروع أو الرمز محرِّر. يجب أن تستند الإعدادات الجديدة إلى نموذج ضبط.
يعرض مربّع حوار "عمليات ضبط التشغيل/تصحيح الأخطاء" عمليات ضبط التشغيل/تصحيح الأخطاء والإعدادات المتاحة نماذج التهيئة. يمكنك بدء إعداد جديد مباشرةً من نموذج أو من نسخة من تهيئة أخرى. يمكنك بعد ذلك تغيير قيم الحقول حسب الحاجة.
بدلاً من ذلك، يمكنك النقر بزر الماوس الأيمن على عنصر في المشروع. لإنشاء تهيئة خاصة بهذا العنصر تلقائيًا. بالنسبة على سبيل المثال، إذا أردت تنفيذ نشاط معيّن، يمكنك النقر بزر الماوس الأيمن على ملف Java واختر تشغيل. اعتمادًا على العنصر، يستخدم "استوديو Android" تطبيقًا Android، Android Detected Tests أو JUnit نموذج الضبط لإنشاء الإعدادات.
في "محرِّر الرموز"، يمكنك بسهولة إنشاء إعدادات اختبار وتشغيل/تصحيح أخطاء لفئة أو طريقة، ثم تنفيذها.
عند إنشاء تهيئة خارج تشغيل/تصحيح الأخطاء الإعدادات، يكون الضبط مؤقتًا ما لم تحفظه. يمكنك تلقائيًا إجراء ما يصل إلى خمسة إعدادات مؤقتة. في المشروع قبل بدء "استوديو Android" في إزالتها. لتغيير هذا، التلقائي، افتح إعدادات "استوديو Android" ثم غيِّر الإعدادات المتقدمة > تشغيل/تصحيح الأخطاء > الحد الأقصى لعمليات الضبط المؤقتة. لمزيد من المعلومات عن عمليات الضبط المؤقتة، يُرجى الاطّلاع على إنشاء إعدادات التشغيل/تصحيح الأخطاء المؤقتة وحفظها:
بدء عملية ضبط استنادًا إلى نموذج
لتحديد عملية ضبط تشغيل/تصحيح الأخطاء استنادًا إلى نموذج، اتّبِع الخطوات التالية:
- افتح زر "التشغيل/تصحيح الأخطاء" مربّع حوار الإعدادات
- انقر على إضافة إعدادات جديدة
.
- اختَر نموذج ضبط.
- اكتب اسمًا في الحقل الاسم.
- عدِّل الإعدادات حسب الحاجة.
- انقر على تطبيق أو حسنًا.
تأكَّد من تصحيح أي أخطاء معروضة. في أسفل مربع الحوار
بدء عملية ضبط من نسخة
لتحديد ضبط تشغيل/تصحيح الأخطاء بدءًا من نسخة من أخرى التكوين، اتبع الخطوات التالية:
- افتح زر "التشغيل/تصحيح الأخطاء" مربّع حوار الإعدادات
- اختَر إعدادًا حاليًا للتشغيل/تصحيح الأخطاء في اللوحة اليمنى.
- انقر على رمز نسخ الإعداد
.
- اكتب اسمًا في الحقل الاسم.
- عدِّل الإعدادات حسب الحاجة.
- انقر على تطبيق أو حسنًا.
تأكَّد من تصحيح أي أخطاء معروضة. في أسفل مربع الحوار
تحديد تهيئة لعنصر في المشروع
يمكن أن ينشئ "استوديو Android" إعدادات التشغيل/تصحيح الأخطاء لبعض العناصر. المعروض في نافذة المشروع. تعتمد عملية التهيئة على نموذج ضبط، على النحو التالي:
- ملف Java للنشاط: نموذج تطبيق Android.
- الحزمة: اختبارات Android Widget أو نموذج Android JUnit، حسب مجموعة المصادر في حال اختيار اختبار قياس حالة التطبيق، فسيتم عندها استخدام نموذج "اختبارات محاكاة Android" إذا اخترت اختبار الوحدة المحلية فإنها تستخدم نموذج Android JUnit. بالنسبة لاختبار الوحدة المحلية، يمكنك يمكنك تشغيله اختياريًا مع تغطية الرمز لمزيد من المعلومات، يُرجى الاطّلاع على الرمز. التغطية:
لإنشاء تهيئة تشغيل/تصحيح الأخطاء لعنصر في مشروعك، اتبع الخطوات التالية:
- فتح مشروع في Android أو "طريقة عرض المشروع".
- في نافذة المشروع، انقر بزر الماوس الأيمن على عنصر قابل للاختبار واختَر إما شغِّل filename أو تصحيح الأخطاء filename. يُنشئ "استوديو Android" إعدادات مؤقتة للتشغيل/تصحيح الأخطاء، ويطلق تطبيقك.
- افتح القائمة المنسدلة اختيار إعداد/تصحيح الأخطاء في شريط الأدوات.
- اختَر حفظ الضبط من الخيارات بجانب الإعدادات التي
تريد حفظها.
الشكل 2. حفظ الإعدادات
ملاحظة: في حال النقر بزر الماوس الأيمن على العنصر نفسه وتشغيله أو تصحيح الأخطاء فيه (ولكن ليس )، سينشئ "استوديو Android" إعدادات جديدة.
تحديد إعدادات اختبارية لصف دراسي أو الطريقة
يتيح لك "استوديو Android" تحديد إعدادات إجراء اختبار لفئة أو طريقة ثم تنفيذها. على سبيل المثال، إذا أنشأت صفًا جديدًا، يمكنك إنشاء وإجراء اختبار لذلك. إذا اجتاز الاختبار بنجاح، يمكنك عندئذٍ إجراء الاختبارات باقي مراحل المشروع للتأكد من أن الرمز الجديد لا يعطل أي شيء في مكان آخر.
يستخدم "استوديو Android" اختبارات Android Machineed أو Android JUnit. نموذج، بناءً على مصدرك ضبط لاختبار وحدة محلية، يمكنك اختياريًا تنفيذها باستخدام code والتغطية.
لإنشاء تهيئة تشغيل/تصحيح الأخطاء لفئة أو طريقة في رمز Java، اتبع الخطوات التالية:
- فتح مشروع في Android أو "طريقة عرض المشروع".
- افتح ملف Java في "محرِّر الرموز البرمجية".
- حدد فئة أو طريقة في التعليمة البرمجية، ثم اضغط على Control+Shift+T (Command+Shift+T).
- اختر إنشاء اختبار جديد من القائمة التي تظهر.
- في قسم إنشاء اختبار، يمكنك تغيير القيم أو ضبطها اختياريًا، ثم انقر على حسنًا.
- في مربع الحوار اختيار دليل الوجهة، اختَر في المشروع تريد إجراء الاختبار من خلال "استوديو Android" يمكنك تحديد الموقع من خلال بنية الدليل أو عن طريق اختيار فئة مجاورة.
- انقر على موافق.
يظهر الاختبار الجديد في نافذة مشروع في مجموعة مصادر الاختبار.
- لإجراء الاختبار، نفِّذ أحد الإجراءات التالية:
- في نافذة المشروع، انقر بزر الماوس الأيمن على الاختبار واختَر تشغيل أو تصحيح الأخطاء.
- في مُحرِّر الرموز، انقر بزر الماوس الأيمن على تعريف فئة أو اسم طريقة في ملف الاختبار اختَر تشغيل أو تصحيح الأخطاء لاختبار جميع الطرق في الصف.
- افتح القائمة المنسدلة اختيار إعداد/تصحيح الأخطاء في شريط الأدوات.
- اختَر حفظ الضبط من الخيارات بجانب الإعدادات التي
تريد حفظها.
الشكل 3. حفظ الإعدادات
تشغيل تطبيق أو تصحيح الأخطاء فيه باستخدام إعدادات محفوظة
إذا حفظت إعدادات التشغيل/تصحيح الأخطاء، يمكنك اختيارها قبل التنفيذ أو وتصحيح أخطاء تطبيقك.
لاستخدام إعدادات تشغيل/تصحيح أخطاء محفوظة، اتّبِع الخطوات التالية:
- اختَر ضبط التشغيل/تصحيح الأخطاء من اختيار إعداد التشغيل/تصحيح الأخطاء. القائمة المنسدلة داخل شريط الأدوات.
- اختيار تشغيل > تشغيل أو تشغيل > تصحيح الأخطاء:
تكمن القائمة المنسدلة على يمين تشغيل.
وتصحيح الأخطاء
;
على سبيل المثال،
.
أو انقر على تشغيل أو
تصحيح الأخطاء
تعديل إعدادات التشغيل/تصحيح الأخطاء
لتعديل إعدادات التشغيل/تصحيح الأخطاء، اتّبِع الخطوات التالية:
- افتح زر "التشغيل/تصحيح الأخطاء" مربّع حوار الإعدادات
- اختَر إعدادات في اللوحة اليمنى.
- عدِّل الإعدادات حسب الحاجة.
- انقر على تطبيق أو حسنًا.
تأكَّد من تصحيح أي أخطاء معروضة. في أسفل مربع الحوار
تعديل نموذج ضبط تشغيل/تصحيح الأخطاء
يمكنك تعديل نماذج الضبط المقدَّمة من "استوديو Android" لتناسب تطوير البرامج. عند تعديل نموذج، لا يؤثر ذلك في النماذج الحالية. من الإعدادات التي تستخدم النموذج. لذلك، على سبيل المثال، إذا كنت بحاجة إلى إنشاء من نوع معين، فيمكنك تحرير القالب ثم وإعادته مرة أخرى عند الانتهاء.
على الرغم من أنّه لا يمكنك إنشاء نماذج جديدة، يمكنك إنشاء إعدادات لاستخدامها. مشابه للقالب. يمكنك نسخ إعداد. وتحرير النسخة لإنشاء تهيئات جديدة.
لتعديل نموذج، اتبع الخطوات التالية:
- افتح زر "التشغيل/تصحيح الأخطاء" مربّع حوار الإعدادات
- انقر على تعديل نماذج الضبط....
- اختَر نموذج ضبط.
- عدِّل الإعدادات حسب الحاجة.
- انقر على تطبيق أو حسنًا.
تأكَّد من تصحيح أي أخطاء معروضة. في أسفل مربع الحوار
الفرز والتجميع الإعدادات
في مربع الحوار إعدادات التشغيل/تصحيح الأخطاء، يمكنك ترتيب من التكوينات للعثور عليها بسرعة. يمكنك فرز العناصر في المجلد أبجديًا، وإنشاء مجلدات جديدة لتجميع الإعدادات.
لترتيب الإعدادات أبجديًا، اتّبِع الخطوات التالية:
- افتح زر "التشغيل/تصحيح الأخطاء" مربّع حوار الإعدادات
- اختَر مجلدًا يحتوي على عمليات ضبط.
- انقر على ترتيب الإعدادات.
- انقر على حسنًا لإغلاق مربّع الحوار.
لتجميع الإعدادات في المجلدات، اتّبِع الخطوات التالية:
- افتح زر "التشغيل/تصحيح الأخطاء" مربّع حوار الإعدادات
- اختَر مجلدًا يحتوي على عمليات ضبط.
- انقر على إنشاء مجلد جديد.
- اكتب اسمًا في حقل اسم المجلد.
- انقر على تطبيق لحفظ الاسم.
التحديد قبل إطلاق المنتج العمليات
يمكنك تحديد المهام المطلوب تنفيذها قبل تطبيق عملية التشغيل/تصحيح الأخطاء. التكوين. يتم تنفيذ المهام بالترتيب الذي تظهر به في القائمة.
ملاحظة: يُعدّ تحديد المهام قبل الإطلاق ميزة متقدّمة. بدلاً من
باستخدام هذه الميزة، نوصيك بوضع أي منطق تحضير كمهام في
build.gradle
وسيتم تنفيذها عند الإنشاء من سطر الأوامر.
لإنشاء قائمة مهام، اتبع الخطوات التالية:
- في أسفل مربّع الحوار إعدادات التشغيل/تصحيح الأخطاء ضمن قبل الإطلاق
(قد تحتاج إلى الانتقال للأسفل)
انقر على رمز الإضافة
واختَر نوع المهمة. إذا ظهر مربع حوار، فاملأ الحقول انقر على حسنًا.
- يمكنك إضافة المزيد من المهام حسب الحاجة.
- لترتيب المهام، اسحبها أو اختَر مهمة وانقر على أعلى.
وأسفل
لنقله للأعلى أو للأسفل في القائمة.
- اختَر إظهار هذه الصفحة إذا كنت تريد عرض عملية التشغيل/تصحيح الأخطاء.
إعدادات التهيئة قبل تطبيقها.
تم إلغاء تحديد هذا الخيار بواسطة الافتراضي.
- حدِّد نافذة الأداة النشطة إذا كنت تريد
تشغيل
أو
تصحيح الأخطاء
التي سيتم تنشيطها عند تشغيل تطبيقك أو تصحيح أخطائه.
ويتم تحديد هذا الخيار تلقائيًا.
لإزالة مهمة من القائمة، اتّبِع الخطوات التالية:
- اختَر مهمة.
- انقر على إزالة.
لتعديل مهمة، اتبع الخطوات التالية:
- اختَر مهمة.
- انقر على تعديل.
- عدِّل إعدادات المهمة في مربّع الحوار الذي يفتح، ثم انقر على حسنًا.
يسرد الجدول التالي المهام المتاحة التي يمكنك إضافتها.
المهمة | الوصف |
---|---|
تشغيل الأداة الخارجية | يمكنك تشغيل تطبيق غير متوافق مع "استوديو Android". في قسم المراجع أدوات الحوار، اختَر تطبيقًا واحدًا أو أكثر تريد تشغيله. ثم انقر على حسنًا. إذا لم يتم تحديد التطبيق في نظام Android أضف تعريفه في علامة التبويب إنشاء مربّع حوار الأدوات لمزيد من المعلومات، راجع تهيئة الأدوات التابعة لجهات خارجية والمصادر الخارجية الأدوات: |
تشغيل إعداد آخر | نفِّذ أحد إعدادات التشغيل/تصحيح الأخطاء الحالية. في جلسة المعمل، مربع الحوار اختيار الإعداد المراد تنفيذه، واختيار عملية ضبط لتنفيذه، ثم انقر على حسنًا. |
إنشاء | قم بتجميع المشروع أو الوحدة. ينفِّذ Android Studio علامة التبويب Make أمر الوحدة إذا كان إعداد التشغيل/تصحيح الأخطاء يحدد وحدة معينة، أو ينفذ وضع الأمر Project إذا لم يتم تحديد أي وحدات. |
إنشاء مشروع | قم بتجميع المشروع. ينفِّذ Android Studio علامة التبويب Make أمر المشروع: |
التنفيذ، ما مِن أخطاء للتحقّق من الأخطاء | هذا الخيار مماثل لخيار الإنشاء، باستثناء إمكانية استخدام نظام Android. تنفِّذ استوديو YouTube إعدادات التشغيل/تصحيح الأخطاء بغض النظر عن التحويل البرمجي. نتيجته. |
بناء العناصر | غير متاح في "استوديو Android". |
تشغيل مهمة Gradle | قم بتشغيل مهمة Gradle. في الحوار سيظهر لك، حدِّد التفاصيل ثم انقر على حسنًا. لمزيد من المعلومات راجِع Gradle. |
التصميم المتوافق مع Gradle | قم بتجميع المشروع وتشغيل Gradle. |
أداة إنشاء Gradle لـ App Engine | تعمل مهمة إنشاء Gradle لـ App Engine على مزامنة المشروع ثم إنشاء الوحدة. |
نماذج الضبط
يوفّر "استوديو Android" نماذج ضبط لمساعدتك في البدء. بسرعة. تصف الأقسام التالية القوالب التي تنطبق على تطوير Android باستخدام "استوديو Android":
- تطبيق Android
- اختبارات Android
- DevAppServer في App Engine
- الإضافة على Wear OS والمربّع وخلفية شاشة الساعة
ملاحظة: احتوى الإصدار Android Studio 2.1.x والإصدارات الأقدم على أداة Native. نموذج التطبيق، الذي لا تتوفّر فيه الإصدارات الأحدث إذا كان لديك نموذج تطبيق محلي في المشروع، يحوّله "استوديو Android" إلى تطبيق Android عند تحميل المشروع. يرشدك مربع حوار تحويل المشروع خلال العملية.
نماذج غير متوافقة
تأتي النماذج التالية غير المتوافقة من IntelliJ IDEA وهي ليست محددة بتطوير Android باستخدام "استوديو Android". للحصول على معلومات حول استخدام هذه القوالب، اتبع الروابط المؤدية إلى وثائق IntelliJ IDEA.
- التطبيق
- مجمّع
- أداة Gradle
- رائع
- JAR التطبيق
- Java خدش
- JUnit
- Kotlin
- نص Kotlin
- تصحيح الأخطاء عن بُعد
- نص واجهة المستخدم
- اختبار NG
خيارات الضبط الشائعة
تُعد الخيارات الاسم والسماح بالتشغيل الموازي والحفظ كملف مشروع شائعة. على نماذج ضبط متعددة. لمعرفة المزيد من المعلومات عنها، يُرجى مراجعة الإعدادات الشائعة.
يخزِّن "استوديو Android" إعدادات التشغيل/تصحيح الأخطاء المشتركة في ملف XML فردي.
ضمن المجلد project_directory/.idea/runConfigurations/
.
لمزيد من المعلومات، يُرجى مراجعة
التنسيق المستند إلى الدليل في مستندات مشاريع IntelliJ
تطبيق Android
يمكنك تشغيل تطبيقات Android وأنشطته أو تصحيح الأخطاء فيها على الأجهزة الافتراضية أو الأجهزة. باستخدام الإعدادات التي تستند إلى هذا النموذج.
علامة التبويب "إعدادات عامة"
في علامة التبويب General (إعدادات عامة)، يمكنك تحديد التثبيت والتشغيل خيارات النشر تحتوي علامة التبويب متنوعات أيضًا على خيارات التثبيت.
الحقل | الوصف |
---|---|
الوحدة | اختَر الوحدة لتطبيق هذه الإعدادات عليه. |
خيارات التثبيت: نشر | حدِّد خيارًا:
|
خيارات التثبيت: نشر كتطبيق فوري | إذا كان تطبيقك يتيح التجارب الفورية، سيكون عليك إضافة إمكانية تثبيت التطبيقات الفورية. عند إنشاء مشروع جديد أو إنشاء واحد أو أكثر مفعّلة بشكل فوري وحدات الميزات: يمكنك اختيار نشر تلك الوحدات التي تم تفعيل ميزة التطبيقات الفورية فيها عن طريق مراجعة بجانب نشر كتطبيق فوري. |
خيارات التثبيت: الميزات المطلوب نشرها |
إذا كان تطبيقك يتضمن
وحدات الميزات
ضع علامة في المربع بجانب كل ميزة تريد تضمينها عند نشر تطبيقك. سترى
هذا الخيار فقط إذا كان تطبيقك يتضمّن وحدات ميزات.
ملاحظة: إذا كنت تريد اختبار تنزيل وحدات الميزات وتثبيتها على عليك إجراء ذلك بعد نشر حِزمة تطبيقك ثم استخدام Play Console مسار الاختبار الداخلي. لمزيد من المعلومات، يُرجى قراءة تحميل حِزمة تطبيقك إلى Play Console. |
خيارات التثبيت: تثبيت العلامات | اكتب أي خيارات Adb pm
install تريد استخدامها. قم بتنسيق الخيارات بنفس الطريقة التي تستخدمها في
سطر الأوامر، ولكن بدون مسار. في ما يلي بعض الأمثلة:
و
الإعداد التلقائي: لا تتوفّر خيارات. |
خيارات الإطلاق: الإطلاق | حدِّد خيارًا:
|
خيارات الإطلاق: علامات الإطلاق | اكتب أي خيارات Adb am
start تريد استخدامها. قم بتنسيق الخيارات بنفس الطريقة التي تستخدمها في
سطر الأوامر، ولكن بدون نية. مثلاً:
ولا يظهر هذا الخيار إذا اخترت قيمة إطلاق لا شيء. الإعداد التلقائي: لا تتوفّر خيارات. |
خيارات هدف النشر: الهدف | حدِّد خيارًا:
|
خيارات هدف النشر: استخدام الجهاز نفسه مع عمليات الإطلاق المستقبلية |
يتم إلغاء تحديد هذا الخيار تلقائيًا، فعند تشغيل تطبيق، يتم إلغاء تحديد
سيظهر مربّع حوار النشر لاختيار جهاز. عند تحديد هذا الخيار
بعد ذلك تشغيل تطبيق، سيظهر لك مربّع الحوار اختيار نشر لاختيار جهاز. بعد ذلك، يُرجى اتّباع الخطوات التالية:
وفي كل مرة تقوم فيها بتشغيل التطبيق، يتم تشغيله على الجهاز الذي حددته دون عرض
مربّع حوار اختيار النشر لتشغيل التطبيق على جهاز مختلف، عليك إلغاء تحديد استخدام
الجهاز نفسه لعمليات التشغيل المستقبلية، أو إيقاف التطبيق من خلال تشغيل > إيقاف app
أو إيقاف ![]() |
قبل الإطلاق | راجع التعريف قبل الإطلاق العمليات. |
علامة تبويب متنوعة
في علامة التبويب متنوعات، يمكنك تحديد Logcat، خيارات التثبيت والإطلاق والنشر. علامة التبويب الإعدادات العامة يحتوي أيضًا على خيارات التثبيت.
الحقل | الوصف |
---|---|
Logcat: عرض Logcat تلقائيًا | عند تحديد هذا الخيار، يتم فتح نافذة Logcat في كل مرة. نشر تطبيق وإطلاقه بنجاح باستخدام هذه الإعدادات. الإعداد التلقائي: تم اختياره. |
Logcat: محو السجلّ قبل التشغيل | حدِّد هذا الخيار إذا كنت تريد من "استوديو Android" إزالة البيانات من الجلسات السابقة من ملف السجل قبل بدء التطبيق. الإعداد التلقائي: تم إلغاء الاختيار. |
خيارات التثبيت: يمكنك تخطّي التثبيت في حال عدم تغيير حزمة APK. | عند تحديده، لا يعيد "استوديو Android" نشر ملف APK إذا اكتشف أنه لم يتم تغييره. إذا أردت أن يفرض "استوديو Android" تثبيت حزمة APK، حتى لو لم تتغير ثم إلغاء تحديد هذا الخيار. الإعداد التلقائي: تم اختياره |
خيارات التثبيت: فرض إيقاف التطبيق قبل تشغيله النشاط | إذا تم اختياره، عندما يكتشف "استوديو Android" أنه لا يجب إعادة تثبيت حزمة APK لأنها لم تتغير، ستُفرض إيقاف التطبيق حتى بدء تشغيل التطبيق من نشاط المشغّل التلقائي. إذا تم إلغاء تحديد هذا الخيار، ولا يتم فرض إيقاف التطبيق من خلال "استوديو Android". ويعمل هذا الخيار مع الخيار السابق الذي يتحكّم في ما إذا تثبيت حزمة APK أم لا. لكل من خيارَي التثبيت فاتركها على الوضع الافتراضي ما لم تكن تريد فرض التثبيت بشكل صريح في كل مرة. وفي بعض الحالات، قد تحتاج إلى إلغاء تحديد هذا الخيار. على سبيل المثال، إذا كنت فإن كتابة محرك أسلوب الإدخال (IME)، ويؤدي إيقاف التطبيق إلى إلغاء تحديده باعتباره لوحة المفاتيح الحالية، والتي قد لا تريدها. الإعداد التلقائي: تم اختياره |
قبل الإطلاق | راجع تحديد قبل إطلاق العمليات. |
علامة تبويب "برنامج تصحيح الأخطاء"
حدِّد خيارات تصحيح الأخطاء في علامة التبويب برنامج تصحيح الأخطاء.
بالنسبة إلى رمزَي C وC++ ، يستخدم "استوديو Android" برنامج تصحيح الأخطاء LLDB. بالإضافة إلى المعدل الطبيعي واجهة مستخدم "استوديو Android"، نافذة برنامج تصحيح الأخطاء تحتوي على علامة تبويب LLDB إدخال أوامر LLDB أثناء تصحيح الأخطاء. يمكنك إدخال الطلبات نفسها التي يستخدمها "استوديو Android" لعرض المعلومات في واجهة مستخدم برنامج تصحيح الأخطاء، ويمكنك تنفيذ والعمليات الإضافية.
بالنسبة إلى مشاريع C وC++، يمكنك إضافة أدلة رموز، وكذلك بدء تشغيل LLDB وانشر الأوامر بعد إرفاقها في علامة التبويب برنامج تصحيح الأخطاء. للقيام بذلك، يمكنك استخدام الأزرار المشابهة لما يلي:
- إضافة
- أضِف دليلاً أو أمرًا.
- إزالة
- حدد دليلاً أو أمرًا، ثم انقر فوق هذا الزر لإزالة العنصر.
- أعلى
- حدد دليلاً أو أمرًا، ثم انقر فوق هذا الزر لنقل العنصر لأعلى من القائمة.
- أسفل
- حدد دليلاً أو أمرًا، ثم انقر فوق هذا الزر لنقل العنصر إلى أسفل من القائمة.
راجع تصحيح أخطاء التطبيق لمزيد من المعلومات حول تصحيح الأخطاء في "استوديو Android".
الحقل | الوصف |
---|---|
نوع تصحيح الأخطاء | حدِّد أحد الخيارات التالية:
يُنصح باستخدام الخيار الرصد تلقائيًا لأنّه يحدّد نوع تصحيح الأخطاء الصحيح لمشروعك. |
دلائل الرموز | إذا كنت ترغب في إضافة ملفات رموز لتزويد برنامج تصحيح الأخطاء بـ C أو C++ المعلومات التي يتم إنشاؤها خارج "استوديو Android"، يمكنك إضافة عنصر واحد أو أكثر أدلة هنا. يفضّل "استوديو Android" استخدام أي ملفات ضمن هذه الأدلة على الملفات التي تم إنشاؤها بواسطة أجهزة Android المكوّن الإضافي لنظام Gradle يبحث برنامج تصحيح الأخطاء في الأدلة من أعلى إلى أسفل، بالترتيب، حتى تجد ما يحتاج إليه. فهي تبحث بشكل متكرر خلال الملفات في الدليل. لتحسين القائمة وتوفير الوقت، ضع الأدلة يتم استخدامها في الغالب باتجاه أعلى القائمة. إذا حددت دليلاً مرتفعًا في الشجرة، فقد يستغرق البحث في جميع الأدلة الفرعية. إذا أضفت دليلاً خاصًا جدًا، فستستغرق عملية بحث. تحتاج إلى إيجاد التوازن الصحيح بين السرعة والعثور على الملفات التي تحتاجها لتصحيح الأخطاء. على سبيل المثال، إذا كان لديك دليل يحتوي على أدلة فرعية لمختلف برنامج ثنائي Android الواجهات (ABI)، يمكنك اختيار إضافة دليل لواجهة 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 Widgeted. القالب. للحصول على معلومات عن علامات التبويب والحقول في نموذج اختبار Android JUnit، يمكنك الاطّلاع على IntelliJ التشغيل/تصحيح الأخطاء صفحة الإعدادات: JUnit
علامة التبويب "إعدادات عامة"
في علامة التبويب الإعدادات العامة، يمكنك تحديد الموقع الجغرافي للاختبار. مُعدِل الأدوات، وأداة adb Shell، وخيارات النشر.
الحقل | الوصف |
---|---|
الوحدة | اختيار وحدة لتطبيق هذه الإعدادات عليه. |
الاختبار | في هذه المنطقة، حدِّد موقع الاختبارات التي تريد إجراؤها:
|
أداة تشغيل أدوات محددة (اختياري) | اكتب موقع الأداة
عدّاء انقر على المزيد لاستخدام مربّع حوار. تشير رسالة الأشكال البيانية
ملف build.gradle يحدد موقع الأداة
عدّاء هذه القيمة تتجاوزها. تكون القيمة التلقائية عادةً AndroidJUnitRunner .
الصف من اختبار AndroidX.
|
خيارات إضافية | اكتب أي خيارات Adb تلقائي: ما مِن خيارات |
خيارات هدف النشر: الهدف | حدِّد خيارًا:
|
خيارات هدف النشر: استخدام الجهاز نفسه مع عمليات الإطلاق المستقبلية | إذا كنت تريد أن تستخدم تلقائيًا الجهاز الذي اخترته من خلال في المستقبل، اختَر مربّع الحوار اختيار هدف النشر، واختَر هذا الخيار. الخيار. إذا لم يكن الجهاز متاحًا، سيظهر لك مربّع حوار. الإعداد التلقائي: تم إلغاء الاختيار |
قبل الإطلاق | راجع التعريف قبل الإطلاق العمليات. |
علامة تبويب متنوعة
تتضمّن علامة التبويب متنوعات أداة 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" استخدام أي ملفات ضمن هذه الأدلة على الملفات التي تم إنشاؤها بواسطة أجهزة Android المكوّن الإضافي لنظام Gradle يبحث برنامج تصحيح الأخطاء في الأدلة من أعلى إلى أسفل، بالترتيب، حتى تجد ما يحتاج إليه. فهي تبحث بشكل متكرر خلال الملفات في الدليل. لتحسين القائمة وتوفير الوقت، ضع الأدلة يتم استخدامها في الغالب باتجاه أعلى القائمة. إذا حددت دليلاً مرتفعًا في الشجرة، فقد يستغرق البحث في جميع الأدلة الفرعية. إذا أضفت دليلاً خاصًا جدًا، فستستغرق عملية بحث. تحتاج إلى إيجاد التوازن الصحيح بين السرعة والعثور على الملفات التي تحتاجها لتصحيح الأخطاء. على سبيل المثال، إذا كان لديك دليل يحتوي على أدلة فرعية لمختلف برنامج ثنائي Android الواجهات (ABI)، يمكنك اختيار إضافة دليل لواجهة 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
من أجلك.
يُرجى العلم أنّ تطبيق IntellJ IDEA نموذج خادم المحرك هو نموذج مختلف غير متاح في "استوديو Android".
الحقل | الوصف |
---|---|
نسخة افتراضية واحدة فقط | إذا كنت تريد التأكّد من أنّ عملية التشغيل/تصحيح الأخطاء تتم من خلال مثيل واحد فقط تم تنفيذ الإعداد حاليًا، حدِّد هذا الخيار. عدم السماح عمليات تشغيل متعددة لنفس الإعدادات في نفس الوقت. الإعداد التلقائي: تم اختياره |
الوحدة | اختيار وحدة لتطبيق هذه الإعدادات عليه. |
المزامنة مع إعداد Build.gradle | إذا أضفت وحدة App Engine وأجريت المزامنة مع build.gradle
، يتم ملء حقول إعداد App Engine DevAppServer من أجلك (يُنصح بذلك).
تحديد ملف > تؤدي "مزامنة المشروع مع ملفات Gradle" إلى مزامنة المشروع أيضًا. الإعداد التلقائي: تم اختياره
|
حزمة تطوير البرامج لـ App Engine | اكتب مسارًا إلى Google حزمة تطوير برامج App Engine لـ Java على الجهاز المحلي انقر على ... لاختياره. من مربع حوار. |
مسار الحرب | اكتب مسارًا إلى تطبيق الويب دليل الأرشيف (WAR) للتطبيق الذي تنشره على خادم تطوير محلي. انقر على ... لاختياره من مربّع حوار. |
وسيطات الجهاز الافتراضي | حدِّد خيارات سطر الأوامر التي تريد تمريرها إلى الجهاز الافتراضي (VM) من أجل إطلاق 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=19&hl=ar)