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