Bitbucket (Strings)

文本由 Phrase Language AI 从英语机器翻译而得。

提示

有关 Phrase TMS 中 Bitbucket 集成的信息，请参阅 Bitbucket Cloud (TMS)。

Bitbucket Sync 仅支持 Bitbucket Cloud。它不能与 Bitbucket 服务器一起使用。
Bitbucket Sync 可通过 API 使用。

先决条件

.phrase.yml 配置文件必须存在于要监控的分支的根目录中。该文件定义了从存储库导入 (pull) 或导出 (push) 哪些文件。
存储库需要读取和写入权限。
配置文件定义不正确可能会导致错误。确保文件至少包含一个 push 和一个 pull 目标、正确的文件格式以及正确的 update_translations 参数。

配置文件示例：

phrase:
    project_id: 1f61b9ecdb7a17a9dd174302419c50cc
    file_format: simple_json
    push:
        sources:
            - file: ./<locale_name>.json
    pull:
        targets:
            - file: ./<locale_name>.json

项目的项目 ID 可以在项目设置中找到。

连接存储库

配置文件就绪后，请按照以下步骤连接存储库：

在集成页面中，向下滚动至 Repo Sync 并点击配置。

Repo Syncs 页面随即打开。
点击 Add Sync/Bitbucket。

Bitbucket Sync 激活页面随即打开。
从 Authorize for workspace 下拉列表选择要连接的 Bitbucket 账户，然后点击访问。

Phrase Strings 与所选 Bitbucket 账户之间的连接即已建立。Bitbucket sync 设置窗口随即显示。

注释

无法通过 Bitbucket 集成连接多个账户。
从下拉列表中选择一个项目。
从下拉列表中选择一个 Bitbucket 存储库。

如果存储库所有权不正确，该存储库将不会显示在下拉列表中。
从下拉列表中选择一个存储库分支以进行导入（推送）和导出（拉取）。这通常是主分支。
点击 Validate Configuration 以确保身份验证设置和配置文件正确无误。
您可以选择 Auto import，以便在每次提交到所选 Bitbucket 分支时自动导入文件。
点击保存。

项目现已连接到所选的 Bitbucket 存储库并已添加到列表中。
（可选）点击 pencil icon 以重命名集成。

集成可以在 Repo Syncs 页面中停用或移除。

用户也可以通过在 Bitbucket personal settings 中撤销对 Phrase Strings 的授权来移除 Bitbucket 集成。

从 Bitbucket 导入

激活 Bitbucket 同步并连接存储库后，即可导入区域文件。此操作以拉取请求的形式完成，因此可以审校更改并控制分支管理。

要从 Bitbucket 导入区域文件，请按照以下步骤操作：

在 Repo Syncs 页面中，选择一个项目并点击 Import 。

译文会被拉取到项目中。键和当前译文会得到更新。
在 Bitbucket 中批准、合并或关闭拉取请求。

导出到 Bitbucket

若要将区域文件导出到 Bitbucket，请按照以下步骤操作：

在 Repo Syncs 页面中，选择一个项目并点击 Export 。

系统将显示 Export 窗口。
在 PR branch 字段中提供译文分支。

存储库中的最新文件将作为新的拉取请求导出到目标分支。
文件导出后，可在存储库中合并或关闭该拉取请求，并删除该分支。

历史记录

Repo syncs 会保留每个 Phrase Strings 项目的最新导入和导出历史记录。

若要查看历史记录：

在 Repo Syncs 页面中，选择一个项目并点击 History 。

系统将显示该项目的导入和导出历史记录。历史记录中的导出条目包含指向相应合并请求的链接。