Android Serialization Offline Sync
When To Use
- Use this skill when the request is about: offline sync android, serialization model mapping android, conflict resolution android cache.
- Primary outcome: Coordinate serialization, caching, conflict handling, and offline-first sync flows in Android apps.
- Handoff skills when the scope expands:
android-networking-retrofit-okhttpandroid-room-database
Workflow
- Confirm the data source, persistence boundary, sync model, and device capability involved.
- Model contracts explicitly before wiring network, storage, media, or background APIs.
- Apply the recommended AndroidX or platform pattern with migration-safe defaults.
- Validate offline, retry, and process death behavior against the sample apps and scenarios.
- Escalate security, performance, or release risk to the linked supporting skills when needed.
Guardrails
- Prefer typed models and explicit serializers over ad-hoc maps or bundles.
- Keep background work idempotent and cancellation-aware.
- Do not leak storage, media, or networking details into presentation code.
- Treat user data durability, privacy, and migration paths as part of the implementation.
Anti-Patterns
- Blocking the main thread with disk or network calls.
- Treating retryable sync failures as terminal user-facing errors.
- Mixing cache models and wire models without a mapping layer.
- Requesting broad storage or notification capabilities when a narrower API exists.
Examples
Happy path
- Scenario: Sync local task edits to a remote model with explicit mapping.
- Command:
cd examples/orbittasks-compose &&./gradlew:app:testDebugUnitTest
Edge case
- Scenario: Recover when remote and local timestamps disagree after offline edits.
- Command:
cd examples/orbittasks-xml &&./gradlew:app:testDebugUnitTest
Failure recovery
- Scenario: Keep sync/serialization work separate from pure networking or Room-only requests.
- Command:
python3 scripts/eval_triggers.py --skill android-serialization-offline-sync
Done Checklist
- The implementation path is explicit, minimal, and tied to the right Android surface.
- Relevant example commands and benchmark prompts have been exercised or updated.
- Handoffs to adjacent skills are documented when the request crosses boundaries.
- Official references cover the chosen pattern and the main migration or troubleshooting path.