Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

驗證方式

本頁說明如何確保您可以在 Pixel 裝置上執行正版 Pixel 映像檔 (可信度最高)。這包括將原廠映像檔下載到電腦，以及對下載的構件執行記錄納入證明，然後再將構件更新到裝置上。

如何驗證 Pixel 原廠映像檔

通過認證的必要條件

在驗證構件 (韌體或 APK) 是否符合聲明之前，請先確認連網電腦上是否備妥下列工具：視驗證目標而定，您可能不必提供所有資訊。

Golang

驗證工具是以 Go 語言編寫。如要建構該工具，請從 Go 網站安裝 Go 1.24 以上版本。

Android Debug Bridge (ADB)

ADB 工具可與 Android 裝置通訊，檢查映像檔或擷取 APK，可從 Android SDK 平台工具網站取得。

Inclusion Proof 驗證器

納入證明驗證器是 Go 模組，可查詢透明度記錄，並輸出構件是否納入記錄。這項資訊發布在 android-binary-transparency GitHub 存放區，網址為： https://github.com/android/android-binary-transparency/tree/main

如要複製 AOSP avb 存放區，請執行下列指令：

computer:~$ git clone https://android.googlesource.com/platform/external/avb

如要複製 android-binary-transparency GitHub 存放區，請按照下列步驟操作：

computer:~$ git clone https://github.com/android/android-binary-transparency

AAPT2

AAPT2 (Android 資產封裝工具) 是一種建構工具，用於編譯及封裝 Android 應用程式的資源。在 Android SDK Build Tools 26.0.2 以上版本中，AAPT2 是獨立工具。

bundletool

bundletool 是用於建構 Android App Bundle (AAB) 的工具。這個工具也可用於驗證 APK 程式碼簽章。可從 GitHub 下載。

wget 或 curl

wget 和 curl 是可用來從網際網路擷取或下載檔案的工具。請務必安裝其中一項工具，因為驗證指令碼可能會用到。

Avbtool

avbtool 用於計算工廠映像檔的 VBMeta 摘要，以及驗證二進位檔。複製 avb 存放區後 (如「納入證明驗證器」一節所示)，您可以在複製的 avb 目錄中找到 avbtool.py。您應將這個目錄新增至 $PATH 環境變數。

computer:~$ PATH=$PATH:DIRECTORY_CONTAINING_AVBTOOL

Fbpacktool

fbpacktool 是用來解壓縮 Pixel bootloader.img 中個別元件的 Python 指令碼。如果您要驗證 APK，則不需要這個檔案。這項工具非常重要，因為可讓 avbtool.py 找出驗證所需的圖片。

如要使用這項工具，請將下列三個 Python 指令碼下載到 avbtool.py 所在的目錄中，將 fbpacktool.py 設為可執行，並建立名為 fbpacktool 的符號連結到 fbpacktool.py，方便使用。

如果使用 wget：

computer:dir_to_avbtool$ wget https://source.android.com/devices/bootloader/tools/pixel/fw_unpack/fbpacktool.py \
https://source.android.com/devices/bootloader/tools/pixel/fw_unpack/fbpack.py \
https://source.android.com/devices/bootloader/tools/pixel/fw_unpack/packedstruct.py
computer:dir_to_avbtool$ chmod +x fbpacktool.py
computer:dir_to_avbtool$ ln -s fbpacktool.py fbpacktool

如果使用 curl：

computer:dir_to_avbtool$ curl -O https://source.android.com/devices/bootloader/tools/pixel/fw_unpack/fbpacktool.py
computer:dir_to_avbtool$ curl -O https://source.android.com/devices/bootloader/tools/pixel/fw_unpack/fbpack.py
computer:dir_to_avbtool$ curl -O https://source.android.com/devices/bootloader/tools/pixel/fw_unpack/packedstruct.py
computer:dir_to_avbtool$ chmod +x fbpacktool.py
computer:dir_to_avbtool$ ln -s fbpacktool.py fbpacktool

OpenSSL

openssl 可協助您在驗證工作流程中，透過終端機執行各種加密作業。請確認系統已安裝這項工具。如要在終端機中檢查，請執行下列指令，並確認傳回的結果不是空白：

computer:~$ which openssl
/usr/bin/openssl

建構驗證酬載

如要驗證裝置上的映像檔或從 Pixel Factory Image 網站下載的映像檔，您必須先從建構指紋和 VBMeta 摘要，建構對應於該映像檔的酬載。您可以選擇手動或自動設定，詳情請見下文。

