> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-zh/qi-ye-ban/jiang-shade-pkg-bu-shu-dao-jamf-pro.md).

# 将 Shade PKG 部署到 Jamf Pro

{% hint style="info" %}
有关最新文档，请参阅 [Jamf Pro 的 PKG 文档](https://learn.jamf.com/r/en-US/jamf-pro-documentation-current/Viewing_the_Contents_of_an_Indexed_Package)
{% endhint %}

#### 先决条件

* 可访问 Jamf Pro，并具有上传软件包的权限（通常为 **Jamf Pro Server Administrator** 或可管理 Packages 的角色）。
* 一台可使用浏览器下载安装程序的 Mac。
  * 如果您正在下载 macOS 应用，Shade 建议使用 Safari 之外的浏览器。

#### 1）下载 Shade PKG

1. 打开： <https://shade.inc/download>
2. 在 **下载 Shade**，并为您的 Mac 选择正确的构建版本：
   * **macOS（Apple Silicon）** 适用于 M 系列 Mac（M1、M2、M3、M4）
   * **macOS（Intel）** 适用于 Intel Mac
3. 下载安装程序文件。
4. 确认下载已完成，并且您有一个可上传的单一安装程序文件（例如，在 **下载**).

#### 2）（推荐）在上传前验证软件包

1. 确认您下载的是正确的架构（Apple Silicon 还是 Intel）。
2. 请确保文件：
   * 可在测试机器上成功打开或安装。
   * 具有合理的文件大小（不会异常地小）。
3. 将文件重命名为清晰且带版本号的名称（推荐），例如：
   * `Shade-Desktop-<version>.pkg`

#### 3）将 PKG 上传到 Jamf Pro

1. 登录 **Jamf Pro**.
2. 前往 **设置**.
3. 导航到 **Packages** 部分（有时列在 **Computer Management** 下，具体取决于您的 Jamf Pro 版本）。
4. 点击 **新建** 或 **上传** （标签因 Jamf Pro 版本而异）。
5. 在上传表单中，选择您下载的 Shade PKG。
6. 配置关键 **软件包设置** （常用选项）：
   * **显示名称**：使用清晰的名称（例如， `Shade`).
   * **类别**：可选，但有助于组织管理（例如， `应用程序`).
   * **优先级**：除非您有多个依赖软件包，否则保持默认值。
   * **操作系统要求**：如果您的环境有要求，可设置最低 macOS 版本。
   * **架构**：如果 Jamf 允许指定，请与您下载的软件包匹配（Apple Silicon 还是 Intel）。
7. 保存。
8. 等待上传完成，然后确认软件包出现在 **Packages** 列表中。

#### 4）确认软件包可用于部署

1. 在 Jamf Pro 中打开已上传的软件包。
2. 确认：
   * 软件包名称和详细信息看起来正确。
   * 软件包显示为已成功上传（无错误）。

#### 5）后续步骤（可选）：部署到设备

上传 PKG 后，您可以通过以下方式之一进行部署：

* **策略**：按需安装 Shade（Self Service）或自动安装（定期检查、注册）。
* **PreStage 注册**：在注册工作流程期间安装。

#### 通过 Self Service（按需）部署

如果您希望 Shade 出现在 Jamf Self Service 应用中，并允许用户选择何时安装，请使用此方法。

1. **创建新策略**：在 Jamf Pro 中，前往 **计算机** > **策略** 下方，然后点击 **新建**.
2. **常规载荷**:
   * **显示名称**: `安装 Shade`
   * **触发器**：无（Self Service 策略不需要系统触发器）。
   * **执行频率**: `持续` （这允许用户在更换新机器或意外删除应用后重新安装该应用）。
3. **软件包载荷**:
   * 点击 **配置** 并找到您已上传的 Shade PKG。
   * 确保操作设置为 **安装**.
4. **Self Service 载荷**:
   * 点击顶部的 **Self Service** 选项卡。
   * 勾选 **在 Self Service 中提供该策略**.
   * **Self Service 显示名称**: `Shade`
   * **按钮名称**: `安装`
   * **说明**：提供简短说明（例如，“Shade 是您的创意资产管理器...”）。
   * **图标**：上传 Shade 应用程序图标，以获得更专业的外观。
5. **范围**:
   * 点击顶部的 **范围** 选项卡。
   * 添加应在其 Self Service 目录中看到 Shade 的特定计算机或智能组（例如，“All Managed Clients”）。
6. **保存**.

***

#### 通过静默安装部署（自动）

如果您希望 Shade 自动安装到后台运行的 Mac 上且无需任何用户交互，请使用此方法。

1. **创建新策略**：在 Jamf Pro 中，前往 **计算机** > **策略** 下方，然后点击 **新建**.
2. **常规载荷**:
   * **显示名称**: `部署 Shade - 自动`
   * **触发器**：选择 **定期检查** （这是静默后台部署的标准触发器）。
   * **执行频率**：选择 **每台计算机一次**.
3. **软件包载荷**:
   * 点击 **配置** 并找到您已上传的 Shade PKG。
   * 确保操作设置为 **安装**.
4. **维护载荷**:
   * 点击 **配置** 并勾选 **更新库存** 复选框。这可确保 Jamf 在策略运行后立即知道该应用已安装。
5. **范围**:
   * 点击顶部的 **范围** 选项卡。
   * 添加需要 Shade 的计算机或智能组。
   * *提示：使用一个智能组，定位当前未安装“Shade.app”的计算机。*
6. **保存**.

***

#### 验证部署

保存策略后，您可以监控其进度：

* **日志**：在 Jamf Pro 中打开该策略，并点击右下角的 **日志** 按钮。这将显示哪些计算机已成功安装该软件包，以及哪些仍在等待中。
* **库存**：在 **应用程序** 下检查单台计算机的库存记录，以确认 `Shade.app` 出现在列表中。

#### 故障排除提示

* **架构不匹配**：如果静默安装失败，请确认您没有将 Intel PKG 部署到 Apple Silicon（M1/M2/M3）Mac 上。
* **FileVault**：如果您在注册（PreStage）期间部署，请确保未选择“Fill User Template”或“At Restart”选项，因为 Shade 应该正常安装到 `/Applications` 文件夹中。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://academy.shade.inc/shade-academy/shade-academy-zh/qi-ye-ban/jiang-shade-pkg-bu-shu-dao-jamf-pro.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.