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

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

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

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

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

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

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

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

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

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

بدء استخدام ميزة "التعديل المباشر"

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

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

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

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

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

   

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

   

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

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

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

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

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

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

   

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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• ما هي الحالة الحالية لميزة "التعديل المباشر"؟

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

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

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

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

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

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

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

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

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

• Int
• String
• Color
• Dp
• Boolean

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

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

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

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