Agent-Skills.md

Agent Skills: Capacitor & Android Native Bridge Skill

Expert in Capacitor cross-platform development and Android native Java code for background services and battery optimization.

UncategorizedID: abelv22/project-foundation/capacitor-android

Install this agent skill to your local

pnpm dlx add-skill https://github.com/AbelV22/project-foundation/tree/HEAD/.agent/skills/capacitor-android

Skill Files

Browse the full folder contents for capacitor-android.

Download Skill

Loading file tree…

.agent/skills/capacitor-android/SKILL.md

Skill Metadata

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_COMPLETED receivers to restart tracking on device reboot.

2. Battery & Power Management

  • Wakelocks: Smart management of PARTIAL_WAKE_LOCK to 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.java and React.
  • Native-to-Web Events: Using notifyListeners for real-time status updates in the UI.

4. Background Geolocation

  • Providers: Fine-tuning FusedLocationProviderClient settings (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).