AirBattery 技术文档

AirBattery 是一款专为 macOS 用户设计的应用程序，它允许用户在 Mac 上集中管理和监控所有支持的设备（如 iPhone、iPad、Apple Watch 等）的电池状态。无论是通过无线网络还是直接的USB连接，AirBattery都能让你一目了然地了解周围设备的电量，大大提升设备管理的便捷性。

安装指南

系统要求

确保您的 Mac 运行的是 macOS 11.0 或更高版本。

下载与安装

1. 直接下载: 访问项目 GitHub 释放页面，下载最新的 .dmg 文件，并拖拽应用至应用程序文件夹。
2. Homebrew 安装: 如果您习惯使用 Homebrew，可以在终端输入以下命令：

   brew install lihaoyun6/tap/airbattery
   

安全设置注意事项

首次运行，如果遇到因证书问题无法运行的情况，请按照提示操作，检查是否需要右键点击应用，选择“显示简介”，然后勾选“覆盖恶意软件保护”，或等待几小时重试。

使用说明

启动与界面

• AirBattery 启动后，默认在 Dock 栏和状态栏同时显示图标。
• 直接点击图标，或者利用新增的小组件，可以查看所有已连接或配对设备的电池百分比。

配对与连接

• 对于 iPhone 和 iPad，首次需通过USB连接至Mac，并在设备上信任该电脑。后续将自动通过WiFi同步电量信息。
• Apple Watch无需额外操作，当AirBattery检测到已连接iPhone时，会间接读取手表电量。

自定义设置

• 通过偏好设置，您可以自定义是否在状态栏显示实时电量，隐藏不需要监视的设备，或调整通知设置。

项目API使用文档

AirBattery虽然主要作为一个桌面应用，但它的内部逻辑涉及到与外部设备通信的部分，可以视为一种“API”实现，尤其是对于开发者而言：

• libimobiledevice集成：用于处理与iOS设备的底层通讯，例如通过USB或网络获取设备状态。
• MultipeerKit框架：支持局域网内的设备发现与数据传输，这是实现“真隔空”功能的基础。

请注意，普通用户可能不直接接触这些API接口，但对于希望深入了解或二次开发的开发者，上述组件提供了潜在的接口接入点。

项目安装方式总结

• 图形界面安装：通过.dmg文件拖放安装。
• 命令行安装：使用Homebrew快速部署。

通过遵循上述步骤，您能够轻松地安装和使用AirBattery，享受高效的设备电量监控体验。记住，安全设置是关键一步，务必按指示操作以保证应用的顺利运行。