/react-native-brownfield-migration

Skill: Bare Android Native Integration

Consume published bare RN AAR in host Android app and verify runtime rendering.

Quick Command

// settings.gradle.kts
repositories { mavenLocal() }

// app/build.gradle.kts
dependencies { implementation("<groupId>:<artifactId>:<version>") }

When to Use

• Consuming locally published AAR from bare RN artifact module
• Wiring host startup and rendering for RN-powered screens

Prerequisites

• bare-android-aar-generation.md completed
• AAR published to local Maven
• Host app Gradle sync is healthy

Agent-Assisted Verification

Use agent-device after the host build succeeds. Read the agent-device skill or CLI help when available before exact commands. If it is missing and verification needs it, install it through the environment's approved/trusted path or ask the user to install or enable it. Then open the host app, navigate to the RN surface, capture snapshots/screenshots, and collect logs for runtime behavior.

Step-by-Step Instructions

Progress checklist:
- [ ] Add mavenLocal in host repositories
- [ ] Add dependency coordinate
- [ ] Initialize host runtime
- [ ] Render RN module

1. Add mavenLocal() in host dependencyResolutionManagement repositories.
2. Add published dependency coordinate in app module.
3. Initialize runtime before RN UI creation:

ReactNativeHostManager.initialize(this.application) {
    println("JS bundle loaded")
}

4. Render RN UI:
   • ReactNativeFragment.createReactNativeFragment("<registered_module_name>")
   • or ReactNativeBrownfield.shared.createView(...)
5. Verify host app resolves dependency and RN module renders.
   • Capture agent-assisted device evidence, using agent-device when possible.

Stop Conditions

Mark complete only if:

• Gradle sync/build succeeds with published coordinate
• runtime initializes before UI creation
• RN module renders expected screen

If Failed

• Re-check coordinate and repository order
• Re-package and re-publish if artifact is stale
• Re-check module name registration in JS

Canonical Docs

• Android Integration
• Guidelines
• Troubleshooting

Common Pitfalls

• Missing mavenLocal()
• Dependency coordinate mismatch
• Creating RN UI before host manager initialization

Related Skills

• bare-android-aar-generation.md - Bare Android artifact generation
• bare-quick-start.md - Bare setup prerequisites