# Capacitor Android

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

- Skill: `abelv22/capacitor-android` (Agent Skill)
- Install (CLI): `npx skillmds@latest add abelv22/capacitor-android`
- Raw SKILL.md: https://api.skillmd.com/api/skills/abelv22/capacitor-android/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: abelv22 (https://skillmd.com/u/abelv22)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/abelv22/capacitor-android

---


# 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).