capacitor-android

用途

该技能用于处理 Capacitor 跨平台开发中 Web 层（React）与原生层（Java/Android）之间的复杂交互，重点面向后台定位追踪场景。它让助手能够协助编写、修改和调试 Android 原生 Java 代码，并与 Capacitor 插件桥接配合使用。

主要能力

1. Android 前台服务

• 生命周期管理：LocationTrackingService.java 的启动、停止与重启逻辑。
• 通知：维护 Android 前台任务所需的常驻通知。
• 开机持久化：实现 BOOT_COMPLETED 接收器，使设备重启后自动恢复追踪。

2. 电池与电源管理

• Wakelock：智能管理 PARTIAL_WAKE_LOCK，在追踪一致性与电池续航之间取得平衡。
• Doze 模式：使用 AlarmManager.setExactAndAllowWhileIdle() 实现可靠的 60 秒间隔。
• 优化白名单：处理 REQUEST_IGNORE_BATTERY_OPTIMIZATIONS。

3. Capacitor 插件开发

• 桥接通信：在 ProTrackingPlugin.java 与 React 之间高效传递数据。
• 原生到 Web 事件：使用 notifyListeners 在 UI 中实现实时状态更新。

4. 后台地理定位

• 提供程序：微调 FusedLocationProviderClient 设置（Priority、Interval、FastestInterval）。
• 权限：管理细粒度定位权限（Fine、Background）与通知权限。

使用方式

该技能以知识领域和响应准则的形式提供指导。在修改 Java 代码时，需确保线程安全（尤其是网络调用和位置更新）；始终建议在获取 GPS 定位或发生超时后释放 Wakelock；对 LocationApiClient.java 中失败的 HTTP 请求建议采用指数退避；并需考虑 Android 14+ 的要求（前台服务类型）。

适用场景

适用于在 Capacitor 项目中开发或维护 Android 原生后台追踪功能的场景，包括前台服务、电池优化、插件桥接与后台定位等具体任务。

限制

资料未提供该技能的具体安装命令、收费方式、支持平台范围或实际效果验证信息，这些内容暂未提供。