版本指紋：工廠映像檔的字串 ID
- 例如： google/oriole/oriole:12/SD1A.210817.015.A4/7697517:user/release-keys
VBMeta 摘要：SHA-256 加密摘要，可將出廠映像檔的不同部分繫結在一起
- 例如： 4d5e41b7c675a821de81f7d2c744623fe808c8c2d3e19a83e894dab5d0829dbe

手動建構酬載

如要手動產生驗證用的酬載，請建立文字檔 payload.txt，其中一行包含建構指紋，下一行則包含 VBMeta 摘要，並在最後一行留空 (請參閱「記錄內容」一節，瞭解確切格式)。

按照「工廠映像檔網站」的步驟操作後，payload.txt 檔案的內容應如下所示：

google/oriole/oriole:12/SD1A.210817.015.A4/7697517:user/release-keys
4d5e41b7c675a821de81f7d2c744623fe808c8c2d3e19a83e894dab5d0829dbe

從 Pixel 原廠映像檔網站擷取 VBMeta 摘要和建構指紋

從 Pixel 原廠映像檔網站下載原廠映像檔後，您需要解壓縮下載的檔案，這會在原位置建立另一個資料夾。前往新建立的資料夾，然後解壓縮相關聯的 image-*.zip檔案，取得個別的 *.img 檔案。這些二進位檔是分割區映像檔。確認 img 檔案中含有 vbmeta.img 檔案。畫面應如下所示：

computer:oriole-sd1a.210817.015.a4$ unzip image-oriole-sd1a.210817.015.a4.zip
Archive:  image-oriole-sd1a.210817.015.a4.zip
  inflating: android-info.txt
  inflating: boot.img
  inflating: vendor_boot.img
  inflating: system.img
  inflating: vendor.img
  inflating: product.img
  inflating: system_ext.img
  inflating: system_other.img
  inflating: dtbo.img
  inflating: vbmeta_system.img
  inflating: vbmeta.img
  inflating: super_empty.img

您可以從所有下載的檔案中擷取建構指紋，並計算 VBMeta 摘要。

avbtool.py 適用於 $PATH 後，您就可以從終端機發出下列指令，擷取建構指紋，並計算剛下載的工廠映像檔 VBMeta 摘要：

computer:dir_containing_unzipped_factory_image~$ grep -a 'ro\..*build\.fingerprint=google/.*/release-keys' system.img | cut -f2 -d'='
google/oriole/oriole:12/SD1A.210817.015.A4/7697517:user/release-keys

computer:dir_containing_unzipped_factory_image$ avbtool.py calculate_vbmeta_digest --image vbmeta.img
4d5e41b7c675a821de81f7d2c744623fe808c8c2d3e19a83e894dab5d0829dbe

手動驗證下載的原廠映像檔

如要正確驗證下載的工廠映像檔，您需要下載 fbpacktool.py，以及另外兩個依附的 Python 檔案 (fbpack.py 和 packedstruct.py)，才能解壓縮 bootloader.img 中的元件，因為這些元件會個別說明 VBMeta 結構。取得解壓縮工具後，即可使用 fbpacktool.py 解壓縮系統啟動載入程式映像檔。例如：

computer:dir_containing_unzipped_images$ python3 fbpacktool.py unpack bootloader-oriole-slider-1.0-7683913.img

您應該會在該目錄中看到其他 .img 檔案。現在，您可以繼續使用 avbtool.py 手動驗證各個分區的簽章是否相符。

