将 Shade PKG 部署到 Jamf Pro

本指南将演示如何下载 Shade 安装包（PKG）并将其上传到 Jamf Pro，以便部署到 Mac。

有关最新文档，请参阅 Jamf Pro 的 PKG 文档

先决条件

• 可访问 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 文件夹中。