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