应用程序安装

您可以从 Crowdin 商店安装 Crowdin 应用程序，也可以手动安装，具体取决于该应用程序是否已发布。

在 Crowdin 中安装

要安装已在 Crowdin 商店发布的应用程序，请按照以下步骤操作：

1. 打开您的个人资料主页，然后在左侧栏中选择商店。
2. 在所需的应用程序上点击 安装。
3. 在弹出的对话框中，配置首选权限，然后点击安装。

要安装私有应用程序，请按照以下步骤操作：

1. 前往账户设置 > 应用程序，然后点击安装私有应用程序。
2. 在弹出的对话框中，粘贴 Crowdin 应用程序的 Manifest URL，然后点击安装。
3. 在安装应用程序对话框中，配置首选权限，然后点击安装。

在 Crowdin 企业版中安装

要安装已在 Crowdin 商店发布的应用程序，请按照以下步骤操作：

1. 打开您组织的工作区，然后在左侧栏中选择商店。
2. 在所需的应用程序上点击 安装。
3. 在弹出的对话框中，配置首选权限，然后点击安装。

要安装私有应用程序，请按照以下步骤操作：

1. 前往组织设置 > 应用程序，然后点击安装私有应用程序。
2. 在弹出的对话框中，粘贴 Crowdin 应用程序的 Manifest URL，然后点击安装。
3. 在安装应用程序对话框中，配置首选权限，然后点击安装。

Crowdin 应用程序权限配置

在安装过程中为每个应用程序配置首选权限。 此步骤允许您定义谁可以访问和使用该应用程序的各个模块，并指定在您的 Crowdin 账户（适用于 Crowdin）或 Crowdin 组织（适用于 Crowdin 企业版）的哪些项目中可以使用该应用程序。

如果您使用已选项目选项限制对某些项目的访问，则该应用程序将无法通过 API 与未包含在已选列表中的项目进行通信。 此外，该应用程序将只在已选项目的界面中显示。 这可确保应用程序的功能和访问权限根据您组织的特定需求和安全要求进行精确定制。

您可以在安装时配置这些访问权限，也可以随时为已安装的应用程序调整这些权限。 这种灵活性使您可以通过更新访问设置来扩展或限制应用程序在您 Crowdin 项目中的功能和可见性，从而应对项目需求或安全策略的变化。

用户访问类别

您可以定义允许哪些用户类别使用该应用程序。 此设置独立应用于每个应用程序模块。

Crowdin 的可用选项：

• 仅限我自己（即项目所有者）
• 本人、项目管理员和开发者
• 所有项目成员
• 自定义访问（已选用户）
• 访客（未经身份验证的用户）

注意

项目所有者将始终拥有对该应用程序所有模块的访问权限。

Crowdin 企业版的可用选项：

• 仅限组织管理员
• 组织管理员、项目管理员和开发者
• 所有项目成员
• 自定义访问（已选用户）
• 访客（未经身份验证的用户）

注意

组织所有者将始终拥有对该应用程序所有模块的访问权限。

项目访问配置

除用户访问权限外，您还可以指定应用程序可在哪些项目中使用（这些设置适用于所有应用程序模块）。

项目访问选项：

• 您拥有的项目（适用于 Crowdin）或所有项目（适用于 Crowdin 企业版）
• 已选项目

这种有针对性的方法有助于增强安全性和自定义配置，确保应用程序仅在真正需要的地方使用。

安装事件通信流

在账户设置中安装 Crowdin 应用程序时，将发生授权流程，在此过程中 Crowdin 与 Crowdin 应用程序交换授权数据（授权码被交换为访问令牌）。 在下图中，您可以看到此过程中发生的事件。

注意

已安装事件仅用于 authorization.type: "crowdin_app"。

让我们详细分析图示中每个步骤所发生的情况：

1. 安装 Manifest URL - 用户在账户设置 > Crowdin 应用程序中粘贴 Manifest URL，然后点击安装。
2. 从 Manifest URL 获取内容 - 请求被发送至 Crowdin 应用程序。
3. 响应：manifest JSON - Crowdin 应用程序返回包含应用程序相关数据的 Manifest JSON。
4. Manifest 数据验证 - 根据 Manifest JSON 的结构和数据对接收到的内容进行验证。
5. 安装提示 - 向用户显示 Crowdin 应用程序的相关信息、权限列表以及安装按钮。
6. 确认安装 - 用户确认安装 Crowdin 应用程序。
7. 已安装事件 - Crowdin 将包含授权码的已安装事件发送至 Crowdin 应用程序，用于生成 API 令牌。
8. 令牌请求 - Crowdin 应用程序发送获取 API 令牌的请求：

   POST https://accounts.crowdin.com/oauth/token

9. 访问令牌 - 授权服务返回 API 访问令牌和刷新令牌。
10. 成功状态码响应 - Crowdin 应用程序返回成功状态码（2xx），确认应用程序安装已成功完成。 如果状态码不同，该应用程序将从 Crowdin 账户中移除。

令牌请求参数（第 8 步）：

grant_type: crowdin_app	类型： string 必填： 是 描述： 该参数用于指定 OAuth 应用程序的流程。
client_id	类型： string 必填： 是 描述： 应用程序的客户端 ID，在应用程序注册时获取。
client_secret	类型： string 必填： 是 描述： 应用程序的客户端密钥，在应用程序注册时获取。
app_id	类型： string 必填： 是 描述： 应用程序描述符中的 Crowdin 应用程序标识符。
app_secret	类型： string 必填： 是 描述： 用于授权您的 Crowdin 应用程序的唯一密钥。 此值从已安装事件中获取。
domain	类型： string|null 必填： 是 描述： 访问应用时所在组织的名称。 此值从已安装事件中获取。
user_id	类型： integer 必填： 是 描述： 安装该应用程序的用户的标识符。 此值从已安装事件中获取。