Support App扩展脚本开发教程：创建自定义诊断工具

发布时间：2026/7/10 18:22:28

Support App扩展脚本开发教程：创建自定义诊断工具

【免费下载链接】SupportAppThe Support App is developed by Root3, specialized in managing Apple devices. Root3 offers consultancy and support for organizations to get the most out of their Apple devices and is based in The Netherlands (Halfweg).项目地址: https://gitcode.com/gh_mirrors/su/SupportApp

Support App是由Root3开发的Apple设备管理工具，专为组织优化Apple设备使用体验而设计。本教程将指导你如何为Support App开发扩展脚本，轻松创建功能强大的自定义诊断工具，帮助管理员和用户快速获取设备信息、监控系统状态。

扩展脚本基础：了解Support App的灵活性

Support App通过扩展脚本机制提供了强大的自定义能力，允许开发者创建各种实用工具。这些脚本通常使用Zsh编写，可以访问系统信息、修改偏好设置，并与Support App的用户界面无缝集成。

Support App的可配置按钮界面，展示了扩展脚本如何集成到主界面

扩展脚本主要分为两类：

信息展示类：如电池状态、网络信息等
操作执行类：如合规性检查、系统修复等

所有扩展脚本都位于项目的Extension Sample Scripts目录下，你可以参考这些示例快速上手：

Extension Sample Scripts/2.x/ - 包含电池状态、权限管理等多种实用脚本
Extension Sample Scripts/Jamf Last Check-In/ - 与Jamf Pro集成的示例

快速入门：创建你的第一个诊断脚本

让我们通过创建一个简单的"电池状态检查"工具，了解Support App扩展脚本的基本结构和开发流程。

1. 脚本基础结构

所有Support App扩展脚本都遵循相同的基本结构：

#!/bin/zsh # Support App Extension - [脚本名称] # Copyright [年份] Root3 B.V. All rights reserved. # [脚本描述] # Support App偏好设置文件路径 preference_file_location="/Library/Preferences/nl.root3.support.plist" # 显示加载指示器 defaults write "${preference_file_location}" ExtensionLoadingB -bool true defaults write "${preference_file_location}" ExtensionValueB -string "KeyPlaceholder" # 保持加载效果0.5秒 sleep 0.5 # [核心功能实现] # 更新结果到Support App界面 defaults write "${preference_file_location}" ExtensionValueB -string "${result}" # 停止加载指示器 defaults write "${preference_file_location}" ExtensionLoadingB -bool false

你可以参考示例脚本Extension Sample Scripts/2.x/battery_condition.zsh来实现这个结构。

2. 实现核心诊断功能

对于电池状态检查工具，我们需要获取系统电池信息并格式化输出：

# 获取电池状态 battery_condition=$(system_profiler SPPowerDataType | sed -n -e 's/^.*Condition: //p') # 写入结果到Support App偏好设置 defaults write "${preference_file_location}" ExtensionValueB -string "${battery_condition}"

这段代码使用system_profiler命令获取电池状态，并通过defaults命令将结果写入Support App的偏好设置文件，从而在界面上显示。

3. 安装与配置脚本

创建好脚本后，需要将其安装到系统并配置Support App以使用它。可以参考安装脚本模板Extension Sample Scripts/2.x/mSCP Compliance Status/install_extension-mscp_compliance_status.zsh来实现自动化安装。

基本安装步骤包括：

将脚本复制到/usr/local/bin目录
设置正确的权限（通常为755）
配置Support App偏好设置指向新脚本

# 复制脚本到系统目录 sudo cp your_script.zsh /usr/local/bin/ # 设置权限 sudo chown root:wheel /usr/local/bin/your_script.zsh sudo chmod 755 /usr/local/bin/your_script.zsh

高级技巧：创建交互式诊断工具

除了简单的信息展示，你还可以创建具有交互功能的诊断工具，如合规性检查和自动修复工具。这类工具通常包含两个部分：检查脚本和修复脚本。

1. 实现检查逻辑

检查脚本负责评估系统状态并报告问题，例如mSCP合规性检查脚本：

# 获取不合规项 audit=$(ls -l /Library/Preferences | grep 'org.*.audit.plist' | awk '{print $NF}') FAILED_RULES=() # 分析合规性结果 if [[ ! -z "$audit" ]]; then # [解析合规性数据的逻辑] # 计算不合规项数量 count=0 for finding in ${FAILED_RULES[@]}; do if [[ ! " ${EXEMPT_RULES[*]} " =~ " ${finding} " ]] ;then ((count=count+1)) fi done fi # 更新Support App界面 if [[ ${count} -gt 0 ]]; then defaults write "/Library/Preferences/nl.root3.support.plist" ExtensionValueB "发现${count}个问题" defaults write "/Library/Preferences/nl.root3.support.plist" ExtensionAlertB -bool true else defaults write "/Library/Preferences/nl.root3.support.plist" ExtensionValueB "系统合规" defaults write "/Library/Preferences/nl.root3.support.plist" ExtensionAlertB -bool false fi

2. 添加修复功能

修复脚本可以在发现问题时执行 remediation 操作，通常通过调用Jamf Pro策略或其他系统工具：

# 执行修复操作 custom_trigger="mscp_remediation" /usr/local/bin/jamf policy -event ${custom_trigger} # 修复后重新检查状态 "/usr/local/bin/mscp_compliance_status.sh"

集成到Support App界面

开发完成后，需要配置Support App以显示和使用你的自定义诊断工具。这通常通过修改Support App的偏好设置来实现：

# 配置扩展A显示电池状态 defaults write /Library/Preferences/nl.root3.support.plist ExtensionTitleA "电池状态" defaults write /Library/Preferences/nl.root3.support.plist ExtensionSymbolA "battery.75percent" defaults write /Library/Preferences/nl.root3.support.plist ExtensionTypeA "PrivilegedScript" defaults write /Library/Preferences/nl.root3.support.plist ExtensionLinkA "/usr/local/bin/battery_condition.zsh"

配置完成后，你的自定义诊断工具将显示在Support App界面上，用户可以直接点击查看结果或执行操作。

Support App的自定义提示界面，可用于显示诊断结果或操作确认