复制巴拉怪异行为

本文档的用途是说明您在贡献内容时可能会遇到的奇怪现象,因为有工具用于管理从 Google 内部代码库来回复制源代码。此工具称为 Copybara

内部可信来源

由于此代码库中代码的可信来源是 Google 的内部代码库,因此每当导入和导出代码时,Copybara 都会对代码进行转换。这意味着,有时看似正常的更改可能会在内部以意想不到的方式中断。

PR 合并状态和 diff 不一致

由于可信来源是内部数据,因此 PR 不会直接合并,因此会导入到 Google 内部代码库并进行额外的测试,然后提交该内部更改,并归因于 PR 作者。由于 Copybara 应用的转换,无法保证差异完全相同(例如,Copybara 会在导入时应用格式)。

因此,Copybara 不会将 PR 标记为已合并,而是关闭 PR,并单独应用应该与 PR 非常贴近的提交。

文案对 TSL 的依赖性

按照目前的实现方式,为了防止提交任何临时损坏的提交,XLA 依赖于 TSL,而不是通过使用 Bazel 的 http_archive 下载副本,而是让 Copybara 将 TSL 复制到 XLA 的 third_party 目录中。