本文件的目的在於說明在提供 Google 內部存放區複製來源時可能遇到的情況。這項工具稱為 Copybara。
內部可靠資料來源
由於此存放區中程式碼的真實來源是 Google 的內部存放區,因此每當匯入及匯出程式碼時,Copybara 都會對程式碼進行轉換。這表示有時看似正常的變更也可能會在內部出現令人意外的結果。
PR 合併狀態和差異差異
由於真實資訊來源為內部,因此 PR 不會直接合併,因此會匯入 Google 內部存放區,以便進行額外測試,接著提交內部變更,並歸因於 PR 作者。由於 Copybara 會套用轉換,因此無法保證差異會完全相同 (例如,Copybara 在匯入時套用格式)。
因此,Copybara 不會將 PR 標示為合併,而是關閉 PR,並單獨套用應與 PR 密切對應的修訂版本。
TSL 依附元件 (透過文案)
為防止任何暫時損毀的修訂版本,XLA 仰賴 TSL 依賴 TSL,而非使用 Bazel 的 http_archive
下載副本,而是將 Copybara 複製 TSL 複製到 XLA 的 third_party
目錄。