Google משתמשת בדגלי הפעלת תכונות כגישה להבטחת הסתעפויות קוד יציב. הדגלים האלה נדרשים גם לסוגים מסוימים של תרומות ל-AOSP. לפני שמטמיעים את התיוג של השקת התכונה, צריך לקבוע אם הדגל הנדרש לשינוי. אם יש צורך בדגל, צריך לקבוע את סוג הדגל שבו רוצים להשתמש.
קביעת השימוש בדגלים
כדי לקבוע מתי להשתמש בדגל להשקת תכונה, יש לפעול לפי ההנחיות הבאות:
אם אתם מבצעים שינוי שעלול לגרום לקוד הבסיסי של AOSP להיות לא יציב, כמו הוספת תכונה חדשה או תיקון באג מורכב במיוחד, צריך להשתמש בדגל השקה של התכונה.
לעומת זאת, אם אתם מבצעים שינוי קוד שאינו מתאים לגרום ל-codebase להיות לא יציב, כמו שינוי תגובות, אתם לא צריכים להשתמש בדגל להשקת תכונות.
קביעת סוג הדגל
יש שני סוגי דגלים: דגלי aconfig ויצירת דגלים.
סימוני Aconfig
דגלים של aconfig משמשים להפרדה בין ביצוע קוד שלא פורסם לבין ביצוע קוד שפורסם במהלך תהליך הבדיקה וההפצה. הדגלים של aconfig יכולים להיות לקריאה ולכתיבה או לקריאה בלבד:
דגלים של aconfig לקריאה וכתיבה הם משתנים בוליאניים שאפשר להפעיל (להגדיר לערך
true) או להשבית (להגדיר לערךfalse) במהלך זמן הריצה. כדאי להשתמש בדגל קריאה-כתיבה כדי לבדוק ולשחרר שינויים בלי להשפיע על היציבות של הסתעפות ראשית.דגלים של aconfig לקריאה בלבד הם קבועים בוליאניים שלא ניתן לשנות במהלך זמן הריצה. אפשר להמיר דגלים של aconfig לקריאה וכתיבה לדגלים של aconfig לקריאה בלבד עבור קוד יציב ומוכן להשקה.
בנוסף, בהתאם למהדר שבו משתמשים, כאשר משתמשים בדגל לקריאה בלבד, יכול להיות שהקוד שלא מופעל יוחרג מה-build. לכן, אפשר להשתמש בדגלים לקריאה בלבד כדי להסתיר קוד שלא מוכן להיכלל בגרסה.
יצירת דגלים
דגלים ב-build הם קבועים בזמן ה-build (מחרוזות) ואי אפשר לשנות אותם במהלך זמן ריצה. כדאי להשתמש בדגלים הבאים בנסיבות שבהן אי אפשר להשתמש בדגלי config, כמו:
- יש לכם קטע קוד שנוצר מראש או נוצר מראש שרוצים לכלול ב-build.
- כדי לבצע שינויים במערכת ה-build עצמה.
- אתם רוצים להוסיף דגלים לקשרי התלות כדי לנהל את גודל הקוד.