computer:dir_containing_unzipped_images$ avbtool.py verify_image --image vbmeta.img --follow_chain_partitions
Verifying image vbmeta.img using embedded public key
vbmeta: Successfully verified SHA256_RSA4096 vbmeta struct in vbmeta.img
vbmeta_system: Chained but ROLLBACK_SLOT (which is 1) and KEY (which has sha1 df529646b7225015196a714006346f0768b87fcf) not specified
--
Verifying image vbmeta_system.img using embedded public key
vbmeta: Successfully verified SHA256_RSA4096 vbmeta struct in vbmeta_system.img
product: Successfully verified sha256 hashtree of product.img for image of 2700468224 bytes
system: Successfully verified sha256 hashtree of system.img for image of 878493696 bytes
system_ext: Successfully verified sha256 hashtree of system_ext.img for image of 251334656 bytes
vbmeta_vendor: Chained but ROLLBACK_SLOT (which is 3) and KEY (which has sha1 85322346680a860c091fa14a64cef1fe4a3ffe31) not specified
--
Verifying image vbmeta_vendor.img using embedded public key
vbmeta: Successfully verified SHA256_RSA4096 vbmeta struct in vbmeta_vendor.img
vendor: Successfully verified sha256 hashtree of vendor.img for image of 472940544 bytes
boot: Chained but ROLLBACK_SLOT (which is 2) and KEY (which has sha1 85322346680a860c091fa14a64cef1fe4a3ffe31) not specified
--
Verifying image boot.img using embedded public key
vbmeta: Successfully verified footer and SHA256_RSA4096 vbmeta struct in boot.img
boot: Successfully verified sha256 hash of boot.img for image of 24481792 bytes
abl: Successfully verified sha256 hash of abl.img for image of 1744896 bytes
bl1: Successfully verified sha256 hash of bl1.img for image of 12288 bytes
bl2: Successfully verified sha256 hash of bl2.img for image of 544768 bytes
bl31: Successfully verified sha256 hash of bl31.img for image of 86016 bytes
dtbo: Successfully verified sha256 hash of dtbo.img for image of 2152234 bytes
gsa: Successfully verified sha256 hash of gsa.img for image of 262144 bytes
ldfw: Successfully verified sha256 hash of ldfw.img for image of 4096000 bytes
pbl: Successfully verified sha256 hash of pbl.img for image of 49152 bytes
tzsw: Successfully verified sha256 hash of tzsw.img for image of 4304896 bytes
vendor_boot: Successfully verified sha256 hash of vendor_boot.img for image of 25718784 bytes
vendor_dlkm: Successfully verified sha256 hashtree of vendor_dlkm.img for image of 54505472 bytes

如果沒有看到任何錯誤或失敗訊息，表示下載的映像檔 VBMeta 已成功驗證。

自動建構酬載

為方便起見，我們也提供可使用的 Python 指令碼。使用這項工具時，您只需要指定工廠映像檔的網址，不必手動擷取及解壓縮檔案。

computer:dir_to_avb_repo/tools/transparency$ python3 ./pixel_factory_image_verify.py https://dl.google.com/dl/android/aosp/oriole-sd1a.210817.015.a4-factory-074b7f51.zip
Fetching file from: https://dl.google.com/dl/android/aosp/oriole-sd1a.210817.015.a4-factory-074b7f51.zip
Successfully downloaded file.
Successfully unpacked factory image.
Successfully unpacked factory image partitions.
Successfully unpacked bootloader image.
Successfully verified VBmeta.
Successfully extracted build fingerprint.
Successfully calculated VBMeta Digest.
The build fingerprint for factory image is: google/oriole/oriole:12/SD1A.210817.015.A4/7697517:user/release-keys
The VBMeta Digest for factory image is: 4d5e41b7c675a821de81f7d2c744623fe808c8c2d3e19a83e894dab5d0829dbe

A corresponding "payload.txt" file has been created.

執行上述指令後，系統會下載原廠映像檔套件、解壓縮套件，並驗證已簽署分割區的簽章。驗證成功後，系統會建立名為 payload.txt 的新檔案，內容應與下方類似：

google/oriole/oriole:12/SD1A.210817.015.A4/7697517:user/release-keys
4d5e41b7c675a821de81f7d2c744623fe808c8c2d3e19a83e894dab5d0829dbe

成功建立 payload.txt 後，即可開始驗證圖片是否已納入。

驗證圖片是否納入 (納入證明)

建構酬載後，請設定 shell 變數 (例如 $PAYLOAD_PATH)，指向酬載的路徑。

Android 開放原始碼計畫的 avb存放區已發布納入證明工具。如要執行這項指令，請按照下列步驟操作：

computer:external/avb/tools/transparency/verify$ PAYLOAD_PATH=../payload.txt
computer:external/avb/tools/transparency/verify$ go build cmd/verifier/verifier.go
computer:external/avb/tools/transparency/verify$ ./verifier --payload_path=${PAYLOAD_PATH} --log_type=pixel

驗證者會使用檢查點和記錄內容 (位於圖塊目錄)，確認圖片酬載位於透明度記錄中，也就是由 Google 發布。

指令輸出內容會寫入 stdout：

OK. inclusion check success! 如果圖片包含在記錄中，
FAILURE。

驗證方式 透過集合功能整理內容 你可以依據偏好儲存及分類內容。