排解及修正同步處理問題

本頁說明如何疑難排解及修正 repo sync 指令。

修正網路問題

本節提供幾項建議，協助您解決可能導致同步處理失敗的網路問題。

使用驗證功能避免配額限制

為避免伺服器遭到過度使用，每個用於存取來源的 IP 位址都會與配額相關聯。

當您與其他使用者共用 IP 位址 (例如從 NAT 防火牆外存取來源存放區) 時，系統可能會針對一般模式觸發配額。例如，如有多位使用者同步處理新用戶端，就會觸發配額。 存取相同 IP 位址

如要避免觸發配額，可以使用「經過驗證的存取權」 才能為每個使用者分配獨立配額。

如何啟用已驗證存取權：

  1. 使用密碼產生工具建立密碼。

  2. 執行下列指令，將用戶端轉換為採用自動 驗證 (不變更分支版本)：

    $ repo init -u https://android.googlesource.com/a/platform/manifest

    請注意，/a/ 目錄前置字串會觸發自動驗證。

設定 Proxy 使用方式

如果您是透過 Proxy 下載來源 (在某些企業環境中很常見)，請務必執行下列指令，明確指定 Repo 要使用的 Proxy：

$ export HTTP_PROXY=http://proxy_user_id:proxy_password@proxy_server:proxy_port
$ export HTTPS_PROXY=http://proxy_user_id:proxy_password@proxy_server:proxy_port

調整 TCP/IP 設定以避免連線問題

Linux 用戶端可能會遇到連線問題，例如 無法順利接收物件如要改善這個問題，請調整 TCP/IP 堆疊的設定，或使用非平行連線。您必須擁有根存取權才能修改 TCP 設定。如要修改 設定，發出下列指令：

$ sudo sysctl -w net.ipv4.tcp_window_scaling=0
$ repo sync -j1

使用本機鏡像避免網路延遲

使用多個用戶端時，您可以建立整個伺服器內容的本機鏡像，並從該鏡像同步處理用戶端，而無需存取網路。請按照下列操作說明，在 ~/aosp-mirror/ 中建立本機鏡像，並將用戶端與該鏡像同步：

  1. 建立並同步鏡像：

    $ mkdir -p /usr/local/aosp/mirror
$ cd /usr/local/aosp/mirror
$ repo init -u https://android.googlesource.com/mirror/manifest --mirror

    這些指令會在 /user/local/aosp/mirror 中建立本機鏡像，並 使用搭配 repo init 的 --mirror 旗標初始化鏡像 指令

  2. 如要從鏡像同步處理用戶端，請按照下列步驟操作：

    $ mkdir -p /usr/local/aosp/main
$ cd /usr/local/aosp/main
$ repo init -u /usr/local/aosp/mirror/platform/manifest.git
$ repo sync

  3. 最後，請按照下列指令將鏡像同步至伺服器，並將用戶端同步至鏡像：

    $ cd /usr/local/aosp/mirror</code>
$ repo sync
$ cd /usr/local/aosp/main
$ repo sync

您可以將鏡像儲存在區域網路伺服器上，並透過 NFS、SSH 或 Git 存取。也有可能儲存在卸除式硬碟中 這種資源會驅動使用者或機器

使用部分複本

如果您使用的是 Git 2.19 以上版本，請在執行 repo init 時指定 --partial-clone，以克服任何低延遲網路問題：

  $ repo init -u https://android.googlesource.com/platform/manifest -b main --partial-clone --clone-filter=blob:limit=10M

這個指令不會初始化存放區來下載所有資料，而會下載 Git 物件

修正特定的同步處理問題

本頁將詳細說明您在嘗試同步處理 Android 原始碼。

指令失敗並顯示 403 或 500 錯誤 (Proxy 問題)

repo init 或 repo sync 指令可能會失敗，並顯示 403 或 500 錯誤。這些錯誤通常與無法連線的 HTTP Proxy 有關 處理大量資料傳輸作業

儘管這些錯誤並沒有具體修正，但使用最新的 Python 且明確使用 repo sync -j1 有時也會有幫助。