تطوير التعليمات البرمجية التكرار

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

التعديل في الوقت الفعلي

ملاحظة مهمة: لا تزال هذه الميزة قيد التطوير، لذا قد تلاحظ بعض السلوك غير المستقر. أمّا في Android Studio Giraffe والإصدارات الأحدث، فتتطلب، الإصدار 1.3.0 أو أعلى من Jetpack Compose والإصدارات الأعلى وAGP 8.1.0-alpha05 أو الإصدارات الأحدث. تعمل Google باستمرار على تحسين هذه الميزة، ويسعدها تلقّي ملاحظاتك. إذا واجهت مشكلة، يُرجى الإبلاغ عنها. يُرجى تضمين معلومات من Logcat ووصفًا للتغيير الذي كنت بصدد إجرائه على الرمز البرمجي. يمكنك أيضًا الاطّلاع على قائمة المشاكل المفتوحة.

تتيح لك ميزة "التعديل المباشر" تعديل العناصر القابلة للتجميع في المحاكيات والأجهزة الفعلية في الوقت الفعلي. وتقلل هذه الوظيفة من عمليات تبديل السياق بين كتابة تطبيقك وإنشائه، ما يتيح لك التركيز على كتابة الرمز لفترة أطول بدون انقطاع.

ملاحظة مُهمّة: تم تعديل اختصار الوضع اليدوي إلى Control+' (Command+' على نظام التشغيل macOS) في إصدار Koala Feature Drop. كانت الإصدارات السابقة من "استوديو Android" تستخدم Control+\ (Command+\ على نظام التشغيل macOS) كاختصار للوضع اليدوي.

تتوفر ثلاثة أوضاع في "التعديل المباشر":

• يدوي: يتم تطبيق التغييرات على الرموز البرمجية عند تطبيقها يدويًا باستخدام Control+' (Command+' على نظام التشغيل macOS)
• تطبيق التغييرات يدويًا عند الحفظ: يتم تطبيق تغييرات الرمز عند حفظها يدويًا باستخدام Control ‏+ S (Command ‏+ S على نظام التشغيل macOS).
• تلقائي: يتم تطبيق التغييرات في جهازك أو المحاكي عند تحديث دالة قابلة للإنشاء.

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

لا تُعدّ هذه الميزة بديلاً لبناء تطبيقك وتشغيله أو لميزة تطبيق التغييرات. بدلاً من ذلك، تم تصميمه لتحسين سير العمل أثناء إنشاء واجهة مستخدم Compose ونشرها وتكرارها لتطويرها.

في ما يلي سير العمل وفقًا لأفضل الممارسات:

1. عليك إعداد تطبيقك حتى يمكن تشغيله.
2. ميزة "التعديل في الوقت الفعلي" قدر الإمكان إلى أن تحتاج إلى إجراء تغيير لا يتوافق مع ميزة "التعديل في الوقت الفعلي"، مثل إضافة طرق جديدة أثناء تشغيل التطبيق
3. بعد إجراء تغيير غير متوافق، انقر على تشغيل لإعادة تشغيل التطبيق واستئناف ميزة "التعديل المباشر".

بدء استخدام ميزة "التعديل في الوقت الفعلي"

للبدء، اتبع الخطوات التالية لإنشاء "نشاط إنشاء" فارغ وتفعيل "التعديل المباشر" لمشروعك وإجراء التغييرات باستخدام ميزة "التعديل المباشر".

إعداد مشروعك الجديد

1. قبل البدء، تأكَّد من تثبيت الإصدار Giraffe من Android Studio أو إصدار أحدث وأنّ مستوى واجهة برمجة التطبيقات في جهازك المبرمَج أو المحاكي هو 30 على الأقل.

2. افتح "استوديو Android" واختَر مشروع جديد في مربّع الحوار مرحبًا بك في استوديو Android. إذا كان لديك مشروع مفتوح، يمكنك إنشاء مشروع جديد من خلال الانتقال إلى ملف > جديد > مشروع جديد.

3. اختَر نموذج نشاط الإنشاء الفارغ للهاتف والجهاز اللوحي، ثم انقر على التالي.

   

   الشكل 1. النماذج التي يمكنك الاختيار من بينها بالنسبة إلى ميزة "التعديل المباشر"، اختَر نشاط كتابة فارغ.

4. أكمِل مربّع الحوار مشروع جديد بالمعلومات المطلوبة: الاسم، اسم الحزمة، ومكان الحفظ، والحد الأدنى لحزمة تطوير البرامج (SDK)، ولغة إعدادات الإنشاء.

   

   الشكل 2. مثال على إعدادات المشروع.

5. انقر على إنهاء.

تفعيل ميزة "التعديل في الوقت الفعلي"

