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