Agent Skills
› NeverSight/learn-skills.dev
› capacitor-android
capacitor-android
GitHub专注于 Capacitor 跨平台开发中 Android 原生层（Java）的后台定位与电池优化。涵盖前台服务生命周期、Doze 模式适配、Wakelock 管理及插件桥接通信，确保后台追踪的稳定性与低功耗。
Trigger Scenarios
需要实现 Android 后台持续定位功能
处理 Android 电池优化和 Doze 模式兼容问题
开发 Capacitor 插件以桥接 Java 与 React
解决 Android 14+ 前台服务类型权限问题
Install
npx skills add NeverSight/learn-skills.dev --skill capacitor-android -g -y
SKILL.md
Frontmatter
{
"name": "capacitor-android",
"description": "Expert in Capacitor cross-platform development and Android native Java code for background services and battery optimization."
}
Capacitor & Android Native Bridge Skill
This skill enables the assistant to handle the complex interaction between the Web layer (React) and the Native layer (Java/Android) specifically for background tracking.
Knowledge Areas
1. Android Foreground Services
- Lifecycle Management: Start/stop/restart logic for
LocationTrackingService.java. - Notifications: Maintaining persistent notifications required by Android for foreground tasks.
- Boot Persistence: Implementing
BOOT_COMPLETEDreceivers to restart tracking on device reboot.
2. Battery & Power Management
- Wakelocks: Smart management of
PARTIAL_WAKE_LOCKto balance tracking consistency with battery life. - Doze Mode: Using
AlarmManager.setExactAndAllowWhileIdle()for reliable 60s intervals. - Optimization Whitelisting: Handling
REQUEST_IGNORE_BATTERY_OPTIMIZATIONS.
3. Capacitor Plugin Development
- Bridge Communication: Efficiently passing data between
ProTrackingPlugin.javaand React. - Native-to-Web Events: Using
notifyListenersfor real-time status updates in the UI.
4. Background Geolocation
- Providers: Fine-tuning
FusedLocationProviderClientsettings (Priority, Interval, FastestInterval). - Permissions: Managing granular location permissions (Fine, Background) and notification permissions.
Guidelines for Responses
- When modifying Java code, ensure Thread Safety (especially for network calls and location updates).
- Always recommend releasing Wakelocks when the GPS fix is obtained or if a timeout occurs.
- Suggest exponential backoff for failed HTTP requests in
LocationApiClient.java. - Keep in mind Android 14+ requirements (Foreground Service Types).
Version History
- e0220ca Current 2026-07-05 22:17
