通用核心映像檔 (GKI) 發布程序

本文件說明 GKI 的發布方式,包括每週、每月及每月 一連串的彈簧帶本文件旨在提供原始設備製造商 (OEM) 參考 瞭解 GKI 的選擇位置,以及 外部錶帶遷移程序 進行緊急修正原始設備製造商 (OEM) 也可參閱 GKI 開發指南 ,瞭解他們如何與 Android 核心團隊合作,進行最佳化 產品的 GKI 核心

GKI 發布頻率

GKI 會在 KMI 凍結後每月發布。

Android 13、14 和 15 GKI 版本

下表僅適用於 android13-5.10android13-5.15android14-6.1

GKI 每月認證版本 入住截止日期 GKI 預先載入準備日期 已確認嗎?
10 月 2022 年 10 月 14 日 2022 年 10 月 31 日
11 月 2022 年 11 月 14 日 2022 年 11 月 30 日
12 月 2022 年 12 月 9 日 2022 年 12 月 21 日
1 月 2023 年 1 月 17 日 2023 年 1 月 31 日
2 月 2023 年 2 月 15 日 2023 年 2 月 28 日
3 月 2023 年 3 月 15 日 2023 年 3 月 31 日
4 月 2023 年 4 月 13 日 2023 年 4 月 28 日
5 月 2023 年 5 月 17 日 2023 年 5 月 31 日
6 月 2023 年 6 月 15 日 2023 年 6 月 30 日
7 月 2023 年 7 月 18 日 2023 年 7 月 31 日
8 月 2023 年 8 月 16 日 2023 年 8 月 31 日
9 月 2023 年 9 月 14 日 2023 年 9 月 29 日
10 月 2023 年 10 月 18 日 2023 年 10 月 31 日
11 月 2023 年 11 月 10 日 2023 年 11 月 30 日
12 月 2023 年 12 月 7 日 2023 年 12 月 22 日
1 月 2024 年 1 月 16 日 2024 年 1 月 31 日
2 月 2024 年 2 月 13 日 2024 年 2 月 29 日
3 月 2024 年 3 月 13 日 2024 年 3 月 29 日
4 月 2024 年 4 月 16 日 2024 年 4 月 30 日
5 月 2024 年 5 月 14 日 2024 年 5 月 31 日
6 月 2024 年 6 月 12 日 2024 年 6 月 28 日
7 月 2024 年 7 月 16 日 2024 年 7 月 31 日
8 月 2024 年 8 月 15 日 2024 年 8 月 30 日
9 月 2024 年 9 月 17 日 2024 年 9 月 30 日
10 月 2024 年 10 月 15 日 2024 年 10 月 31 日
11 月 2024 年 11 月 11 日 2024 年 11 月 27 日
12 月 2024 年 12 月 6 日 2024 年 12 月 23 日

2024 年 1 月起,我們將恢復每月 android14-5.15 版本 並依照下表列出的每月頻率進行調整。 自 2024 年 7 月起,android15-6.6 也會遵循相同的發布頻率。

GKI 每月認證版本 入住截止日期 GKI 預先載入準備日期 已確認嗎?
1 月 2024 年 1 月 16 日 2024 年 1 月 31 日
2 月 2024 年 2 月 13 日 2024 年 2 月 29 日
3 月 2024 年 3 月 4 日 2024 年 3 月 15 日
4 月 2024 年 4 月 1 日 2024 年 4 月 17 日
5 月 2024 年 5 月 1 日 2024 年 5 月 17 日
6 月 2024 年 6 月 3 日 2024 年 6 月 17 日
7 月 2024 年 7 月 1 日 2024 年 7 月 15 日
8 月 2024 年 8 月 1 日 2024 年 8 月 16 日
9 月 2024 年 9 月 2 日 2024 年 9 月 16 日
10 月 2024 年 10 月 1 日 2024 年 10 月 14 日
11 月 2024 年 11 月 1 日 2024 年 11 月 15 日
12 月 2024 年 12 月 2 日 2024 年 12 月 16 日

