Support App API参考：开发者接口使用详解-平芜编程栈

Support App API参考：开发者接口使用详解

【免费下载链接】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的开发者接口，帮助开发者快速集成和扩展其功能。

核心API协议概览

Support App提供了多个核心API协议，用于实现不同的功能模块。这些协议定义了接口的方法和参数，为开发者提供了清晰的调用规范。

SupportXPCProtocol

该协议是XPC服务的核心接口，提供了执行脚本、获取更新声明和验证应用目录代码需求等功能。协议定义如下：

@objc protocol SupportXPCProtocol { @objc func executeScript(command: String, completion: @escaping ((NSNumber) -> Void)) -> Void @objc func getUpdateDeclaration(completion: @escaping (Data) -> Void) -> Void @objc func verifyAppCatalogCodeRequirement(completion: @escaping (Bool) -> Void) -> Void }

文件路径：src/SupportXPC/SupportXPCProtocol.swift

SupportHelperProtocol

该协议定义了特权助手工具的接口，主要用于执行脚本命令。协议定义如下：

@objc(SupportHelperProtocol) protocol SupportHelperProtocol { @objc func executeScript(command: String, completion: @escaping ((NSNumber) -> Void)) -> Void }

文件路径：src/SupportHelper/SupportHelperProtocol.swift

主要API方法详解

执行脚本命令

executeScript方法允许开发者在设备上执行系统命令，适用于需要管理员权限的操作。

方法定义：

@objc func executeScript(command: String, completion: @escaping ((NSNumber) -> Void)) -> Void

参数说明：

command：要执行的命令字符串
completion：执行完成后的回调，返回命令执行结果（0表示成功，非0表示失败）

使用示例：

proxy.executeScript(command: "echo 'Hello Support App'") { result in if result == 0 { print("命令执行成功") } else { print("命令执行失败，错误码：\(result)") } }

获取更新声明

getUpdateDeclaration方法用于获取软件更新的声明数据，帮助开发者实现应用更新功能。

方法定义：

@objc func getUpdateDeclaration(completion: @escaping (Data) -> Void) -> Void

参数说明：

completion：获取完成后的回调，返回更新声明的Data数据

使用场景：结合App Catalog功能，可以实现应用更新提醒和一键更新功能。

验证应用目录代码需求

verifyAppCatalogCodeRequirement方法用于验证应用目录的代码签名，确保应用的安全性。

方法定义：

@objc func verifyAppCatalogCodeRequirement(completion: @escaping (Bool) -> Void) -> Void

参数说明：

completion：验证完成后的回调，返回布尔值表示验证结果

配置与集成指南

XPC连接建立

要使用SupportXPCProtocol，需要建立XPC连接。以下是连接建立的示例代码：

connectionToService = NSXPCConnection(serviceName: "nl.root3.support.xpc") connectionToService.remoteObjectInterface = NSXPCInterface(with: SupportXPCProtocol.self) connectionToService.resume()

Jamf Pro配置

Support App可以与Jamf Pro集成，通过自定义配置文件进行管理。以下是Jamf Pro中的配置界面：

配置文件路径：Configuration Profile Samples/Support App Configuration Sample.mobileconfig

扩展脚本

Support App支持通过扩展脚本来增强功能。示例脚本位于：

Extension Sample Scripts/2.x/Jamf Connect Elevated Privileges/jamf_connect_elevated_privileges_change.zsh
Extension Sample Scripts/2.x/User Permissions/user_permissions.zsh