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