Android 12 GKI 版本

2024 年 5 月後,android12-5.10 GKI 發布為季度, 每月中發布 下表列出僅適用於 android12-5.10

GKI 每月認證版本 入住截止日期 GKI 預先載入準備日期 已確認嗎?
7 月 2023 年 7 月 3 日 2023 年 7 月 14 日
9 月 2023 年 9 月 1 日 2023 年 9 月 15 日
11 月 2023 年 11 月 3 日 2023 年 11 月 17 日
1 月 2024 年 1 月 5 日 2024 年 1 月 19 日
3 月 2024 年 3 月 4 日 2024 年 3 月 15 日
5 月 2024 年 5 月 1 日 2024 年 5 月 17 日
8 月 2024 年 8 月 1 日 2024 年 8 月 16 日
11 月 2024 年 11 月 1 日 2024 年 11 月 15 日
2 月 2025 年 2 月 3 日 2025 年 2 月 17 日

原始設備製造商 (OEM) 的 GKI 建構有效性

原始設備製造商 (OEM) 可以使用最近發布的 Android GKI。原始設備製造商 (OEM) 可以透過 只要版本符合 Android 安全性公告 (ASB)。

每週開發版本

發布內容已通過 cuttlefish 測試 確保通過最低品質標準

GKI 二進位檔可從 ci.android.com 的自助式服務中使用 合併變更每週版本無法通過認證,但可以做為 做為開發與測試的基準每週版本無法用於 適用於一般使用者的正式版裝置。

每月認證版本

GKI 每月版本包含經過測試的 boot.img,其中包含 Google 插入憑證,證明二進位檔是以已知來源建構 程式碼基準

每個月都會選出一份 GKI 每月候選版 (未經認證) 晚於入住截止日,這通常是第二週的 當月選取每月發布版本後,新 但這些變更將不會反映在該月的版本。關閉期間 只能修正造成測試失敗的錯誤。 候選版代表通過品質保證,如 GKI 中所述 評估」部分,確保通過法規遵循測試 GSI+GKI 是以參考裝置和墨魚製成。

GKI 發布頻率時間表 圖 1. GKI 發布時間表

緊急重新定位程序

「重新測試」是指重新合併、重新建構、重新測試和 之後重新認證二進位檔 GKI 核心的公開版本。 您可以針對下列任何項目要求重新綁定認證的二進位檔 情況:

  • 如要更新符號清單,請按照下列步驟操作。
  • 為錯誤套用修正,包括在電信業者研究室核准期間發現的錯誤。
  • 新增供應商掛鉤
  • 將修補程式套用至現有功能。
  • 套用安全性修補程式 (6 個月後)。

安全性修補程式會自動合併至發布分支版本, 分支推出後 6 個月。6 個月截止後,您必須 要求重組,將安全性修補程式套用至分支版本。

重新固定要求指南

要求重新固定前,請注意下列規定:

  • 只有首次公開版本推出後,才能在分支版本中使用重新固定功能 是每月推出版本

  • 系統只會接受特定發布分支版本的重新固定要求 最多不超過六個月。六個月後 分支版本只能針對以下文中提及的安全性修補程式進行重新定位: Android 安全性公告

  • LTS 需求條件時 ,根據 Android 安全性公告 (ASB) 定義。 導致分支版本不符合規定,而分支版本已淘汰。重新固定要求 深入瞭解已淘汰的分支版本特定 GKI 的淘汰日期 「版本分支」包含在每月 GKI 版本資訊中的 版本。 針對未來規劃,LTS 規定會在 5 月和 11 月更新 每年。例如:android12-5.10-2023-07 2024 年 5 月 1 日後,系統不支援重組功能 (5.10.177),因為 android12-5.10-2023-07 分支版本 (5.10.177) 不符合 ASB-2024-05 的 LTS 要求。

  • 重新固定僅適用於緊急錯誤修正、符號清單更新,或 並套用修補程式來修正現有功能

  • 凡是放入每月版本分支版本的修補程式,都必須合併為: 主要的 GKI 開發分支舉例來說,假設 「android12-5.10-2022-09」的重新釘圖,必須已合併為 android12-5.10

  • 您必須從主要的 GKI 開發分支中挑選修補程式 將修補程式上傳到每月分支

  • 您必須在重新固定要求中指定優先順序 (緊急) 要求。 有了優先等級,GKI 團隊就能及時為合作夥伴提供更優異的協助。 如果是重大或有時效性的要求,請將優先順序標示為 P0。適用於 P0 和 P1 也應證明急迫性下表提供了 錯誤優先順序和解決時間 (ESRT):

    優先順序 西班牙文
    P0 2 個工作天
    P1 5 個工作天
    P2 10 個工作天
    P3 15 個工作天
