Mục đích của tài liệu này là mô tả những điểm bất thường mà bạn có thể thấy khi đóng góp nhờ công cụ quản lý việc sao chép nguồn qua lại từ kho lưu trữ nội bộ của Google. Công cụ này có tên là Copybara.
Nguồn đáng tin cậy nội bộ
Vì nguồn đáng tin cậy cho mã trong kho lưu trữ này là kho lưu trữ nội bộ của Google, nên Copybara sẽ biến đổi mã bất cứ khi nào mã được nhập và xuất. Điều này có nghĩa là đôi khi những thay đổi tưởng chừng như bình thường vẫn có thể gây lỗi nội bộ theo những cách đáng ngạc nhiên.
Trạng thái hợp nhất PR và những điểm không thống nhất
Vì nguồn đáng tin cậy là nội bộ, nên các PR không được hợp nhất trực tiếp, chúng được nhập vào kho lưu trữ nội bộ của Google, nơi chúng trải qua quá trình kiểm thử bổ sung, sau đó thay đổi nội bộ đó sẽ được gửi và được gán cho tác giả quan hệ công chúng. Do các phép biến đổi mà Copybara áp dụng, không có gì đảm bảo rằng điểm khác biệt sẽ giống hệt nhau (ví dụ: Copybara áp dụng định dạng khi nhập).
Vì lý do này, Copybara sẽ không đánh dấu PR là đã hợp nhất, mà sẽ đóng PR đó và áp dụng riêng một cam kết liên kết rất chặt chẽ với PR đó.
Phần phụ thuộc trên TSL theo bản sao
Như hiện tại, để ngăn chặn mọi thay đổi tạm thời bị lỗi, XLA không dựa vào TSL bằng cách tải bản sao xuống bằng cách sử dụng http_archive
của Bazel, mà bằng cách nhờ Copybara sao chép TSL vào thư mục third_party
của XLA.