1. انتقِل إلى الإعدادات لتفعيل ميزة "التعديل المباشر".

   • على نظام التشغيل Windows أو Linux، انتقِل إلى ملف > الإعدادات > المحرِّر > التعديل المباشر.
   • على نظام التشغيل macOS، انتقِل إلى Android Studio > الإعدادات > المحرِّر > التعديل المباشر.

2. حدِّد خيار التعديل المباشر والوضع الذي تريد تشغيله من الإعدادات.

   في الوضع اليدوي، يتمّ نشر تغييرات الرمز البرمجي في كلّ مرّة تضغط فيها على Control ‏+' (Command ‏+' على نظام التشغيل macOS). في الوضع اليدوي للحفظ، يتم تطبيق تغييرات الرمز في كل مرة تحفظ فيها يدويًا باستخدام Control+S (Command+S على macOS). في الوضع التلقائي، يتم تطبيق تغييرات الرمز على جهازك أو المحاكي أثناء إجراء التغييرات.

   

   الشكل 3. إعدادات "التعديل المباشر"

3. في المحرِّر، افتح ملف MainActivity، وهو نقطة دخول تطبيقك.

4. انقر على تشغيل لنشر تطبيقك.

5. بعد تفعيل ميزة "التعديل المباشر"، ستظهر علامة الاختيار الخضراء حديث في أعلى يسار نافذة أداة الأجهزة قيد التشغيل:

   

إجراء التغييرات ومراجعتها

عند إجراء تغييرات متوافقة في المحرِّر، يتم تحديث جهاز الاختبار الافتراضي أو الفعلي تلقائيًا.

على سبيل المثال، عدِّل طريقة Greeting الحالية في MainActivity إلى النحو التالي:

@Composable
fun Greeting(name: String) {
    Text(
        text = "Hello $name!",
        Modifier
            .padding(80.dp) // Outer padding; outside background
            .background(color = Color.Cyan) // Solid element background color
            .padding(16.dp) // Inner padding; inside background, around text)
    )
}
IterativeDevelopmentSnippets.kt

تظهر التغييرات على الفور على الجهاز الاختباري، كما هو موضّح في الشكل 4.

الشكل 4. الجهاز التجريبي يعرض تغييرات "التعديل المباشر" على الطريقة Greeting.

تحديد المشاكل وحلّها في ميزة "التعديل في الوقت الفعلي"

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

الشكل 5. مؤشر حالة ميزة "التعديل المباشر"

قيود ميزة "التعديل في الوقت الفعلي"

في ما يلي قائمة بالقيود الحالية.

• [لا ينطبق ذلك إلا على الإصدار Giraffe من Android Studio والإصدارات الأحدث] تتطلّب ميزة "التعديل المباشر" استخدام Compose Runtime 1.3.0 أو إصدار أحدث. إذا كان مشروعك يستخدم إصدارًا أقدم من ميزة "الإنشاء"، يتم إيقاف ميزة "التعديل المباشر".

• [ينطبق فقط على الزر Giraffe في "استوديو Android" والإصدارات الأحدث] يجب أن يتوفّر الإصدار AGP 8.1.0-alpha05 أو إصدار أعلى. إذا كان مشروعك يستخدم إصدارًا قديمًا من AGP، سيتم إيقاف ميزة "التعديل المباشر".

• تتطلب ميزة "التعديل المباشر" جهازًا فعليًا أو محاكيًا يعمل بالمستوى 30 أو أعلى من واجهة برمجة التطبيقات.

• لا تتيح ميزة "التعديل المباشر" سوى تعديل نص الدالة، ما يعني أنّه لا يمكنك تغيير اسم الدالة أو توقيعها أو إضافة دالة أو إزالتها أو تغيير الحقول غير الدالة.

• تُعيد ميزة "التعديل المباشر" ضبط حالة التطبيق في المرة الأولى التي تغيّر فيها دالة كتابة في ملف. ولا يحدث ذلك إلا بعد إجراء أول تغيير على الرمز، ولا تتم إعادة ضبط حالة التطبيق بواسطة التغييرات اللاحقة التي تجريها على وظائف Compose في هذا الملف.

• قد تؤدي الفصول المعدَّلة باستخدام ميزة "التعديل المباشر" إلى بعض العقوبات على الأداء. يمكنك تشغيل تطبيقك واستخدام إصدار نظيف من الإصدار إذا كنت تقيِّم أدائه.

• يجب إجراء عملية تشغيل كاملة ليتمكّن مصحِّح الأخطاء من العمل على الصفوف التي عدّلتها باستخدام ميزة "التعديل المباشر".