,瞭解如何調查及移除這項存取權。
  • 您必須分別為每個發布分支版本提交重新固定要求。舉例來說 android12-5.10-2022-08android12-5.10-2022-09,您必須建立兩個重新固定要求。

  • 提交建構作業且重新釘選要求標示為已修正後, 如要新增其他 CL,請勿重新開啟重新綁定要求。您必須提交新的 重新固定要求。

  • 為您想考慮的每個 CL 新增下列標記。

    • Bug:必須在每個 CL 的修訂訊息中加入錯誤 ID。
    • Change-Id:必須與基礎分支版本變更的「Change-Id」相同。
    ,瞭解如何調查及移除這項存取權。
  • 如果重新提出請求需要您的回應,但您並未在 但優先順序會降為一個等級 (例如 P0 會降級至 P1)。如果您兩週未回覆,表示系統發生錯誤: 標示為「Won't Fix (已過時)」

提出重新綁定要求

下圖顯示重新固定程序。這項程序會在 原始設備製造商 (OEM) 合作夥伴 (您) 提交重新定位要求。

緊急重新定位程序 圖 2. 重新固定流程

如何進入重新固定程序:

  1. 填寫 GKI Respin 申請表。 ,並立即與 Google 客戶技術顧問聯絡。這份表單 會建立 GKI 重新固定要求錯誤。你可以查看重新固定要求錯誤 (要求者)、GKI 團隊,以及您新增到 請參閱錯誤 CC 清單。
    • 如果您已修正問題,要求應指向修補程式 提交相關資訊,方便 Google 審查如果無法提交修補程式 可以的話,修補程式必須以文字檔案的形式附加到要求中。
    • 如果您無法修正相關問題,則要求中必須盡可能包含 包括核心版本號碼和記錄檔,因此 Google 有助於對問題進行偵錯。
  2. Google GKI 團隊會審查要求,然後核准或回覆 如果還需要其他資訊
  3. 雙方同意修正後,Google GKI 小組的程式碼審查 (CR+2) 變更。審查程序始於 ESRT 時間範圍。GKI 團隊在合併、建構、測試 並認證變更
  4. 二進位檔案會發布到 ci.android.com。 ESRT 時程將結束,Google GKI 團隊會將要求標示為已修正, 就會參照 Repin 版本也會在 通用核心映像檔 (GKI) 發布子版本頁面

GKI 資格

GKI 建構類型 品質違規處置 注意事項
每週 Cuttlefish 測試
  • 啟動程序
  • VTS 的子集
  • CTS 子集
  • 尚未取得認證。僅適用於測試且
    部裝置啟動。
  • 無法用於啟動裝置。
每月 (已認證) Cuttlefish 測試
  • 啟動程序
  • 影片觀看體驗 (VTS)
  • CTS
,瞭解如何調查及移除這項存取權。 參考硬體測試
  • 啟動程序
  • 影片觀看體驗 (VTS)
  • CTS
