功能啟動旗標總覽

將程式碼新增至 AOSP 時,請使用功能啟動標記,將未經測試的程式碼與已測試的程式碼區隔開來。啟用功能啟動旗標,執行及測試程式碼。相反地,停用功能啟動旗標,確保未經測試的程式碼不會執行。

功能啟動標記主要有兩種用途:

  • 如果您是 AOSP 貢獻者,請務必使用功能啟動標記,讓 Google 視需要啟用或停用該標記,以便測試您的程式碼,並確保外部開發分支穩定。如要進一步瞭解分支,請參閱「發布生命週期」。
  • Google 會使用功能推出標記,確保外部開發分支 (main) 和發布分支對所有人來說都穩定。如果貴公司保留 Android 開放原始碼計畫的鏡像,並沿用該版本的鏡像,請使用功能啟動旗標,讓開發團隊能夠穩定支援 Android 開放原始碼計畫程式碼的鏡像。

實作功能啟動標記的高階步驟如下:

  1. 針對特定程式碼變更,判斷是否需要旗標,如果需要,則決定旗標類型。
  2. 宣告旗標。
  3. 將程式碼變更納入標記中。
  4. 設定旗標的值。
  5. 建構及測試程式碼。
  6. 在執行階段變更旗標值。
  7. 測試使用功能發布標記的程式碼

本節的頁面將說明如何執行這些步驟。