• قد يتعطّل أي تطبيق قيد التشغيل عند تعديله باستخدام ميزة "التعديل المباشر". في هذه الحالة، يمكنك إعادة نشر التطبيق باستخدام الزر تشغيل .

• لا تُجري ميزة "التعديل المباشر" أيّ تعديل على الرمز الثنائي الذي تم تحديده فيملف إنشاء مشروعك، مثل تعديل الرمز الثنائي الذي سيتم تطبيقه عند إنشاء المشروع باستخدام الخيارات في قائمة الإنشاء أو من خلال النقر على الزرَّين إنشاء أو تشغيل.

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

• لا تتم استعادة ميزة "التعديل المباشر" عند إعادة تشغيل التطبيق. يجب تشغيل التطبيق مرة أخرى.

• لا تتيح ميزة "التعديل المباشر" سوى العمليات التي يمكن تصحيح أخطاءها.

• لا تتوافق ميزة "التعديل المباشر" مع المشاريع التي تستخدم قيمًا مخصّصة للسمة moduleName ضمن kotlinOptions في إعدادات الإصدار.

• لا تعمل ميزة "التعديل المباشر" مع عمليات النشر المتعدّدة. وهذا يعني أنّه لا يمكنك النشر على جهاز واحد ثم على جهاز آخر. لا تكون ميزة "التعديل المباشر" مفعّلة إلا على المجموعة الأخيرة من الأجهزة التي تم نشر التطبيق عليها.

• تعمل ميزة "التعديل المباشر" مع عمليات النشر على أجهزة متعددة (عمليات النشر على أجهزة متعددة تم إنشاؤها من خلال اختيار أجهزة متعددة في القائمة المنسدلة للجهاز المستهدَف). ومع ذلك، فإنّه غير متوفّر رسميًا وقد تكون هناك مشاكل. إذا واجهت مشاكل، يُرجى الإبلاغ عنها.

• لا تتوافق ميزة "تطبيق التغييرات" أو "تطبيق تغييرات الرمز" مع ميزة "التعديل المباشر"، وتتطلّب إعادة تشغيل التطبيق الذي يتم تشغيله.

• لا تتيح ميزة "التعديل المباشر" حاليًا مشاريع Android Automotive.

الأسئلة الشائعة حول ميزة "التعديل في الوقت الفعلي"

• ما هي الحالة الحالية لميزة "التعديل في الوقت الفعلي"؟

  تتوفّر ميزة "التعديل المباشر" في الإصدار Giraffe من "استوديو Android". لتفعيل هذه الميزة، انتقِل إلى ملف > الإعدادات > المحرِّر > التعديل المباشر (Android Studio > الإعدادات > المحرِّر > التعديل المباشر على نظام التشغيل macOS).

• متى يجب استخدام ميزة "التعديل المباشر"؟

  استخدِم ميزة "التعديل المباشر" عندما تريد الاطّلاع بسرعة على تأثير التعديلات على عناصر تجربة المستخدم (مثل تعديلات المُعدِّلات والصور المتحركة) في تجربة استخدام التطبيق بشكل عام.

• متى يجب تجنُّب استخدام ميزة "التعديل المباشر"؟

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

• متى يجب استخدام ميزة "معاينة الإنشاء"؟

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

التعديل المباشر للقيم الحرفية (متوقّف نهائيًا)

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

يمكن لخدمة Android Studio تعديل بعض القيم الثابتة المستخدَمة في العناصر القابلة للتجميع في الوقت الفعلي ضمن معاينات التطبيق والمحاكي والجهاز الفعلي. في ما يلي بعض الأنواع المتوافقة:

• Int
• String
• Color
• Dp
• Boolean

يمكنك عرض القيم الثابتة التي تؤدي إلى إجراء تعديلات في الوقت الفعلي بدون خطوة compilation (الترجمة والنشر) من خلال تفعيل زخارف القيم الثابتة من خلال مؤشر واجهة مستخدم التعديل المباشر للقيم الثابتة:

ملاحظة: يتم عرض مؤشر واجهة مستخدم ميزة "التعديل المباشر" للقيم الثابتة بجانب الرمز/التقسيم/التصميم ما دام هناك اتصال نشط بالتطبيق الجاري ejecutando على جهاز محاكاة أو جهاز فعلي.

تطبيق التغييرات

يتيح لك تطبيق التغييرات تحديث الرموز البرمجية والموارد بدون الحاجة إلى إعادة نشر تطبيقك إلى مُحاكي أو جهاز فعلي (مع بعض القيود).

عند إضافة مكونات قابلة للتجميع أو تعديلها أو حذفها، يمكنك تعديل تطبيقك بدون الحاجة إلى إعادة نشره من خلال النقر على الزر تطبيق تغييرات الرمز: