تستخدم Google علامات إطلاق الميزات كنهج لضمان ثبات ملفّات رمز المصدر. هذه العلامات مطلوبة أيضًا لأنواع معينة من المساهمات في AOSP. قبل تنفيذ ميزة الإبلاغ عن إطلاق الميزات، حدِّد ما إذا كان يجب وضع علامة على التغيير. وإذا كانت العلامة ضرورية، فيجب تحديد نوع العلامة التي تريد استخدامها.
تحديد استخدام العلامة
لتحديد حالات استخدام علامة إطلاق الميزة، اتّبِع الإرشادات التالية:
إذا كنت بصدد إجراء تغيير قد يؤدي إلى عدم استقرار قاعدة بيانات AOSP، مثل إضافة ميزة جديدة أو إصلاح خطأ معقّد بشكلٍ خاص، استخدِم علامة بدء ميزة.
وبالعكس، إذا كنت تجري تغييرًا في التعليمات البرمجية بطريقة غير ملائمة لجعل قاعدة الأكواد غير مستقرة، مثل تعديل التعليقات، لن تحتاج إلى استخدام علامة تشغيل ميزة.
تحديد نوع العلامة
هناك نوعان من العلامات: علامات aconfig وإنشاء العلامات.
علامات Aconfig
تُستخدَم علامات Aconfig لفصل تنفيذ الرمز البرمجي الذي لم يتم إصداره عن الرمز الذي تم إصداره، وذلك أثناء عملية الاختبار والإصدار. يمكن أن تكون علامات Aconfig للقراءة والكتابة أو للقراءة فقط:
علامات إعداد القراءة والكتابة هي متغيّرات منطقية يمكنك تفعيلها (ضبطها على
true) أو إيقافها (بالضبط علىfalse) في وقت التشغيل. استخدم علامة قراءة وكتابة لاختبار التغييرات وإصدارها دون التأثير في استقرار فرع رئيسي.علامات aconfig للقراءة فقط هي ثوابت منطقية لا يمكنك تغييرها في وقت التشغيل. يمكنك تحويل علامات aconfig للقراءة والكتابة إلى علامات aconfig للقراءة فقط للحصول على رمز برمجي ثابت وجاهز للإصدار.
بالإضافة إلى ذلك، بناءً على برنامج التجميع الذي تستخدمه، عند استخدام علامة للقراءة فقط، قد يتم استبعاد الرمز البرمجي الذي لم يتم تنفيذه من الإصدار. لذلك، يمكنك استخدام العلامات للقراءة فقط لإخفاء أي رمز برمجي لم يكتمل بعد ليتم تضمينه في إصدار.
علامات الإنشاء
علامات الإنشاء هي ثوابت (سلاسل) وقت الإنشاء ولا يمكنك تغييرها أثناء وقت التشغيل. يمكنك استخدام هذه العلامات في الحالات التي لا يمكنك فيها استخدام علامات aconfig، مثل:
- لديك قطعة رمز برمجي مُجمَّعة مسبقًا أو مُنشأة مسبقًا تريد تضمينها في الإصدار.
- تريد إجراء تغييرات لإنشاء النظام نفسه.
- إذا أردت وضع علامات حول التبعيات لإدارة حجم الرمز