1. 引言

歡迎來到《Chromium 134 編譯指南》系列的第七篇文章！在前面的章節中，我們已經成功獲取了Chromium源代碼，并將其配置為支持Android平臺。這些步驟為我們的編譯之旅奠定了堅實的基礎，但在開始實際編譯之前，我們還需要安裝一些特定的構建依賴項。

想象一下，如果編譯Chromium是烹飪一道復雜的菜肴，那么源代碼就是主要食材，而構建依賴項則是必不可少的調料和廚具。沒有這些工具和輔助材料，即使擁有最好的食材，我們也無法完成烹飪過程。

這些構建依賴項主要包括Android SDK（軟件開發工具包）、NDK（原生開發工具包）以及其他必要的工具鏈和庫文件。它們共同構成了編譯Android應用所需的完整工具集。好消息是，Chromium項目提供了自動化腳本，可以幫助我們一鍵安裝所有這些依賴項，大大簡化了配置過程。

在本篇文章中，我們將詳細介紹如何使用這些腳本安裝必要的構建依賴項，處理可能遇到的問題，并確保開發環境完全準備就緒。讓我們開始這個關鍵的配置步驟吧！

2. 安裝構建依賴項

安裝Chromium編譯所需的依賴項是一個相對簡單的過程，因為Chromium項目提供了自動化腳本來處理大部分工作。這些腳本會檢測您的系統環境，并安裝所有必要的組件。

2.1 了解構建依賴項的重要性

在開始安裝之前，讓我們先了解一下為什么這些依賴項如此重要：

• Android SDK：提供編譯和打包Android應用所需的工具和API
• Android NDK：用于開發Android原生組件（C/C++代碼）的工具集
• 構建工具：包括各種編譯器、鏈接器和其他構建工具
• 系統庫：提供基礎功能的各種庫文件
• 開發依賴：支持開發過程的各種工具和庫

小知識：Chromium為Android平臺編譯時，既包含Java代碼（使用SDK編譯），也包含大量C++代碼（使用NDK編譯）。這些不同語言的代碼需要不同的工具鏈來處理，因此依賴項比單純的Android應用更加復雜。

2.2 運行安裝依賴腳本

Chromium提供了一個名為install-build-deps.sh的腳本，用于自動安裝所有必要的依賴項。這個腳本位于源代碼的build目錄下。

首先，確保您在Chromium的src目錄中：

# 確保在src目錄中
cd ~/chromium/src

然后，運行依賴安裝腳本，并指定Android平臺：

# 運行安裝依賴腳本
build/install-build-deps.sh --android

這個命令的含義：

• build/install-build-deps.sh：調用安裝依賴的腳本
• --android：指定安裝Android平臺所需的依賴項

注意：這個腳本需要root權限來安裝系統級依賴，因此可能會要求您輸入密碼。

當腳本運行時，您會看到類似這樣的輸出：

Checking for apt-get...
apt-get detected.
Checking for Ubuntu version...
Ubuntu 24.04 detected.
Installing dependencies for Ubuntu...
Reading package lists...
Building dependency tree...

腳本會自動檢測您的系統類型和版本，然后安裝相應的依賴項。這個過程可能需要一些時間，取決于您的網絡速度和計算機性能。

2.3 處理系統不支持的問題

在運行安裝腳本時，您可能會遇到系統版本不受支持的提示。這通常發生在使用較新或較舊的Linux發行版時。

如果遇到類似以下的錯誤信息：

ERROR: The only supported distros are...

您有兩種解決方案：

2.3.1 升級系統到支持的版本

如果條件允許，將系統升級到腳本支持的版本是最佳選擇。這樣可以確保最佳的兼容性和支持。

2.3.2 使用--unsupported參數跳過檢查

如果您不方便升級系統，或者確信當前系統能夠兼容，可以使用--unsupported參數跳過系統版本檢查：

# 跳過系統版本檢查
build/install-build-deps.sh --android --unsupported

風險提示：使用 --unsupported參數意味著您將在未經官方測試的環境中編譯Chromium。這可能會導致編譯錯誤或其他意外問題。只有在您了解風險的情況下才使用此選項。

2.4 驗證依賴項安裝

依賴項安裝完成后，您可以通過檢查關鍵組件是否存在來驗證安裝是否成功：

# 檢查Android SDK是否正確安裝
ls -la third_party/android_sdk# 檢查Android NDK是否正確安裝
ls -la third_party/android_ndk

如果這些目錄存在并包含文件，說明基本依賴項已成功安裝。

3. 運行鉤子腳本

安裝基本依賴項后，我們還需要運行"鉤子"(hooks)腳本，以下載一些額外的二進制文件和資源。鉤子是Chromium構建系統中的特殊腳本，用于執行額外的設置步驟。

確保您仍在src目錄中，然后運行：

# 運行鉤子腳本
gclient runhooks

這個命令會執行.gclient文件中定義的所有鉤子腳本，下載并設置額外的組件。您可能會看到類似以下的輸出：

________ running 'vpython src/build/landmines.py' in '/home/user/chromium'
Landmines identified 6 path(s) to clobber based on 17 specifications.
________ running 'vpython src/build/gyp_chromium' in '/home/user/chromium'

小貼士： gclient runhooks命令可以隨時運行，特別是在切換分支或更新代碼后，以確保所有依賴項都是最新的。

3.1 鉤子腳本的作用

鉤子腳本執行的主要任務包括：

• 下載預編譯的工具和二進制文件
• 生成必要的構建文件
• 配置編譯環境
• 設置路徑和環境變量
• 準備各種資源文件

這些任務對于確保編譯環境的完整性至關重要。

3.2 常見問題及解決方法

運行鉤子腳本時可能會遇到一些問題，以下是常見問題及其解決方法：

1. 網絡連接問題

如果遇到下載失敗的錯誤，可以嘗試重新運行鉤子腳本：

gclient runhooks

腳本會從中斷處繼續，而不是從頭開始。

1. 權限問題

如果遇到權限錯誤，確保您對Chromium目錄有足夠的寫入權限：

# 修復權限問題
sudo chown -R $(whoami) ~/chromium

1. Python相關錯誤

如果遇到Python錯誤，可能是因為Chromium使用的Python版本與系統默認不同。嘗試讓腳本使用正確的Python版本：

# 使用depot_tools中的Python
PATH="$HOME/depot_tools:$PATH" gclient runhooks

4. 總結

通過本篇文章的指導，您已經成功安裝了編譯Chromium 134 for Android所需的所有構建依賴項。這些依賴項為后續的編譯工作提供了必要的工具和資源支持。

回顧一下我們所完成的工作：

1. 了解了構建依賴項的重要性和組成
2. 使用自動化腳本安裝了基本依賴項
3. 學習了如何處理系統不支持的情況
4. 運行了鉤子腳本，下載和配置了額外的組件
5. 了解了常見問題的解決方法

這些步驟確保了您的開發環境已經完全準備就緒，為實際編譯Chromium打下了堅實的基礎。雖然依賴項的安裝可能看起來只是一個中間步驟，但它對于成功編譯至關重要，就像一座大樓需要堅實的地基一樣。

在下一篇文章《Chromium 134 編譯指南 - Android 篇：開始編譯（八）》中，我們將正式進入編譯階段，詳細介紹如何配置編譯參數，執行編譯命令，以及處理編譯過程中可能遇到的問題。我們將把所有前期準備工作轉化為一個實際可用的Android應用。

敬請期待我們的下一篇文章，Chromium編譯之旅即將迎來高潮！