لمعرفة كيف يبدو تطبيقك ويعمل على جهاز، عليك إنشاؤه وتشغيله. يُعدّ استوديو Android مشاريع جديدة تتيح لك تفعيل تطبيقك على جهاز افتراضي أو جهاز فعلي ببضع نقرات فقط.
تركّز هذه النظرة العامة على كيفية استخدام "استوديو Android" لإنشاء تطبيقك وتشغيله لأغراض الاختبار وتصحيح الأخطاء. للحصول على معلومات حول كيفية استخدام "استوديو Android" لإنشاء تطبيقك حتى يمكن إصداره للمستخدمين، يُرجى الاطّلاع على إنشاء تطبيقك لإصداره للمستخدمين. لمزيد من المعلومات التفصيلية حول إدارة عملية الإنشاء وتخصيصها باستخدام "استوديو Android" أو بدونه، يمكنك الاطّلاع على ضبط عملية الإنشاء.
الإنشاء والتشغيل الأساسيان
لإنشاء تطبيقك وتشغيله، اتّبِع الخطوات التالية:
- في شريط الأدوات، اختَر تطبيقك من قائمة إعدادات التشغيل.
في قائمة أجهزة الاختبار، اختَر الجهاز الذي تريد تشغيل تطبيقك عليه.
قائمة "جهاز الاختبار" في شريط أدوات "استوديو Android" إذا لم يكن لديك أي أجهزة تم ضبطها، عليك إما إنشاء جهاز افتراضي متوافق مع Android لاستخدام Android Emulator أو توصيل جهاز فعلي.
انقر على تشغيل
.
يحذّرك "استوديو Android" إذا حاولت تشغيل مشروعك على جهاز يتضمّن خطأ أو تحذيرًا مرتبطًا به. تساعد التغييرات في الأيقونات والأسلوب في التمييز بين الأخطاء (اختيارات الأجهزة التي تؤدي إلى إعدادات معطّلة) والتحذيرات (اختيارات الأجهزة التي قد تؤدي إلى سلوك غير متوقّع ولكنها لا تزال قابلة للتشغيل).
مراقبة عملية الإنشاء
للاطّلاع على تفاصيل حول عملية الإنشاء، اختَر عرض > نوافذ الأدوات > إنشاء أو انقر على إنشاء 
في شريط نافذة الأدوات. تعرض نافذة أداة الإنشاء المهام التي ينفّذها Gradle لإنشاء تطبيقك، كما هو موضّح في الشكل 1.
- علامة التبويب "مزامنة" (Sync): تعرض المهام التي ينفّذها Gradle للمزامنة مع ملفات مشروعك. على غرار علامة التبويب مخرجات الإصدار، إذا واجهت خطأ في المزامنة، اختَر عناصر في العرض التدرّجي للحصول على مزيد من المعلومات حول الخطأ. ويعرض أيضًا ملخّصًا لتأثير عمليات التنزيل لتحديد ما إذا كانت عمليات تنزيل التبعيات تؤثر سلبًا في عملية الإنشاء.
- علامة التبويب "مخرجات الإصدار" (Build Output): تعرض المهام التي ينفّذها Gradle على شكل شجرة،
حيث يمثّل كل جزء إما مرحلة إصدار أو مجموعة
من تبعيات المهام. إذا تلقّيت أخطاء في وقت الإنشاء أو وقت التجميع،
افحص الشجرة واختَر عنصرًا لقراءة مخرجات الخطأ، كما هو موضّح في
الشكل 2.
الشكل 2. افحص علامة التبويب Build Output (ناتج الإصدار) بحثًا عن رسائل الخطأ. - علامة التبويب "أداة تحليل الإصدار": توفّر معلومات تحليل أداء الإصدار. لمزيد من المعلومات، يمكنك الاطّلاع على مقالة تحديد مشاكل أداء الإصدار وحلّها باستخدام "أداة تحليل الإصدار".
- إعادة التشغيل: ينفّذ آخر إجراء إنشاء مرة أخرى. إذا كان آخر أمر نفّذته هو Build > Make Selected Module، سيتم إنشاء الوحدة الحالية. إذا كان آخر إجراء نفّذته هو إنشاء > إنشاء مشروع، سيتم إنشاء ملفات إصدار وسيطة لجميع الوحدات في مشروعك.
- الفلاتر: لفلترة التحذيرات أو المهام أو كليهما التي اكتملت بنجاح يمكن أن يسهّل ذلك العثور على المشاكل في الناتج.
إذا كانت تنويعات التصميم تستخدم صيغ المنتجات، يستدعي Gradle أيضًا مهامًا لإنشاء صيغ المنتجات هذه. للاطّلاع على قائمة بجميع مهام الإصدار المتاحة،
انقر على عرض > نوافذ الأدوات > Gradle أو انقر على Gradle
في شريط نافذة الأدوات.
في حال حدوث خطأ أثناء عملية الإنشاء، قد يقترح Gradle خيارات سطر الأوامر لمساعدتك في حلّ المشكلة، مثل --stacktrace أو --debug. لاستخدام خيارات سطر الأوامر
مع عملية الإنشاء:
- افتح مربّع الحوار الإعدادات أو الإعدادات المفضّلة:
- على نظام التشغيل Windows أو Linux، اختَر ملف > الإعدادات من شريط القوائم.
- على نظام التشغيل macOS، اختَر استوديو Android > الإعدادات المفضّلة من شريط القوائم.
- انتقِل إلى Build, Execution, Deployment > Compiler (الإنشاء والتنفيذ والنشر > برنامج التجميع).
- في حقل النص بجانب خيارات سطر الأوامر، أدخِل خيارات سطر الأوامر.
- انقر على حسنًا للحفظ والخروج.
يطبّق Gradle خيارات سطر الأوامر هذه في المرة التالية التي تحاول فيها إنشاء تطبيقك.
إنشاء التطبيقات وتشغيلها باستخدام وكيل الذكاء الاصطناعي
يستطيع وكيل الذكاء الاصطناعي في استوديو Android الوصول إلى الأدوات التي تتيح له إنشاء تطبيقك ونشره، ثم التحقّق من حالة التطبيق نيابةً عنك. عند استخدام وضع الوكيل، يمكن للوكيل تنفيذ مهام مثل:
- انشر تطبيقك على جهاز فعلي أو محاكي متصل.
- افحص الشاشة والتقِط لقطات شاشة للتحقّق من التغييرات في واجهة المستخدم.
- راجِع Logcat بحثًا عن أخطاء أثناء التشغيل أو رسائل مسجّلة معيّنة.
- تفاعَل مع تطبيقك باستخدام طلبات
adb shellللتنقّل أو إدخال البيانات.
يُعدّ استخدام وكيل الذكاء الاصطناعي لإنشاء تطبيقك وتشغيله مفيدًا للمهام متعدّدة المستويات التي يحتاج فيها الوكيل إلى إجراء تغييرات بشكل متكرّر والتحقّق من أنّها تعمل على النحو المتوقّع.
ميزات متقدّمة لإنشاء التطبيقات وتشغيلها
من المفترض أن تكون الطريقة التلقائية لإنشاء تطبيقك وتشغيله في "استوديو Android" كافية لاختبار التطبيق، ولكن يمكنك استخدام ميزات الإنشاء والتشغيل هذه لحالات الاستخدام الأكثر تقدّمًا:
لنشر تطبيقك في وضع تصحيح الأخطاء، انقر على تصحيح الأخطاء (Debug)
.
يتيح لك تشغيل تطبيقك في وضع تصحيح الأخطاء إمكانية ضبط نقاط توقّف في الرمز البرمجي، وفحص المتغيّرات وتقييم التعبيرات في وقت التشغيل، وتشغيل أدوات تصحيح الأخطاء. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تصحيح أخطاء تطبيقك.إذا كان لديك تطبيق أكبر حجمًا وأكثر تعقيدًا، استخدِم ميزة "تطبيق التغييرات" بدلاً من النقر على تشغيل
. يوفر هذا الوقت، لأنك تتجنب إعادة تشغيل
تطبيقك في كل مرة تريد فيها نشر تغيير. لمزيد من المعلومات حول ميزة "تطبيق التغييرات"، يُرجى الاطّلاع على قسم النشر بشكل تدريجي باستخدام ميزة "تطبيق التغييرات".إذا كنت تستخدم Jetpack Compose، فإنّ ميزة "التعديل في الوقت الفعلي" هي ميزة تجريبية تتيح لك تعديل الدوال المركّبة في الوقت الفعلي بدون النقر على تشغيل
مرة أخرى. يتيح لك ذلك التركيز على كتابة رمز واجهة المستخدم بأقل قدر من المقاطعة. لمزيد من المعلومات، يُرجى الاطّلاع على قسم التعديل المباشر (تجريبي).إذا كان لديك تطبيق يتضمّن عدة تنويعات أو إصدارات للتصميم، يمكنك اختيار تنويعة التصميم التي تريد نشرها باستخدام نافذة أدوات تنويعات التصميم. لمزيد من المعلومات حول تشغيل تنويعة تصميم معيّنة، يُرجى الاطّلاع على قسم تغيير تنويعة التصميم.
لضبط خيارات تثبيت التطبيق وتشغيله واختباره بدقة، يمكنك تغيير إعدادات التشغيل/تصحيح الأخطاء. لمزيد من المعلومات حول إنشاء إعدادات مخصّصة للتشغيل/تصحيح الأخطاء، يُرجى الاطّلاع على قسم إنشاء إعدادات التشغيل/تصحيح الأخطاء.
ننصحك باستخدام "استوديو Android" لتلبية احتياجات التطوير، ولكن يمكنك أيضًا نشر تطبيقك على جهاز افتراضي أو فعلي من سطر الأوامر. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء تطبيقك من سطر الأوامر.
النشر بشكل تدريجي باستخدام ميزة "تطبيق التغييرات"
في الإصدار 3.5 من استوديو Android والإصدارات الأحدث، تتيح لك ميزة "تطبيق التغييرات" إرسال تغييرات الرموز البرمجية والموارد إلى تطبيقك قيد التشغيل بدون إعادة تشغيل التطبيق، وفي بعض الحالات، بدون إعادة تشغيل النشاط الحالي. تساعدك هذه المرونة في التحكّم في مقدار إعادة تشغيل تطبيقك عندما تريد نشر واختبار التغييرات الصغيرة المتزايدة مع الحفاظ على الحالة الحالية لجهازك.
تستخدم ميزة "تطبيق التغييرات" إمكانات في تنفيذ واجهة JVMTI لنظام التشغيل Android المتوافقة مع الأجهزة التي تعمل بالإصدار 8.0 من نظام التشغيل Android (مستوى واجهة برمجة التطبيقات 26) أو الإصدارات الأحدث. لمزيد من المعلومات حول آلية عمل ميزة "تطبيق التغييرات"، يُرجى الاطّلاع على مقالة مشروع "ماربل" في "استوديو Android": تطبيق التغييرات.
المتطلبات
لا تتوفّر إجراءات "تطبيق التغييرات" إلا عند استيفاء الشروط التالية:
- يمكنك إنشاء حزمة APK لتطبيقك باستخدام تنويعة تصميم مخصّصة لتصحيح الأخطاء.
- نشر تطبيقك على جهاز اختبار أو محاكي يعمل بنظام التشغيل Android 8.0 (المستوى 26 من واجهة برمجة التطبيقات) أو إصدار أحدث
استخدام ميزة "تطبيق التغييرات"
استخدِم الخيارات التالية عندما تريد نشر التغييرات على جهاز متوافق:
تطبيق التغييرات وإعادة تشغيل النشاط 
: يحاول هذا الخيار تطبيق التغييرات على الموارد والرموز البرمجية من خلال إعادة تشغيل النشاط بدون إعادة تشغيل التطبيق. بشكل عام، يمكنك استخدام هذا الخيار عند تعديل الرمز البرمجي في نص طريقة أو تعديل مورد حالي.
يمكنك أيضًا تنفيذ هذا الإجراء بالضغط على Control+Alt+F10 (Control+Command+Shift+R على نظام التشغيل macOS).
تطبيق تغييرات الرمز 
: يحاول تطبيق تغييرات الرمز فقط بدون إعادة تشغيل أي شيء. بشكل عام، يمكنك استخدام هذا الخيار عندما تعدّل الرمز في نص إحدى الطرق بدون تعديل أي موارد. إذا عدّلت كلاً من الرمز والموارد، استخدِم
تطبيق التغييرات وإعادة تشغيل النشاط بدلاً من ذلك.
يمكنك أيضًا تنفيذ هذا الإجراء من خلال الضغط على Control+F10 (Control+Command+R على نظام التشغيل macOS).
تشغيل : يتم نشر جميع التغييرات وإعادة تشغيل التطبيق. استخدِم هذا الخيار عندما يتعذّر تطبيق التغييرات التي أجريتها باستخدام أي من خيارَي "تطبيق التغييرات". لمزيد من المعلومات حول أنواع التغييرات التي تتطلّب إعادة تشغيل التطبيق، يُرجى الاطّلاع على قسم قيود ميزة "تطبيق التغييرات".
تفعيل خيار "تشغيل الإجراء الاحتياطي" (run fallback) لميزة "تطبيق التغييرات" (Apply Changes)
عند النقر على تطبيق التغييرات وإعادة تشغيل النشاط أو
تطبيق تغييرات الرمز، ينشئ "استوديو Android" حزمة APK جديدة ويحدّد ما إذا كان يمكن تطبيق التغييرات. إذا تعذّر تطبيق التغييرات وأدّى ذلك إلى تعذُّر استخدام ميزة "تطبيق التغييرات"، سيطلب منك استوديو Android تشغيل تطبيقك مرة أخرى بدلاً من ذلك.
إذا كنت لا تريد أن تظهر لك رسالة في كل مرة يحدث فيها ذلك، يمكنك ضبط "استوديو Android" لإعادة تشغيل تطبيقك تلقائيًا عندما يتعذّر تطبيق التغييرات. لتفعيل هذا السلوك، اتّبِع الخطوات التالية:
افتح مربّع الحوار الإعدادات أو الإعدادات المفضّلة:
- على نظام التشغيل Windows أو Linux، اختَر ملف > الإعدادات من القائمة.
- على نظام التشغيل macOS، اختَر استوديو Android > الإعدادات المفضّلة من القائمة.
انتقِل إلى Build, Execution, Deployment > Deployment (الإنشاء والتنفيذ والنشر > النشر).
ضَع علامة في مربّعات الاختيار لتفعيل ميزة "التشغيل التلقائي الاحتياطي" لأحد إجراءَي "تطبيق التغييرات" أو كليهما.
انقر على موافق.
التغييرات التي تعتمد على المنصة
تعتمد بعض ميزات "تطبيق التغييرات" على إصدارات معيّنة من نظام Android الأساسي. لتطبيق هذه الأنواع من التغييرات، يجب نشر تطبيقك على جهاز يعمل بهذا الإصدار من Android (أو إصدار أحدث). على سبيل المثال، تتطلب إضافة طريقة الإصدار Android 11 أو إصدار أحدث.
القيود المفروضة على تطبيق التغييرات
تم تصميم ميزة "تطبيق التغييرات" لتسريع عملية نشر التطبيق. ومع ذلك، هناك بعض القيود على وقت استخدامه.
تغييرات الرموز التي تتطلّب إعادة تشغيل التطبيق
لا يمكن تطبيق بعض التغييرات في الرموز البرمجية والموارد إلا بعد إعادة تشغيل التطبيق، بما في ذلك ما يلي:
- إضافة حقل أو إزالته
- إزالة طريقة
- تغيير توقيعات الطرق
- تغيير معدِّلات الطرق أو الفئات
- تغيير اكتساب الفئة
- تغيير القيم في التعدادات
- إضافة مرجع أو إزالته
- تغيير بيان التطبيق
- تغيير المكتبات المجمّعة من رموز برمجية أصلية (ملفات SO)
المكتبات والمكوّنات الإضافية
تُجري بعض المكتبات والمكوّنات الإضافية تغييرات تلقائيًا على ملفات بيان تطبيقك أو على الموارد المُشار إليها في البيان. يمكن أن تتداخل هذه التحديثات التلقائية مع ميزة "تطبيق التغييرات" بالطرق التالية:
- إذا أجرت مكتبة أو مكوّن إضافي تغييرات على ملف بيان تطبيقك، لن تتمكّن من استخدام ميزة "تطبيق التغييرات". يجب إعادة تشغيل التطبيق للاطّلاع على التغييرات.
- إذا أجرت مكتبة أو مكوّن إضافي تغييرات على ملفات موارد تطبيقك، لن تتمكّن من استخدام ميزة تطبيق تغييرات الرمز . يجب استخدام تطبيق التغييرات وإعادة تشغيل النشاط
(أو إعادة تشغيل تطبيقك) للاطّلاع على التغييرات.
لتجنُّب هذه القيود، عليك إيقاف جميع التحديثات التلقائية لتنويعات التصميم المخصّصة لتصحيح الأخطاء.
على سبيل المثال، تعمل أداة Firebase Crashlytics على تحديث موارد التطبيق باستخدام معرّف إصدار فريد أثناء كل عملية إنشاء، ما يمنعك من استخدام ميزة تطبيق تغييرات الرمز البرمجي ويتطلّب منك إعادة تشغيل نشاط تطبيقك للاطّلاع على التغييرات. يمكنك إيقاف هذا السلوك لاستخدام ميزة
تطبيق تغييرات الرمز إلى جانب Crashlytics مع الإصدارات المخصّصة لتصحيح الأخطاء.
رمز برمجي يشير مباشرةً إلى محتوى في ملف APK مثبَّت
إذا كان الرمز البرمجي يشير مباشرةً إلى محتوى من حزمة APK الخاصة بتطبيقك والمثبّتة على
الجهاز، يمكن أن يتسبّب هذا الرمز في حدوث أعطال أو أخطاء بعد النقر على تطبيق تغييرات
الرمز البرمجي . يحدث هذا السلوك لأنّه عند النقر على تطبيق تغييرات الرمز، يتم استبدال حزمة APK الأساسية على الجهاز أثناء التثبيت. في هذه الحالات، يمكنك النقر على تطبيق التغييرات وإعادة تشغيل النشاط أو تشغيل بدلاً من ذلك.
إذا واجهت أي مشاكل أخرى أثناء استخدام ميزة "تطبيق التغييرات"، يُرجى الإبلاغ عن خطأ.
التعديل في الوقت الفعلي
"التعديل المباشر" هي ميزة تجريبية في استوديو Android تتيح لك تحديث الدوال المركّبة في المحاكيات والأجهزة الفعلية في الوقت الفعلي. تساعد هذه الوظيفة في تقليل تبديل السياق بين كتابة التطبيق وإنشائه، ما يتيح لك التركيز على كتابة الرموز البرمجية لفترة أطول بدون انقطاع.
مزيد من المعلومات حول ميزة "التعديل المباشر"
تغيير تنويعة التصميم
ينشئ "استوديو Android" تلقائيًا إصدار تصحيح الأخطاء من تطبيقك، وهو مخصّص للاستخدام أثناء عملية التطوير فقط، وذلك عند النقر على تشغيل 
.
لتغيير تنويعة التصميم التي يستخدمها "استوديو Android"، اتّبِع إحدى الخطوات التالية:
- اختَر إنشاء > اختيار تنويعة التصميم في القائمة.
- اختَر عرض > نوافذ الأدوات > تنويعات التصميم في القائمة.
- انقر على علامة التبويب تنويعات التصميم في شريط نافذة الأدوات.
بالنسبة إلى المشاريع التي لا تتضمّن رمزًا برمجيًا أصليًا أو رمز C++، تحتوي لوحة تنويعات التصميم على عمودَين: الوحدة وتنويعة التصميم النشطة. تحدّد قيمة Active Build Variant للوحدة تنويعة التصميم التي تنشرها بيئة التطوير المتكاملة على جهازك المتصل، وتظهر في المحرِّر.
للتبديل بين التنويعات، انقر على خلية تنويعة التصميم النشطة لوحدة معيّنة واختَر التنويعة التي تريدها من القائمة.
بالنسبة إلى المشاريع التي تتضمّن رمزًا برمجيًا أصليًا أو رمز C++، تحتوي لوحة تنويعات التصميم على ثلاثة أعمدة:
- الوحدة
- تنويعة التصميم النشطة
- واجهة ABI النشطة
تحدّد قيمة Active Build Variant للوحدة تنويعة التصميم التي تنشرها بيئة التطوير المتكاملة (IDE) على جهازك وتظهر في المحرِّر. بالنسبة إلى الوحدات الأصلية، تحدّد قيمة واجهة ABI النشطة واجهة ABI التي يستخدمها المحرِّر، ولكنّها لا تؤثر في ما يتم نشره.
لتغيير تنويعة التصميم أو واجهة ABI، انقر على الخلية في عمود تنويعة التصميم النشطة أو واجهة ABI النشطة واختَر التنويعة أو واجهة ABI التي تريدها من القائمة. بعد تغيير الاختيار، تتم مزامنة مشروعك تلقائيًا في بيئة التطوير المتكاملة (IDE). يؤدي تغيير أي من العمودين لتطبيق أو وحدة مكتبة إلى تطبيق التغيير على جميع الصفوف التابعة.
بشكل تلقائي، يتم إعداد المشاريع الجديدة باستخدام تنويعتَي تصميم: تنويعة تصحيح الأخطاء وتنويعة الإصدار. عليك إنشاء صيغة الإصدار من أجل إعداد تطبيقك للإصدار العلني. لتحديد صيغ أخرى من تطبيقك بميزات أو متطلبات أجهزة مختلفة، يمكنك تحديد تنويعات تصميم إضافية.
التعارضات في مربّع حوار "تنويعات التصميم" في "استوديو Android"
في مربّع الحوار تنويعات التصميم في "استوديو Android"، قد تظهر لك رسائل خطأ تشير إلى تعارضات بين تنويعات التصميم، مثل ما يلي:
لا يشير هذا الخطأ إلى مشكلة في الإصدار مع Gradle. ويشير ذلك إلى أنّ بيئة التطوير المتكاملة في استوديو Android لا يمكنها حلّ الرموز بين نُسخ الوحدات المحدّدة.
على سبيل المثال، إذا كان لديك وحدة M1 تعتمد على الصيغة v1 من الوحدة
M2، ولكن تم اختيار الصيغة v2 للوحدة M2 في بيئة التطوير المتكاملة، ستظهر لك رموز لم يتم حلّها
في بيئة التطوير المتكاملة. لنفترض أنّ M1 يعتمد على فئة متوفّرة فقط في v1. عند اختيار v2، لا تكون هذه الفئة معروفة لبيئة التطوير المتكاملة (IDE). وبالتالي، يتعذّر حلّ اسم الفئة وتظهر أخطاء في رمز الوحدة M1.
تظهر رسائل الخطأ هذه لأنّ بيئة التطوير المتكاملة لا يمكنها تحميل الرمز لعدة صيغ في الوقت نفسه. ومع ذلك، بالنسبة إلى إصدار تطبيقك، لا يكون للنسخة المحدّدة في مربّع الحوار هذا أي تأثير، لأنّ Gradle ينشئ تطبيقك باستخدام الرمز المصدر المحدّد في وصفات إصدار Gradle، وليس استنادًا إلى ما تم تحميله حاليًا في بيئة التطوير المتكاملة (IDE).
تغيير إعدادات التشغيل/تصحيح الأخطاء
عند تشغيل تطبيقك لأول مرة، يستخدم "استوديو Android" إعدادات تشغيل تلقائية. تحدّد إعدادات التشغيل ما إذا كان سيتم نشر تطبيقك من حزمة APK أو مجموعة حزمات تطبيق Android، بالإضافة إلى الوحدة المطلوب تشغيلها والحزمة المطلوب نشرها والنشاط المطلوب بدؤه وجهاز الاختبار وإعدادات المحاكي وخيارات Logcat والمزيد.
تُنشئ إعدادات التشغيل/تصحيح الأخطاء التلقائية حزمة APK، وتُطلق نشاط المشروع التلقائي، وتستخدم مربّع حوار اختيار هدف النشر لاختيار جهاز الاختبار. إذا كانت الإعدادات التلقائية لا تناسب مشروعك أو وحدتك، يمكنك تخصيص إعدادات التشغيل/تصحيح الأخطاء أو إنشاء إعدادات جديدة على مستوى المشروع والإعدادات التلقائية والوحدة.
لتعديل إعدادات التشغيل/تصحيح الأخطاء، اختَر تشغيل > تعديل الإعدادات. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء إعدادات التشغيل/تصحيح الأخطاء وتعديلها.