Respins (認證) Cuttlefish 測試
  • 啟動程序
  • 影片觀看體驗 (VTS)
  • CTS 子集
,瞭解如何調查及移除這項存取權。 參考裝置測試
  • 啟動程序
  • 影片觀看體驗 (VTS)
  • 以通過 GKI 認證的版本為基礎。
  • 建構通過資格通過認證。

取得建構構件的位置

您可以取得所有版本的構件 ci.android.com

如要進一步瞭解 CI,包括測試環境 Android 持續整合工具評估結果 儀表板中指定這項設定。

常見問題

是否可以根據已發布的 GKI 建構新的 GKI 二進位檔?

是的,這種情況稱為重新圖釘。只要 發布的 GKI 版本 (要求重新綁定版本) 符合 LTS 規範 列出 Android 安全性公告 (ASB) 的要求。

可以重現 GKI 二進位檔嗎?

是,請參考以下範例。

GKI 2.0
5.10 kernel prebuilts from build 7364300
https://ci.android.com/builds/submitted/7364300/kernel_aarch64/latest

如要重現範例,請下載 manifest_$id.xml 並執行下列指令 指令:

repo init -u https://android.googlesource.com/kernel/manifest
mv manifest_7364300.xml .repo/manifests
repo init -m manifest_7364300.xml --depth=1
repo sync
# build the GKI images
# You may want to use LTO=thin to build faster for development
BUILD_CONFIG=common/build.config.gki.aarch64 build/build.sh
# (optional) build virtual platform modules
BUILD_CONFIG=common-modules/virtual-device/build.config.virtual_device.aarch64 build/build.sh

您可以從 out/.../dist 擷取 GKI 構件副本。

是否已在最新的程式碼集上建構 GKI 二進位檔 (包括緊急飛輪修補程式)?

不可以。重播內容只含有每月認證前的修補程式 提供一系列這些重新定位包含所有會阻礙啟動的錯誤 修正內容直到原始設備製造商 (OEM) 使用相應的基準版本為止 每月推出新版本。請參閱以下範例,瞭解這類情況發生的方式。

  • OEM1 和 OEM2 決定使用 2021 年 11 月起的 GKI 二進位檔版本。
  • OEM1 和 OEM2 發現需要修補程式才能解決的問題。這些修補程式 不一定相同或相同
  • 在 2021 年 11 月的二進位檔上方,重新綁定的圖示已遭到封鎖啟動。 原始設備製造商 (OEM1) 和 OEM2 在重新繪圖視窗回報的修正程式 內容。
  • 第二條中提到的問題也會包含在後續的 GKI 中 每月推出的版本

在 10 月的解釋中,原始設備製造商 (OEM) 提交的所有修補程式都未事先透過我們的產品測試,因此對我們造成影響。可以只包括我們的修補程式嗎?

不可能辦到。「依原始設備製造商 (OEM)」重新連線路徑目前無法擴充。 反之,GKI 團隊會仔細審查每一次的改變 建立新的容器,並用所有可用的硬體測試變更 建構應用程式如果 GKI 團隊發現問題與原始設備製造商 (OEM)/裝置/型號有關, GKI 團隊可以確保由變更所新增的程式碼只會在 裝置/型號/SKU 受到影響。

統一重新連結的主要優點在於 取得與使用相同發布基礎的好處,特別是在發生錯誤時 這些錯誤是通用的,適用於所有使用者。發現核心錯誤 就是這個概念的具體範例

Google 是否提供有關原始設備製造商 (OEM) 修補程式的具體資訊和問題情境資訊,以便原始設備製造商 (OEM) 評估為產品導入修補程式的影響和風險?

除非瞭解問題,否則 Google 絕不會對重新釘選版本新增變更 而且已收集所有詳細資料這會顯示在變更記錄中 (提交訊息)。Google 不會透露受影響的特定裝置,但 原始設備製造商 (OEM) 隨時可以在變更記錄中找到問題說明及解決方案。