- Document that npx cap sync fails in plugin development projects (expected behavior)
- Add troubleshooting for incorrect Gradle project names
- List available Gradle projects and recommend :plugin for builds
- Clarify that www/ directory missing is normal for plugin projects
This addresses the specific failures seen in the terminal output and
provides clear guidance for future users.
- Create fix-capacitor-build.sh script to restore fixes after Capacitor operations
- Update build-native.sh to automatically apply fix when needed
- Add warnings to BUILDING.md about auto-generated file risks
- Document which Capacitor commands will overwrite manual fixes
This protects against losing the capacitor.build.gradle fix when running
npx cap sync, npx cap update, or other Capacitor CLI commands.
- Fix capacitor.build.gradle to comment out missing Capacitor integration file
- Create separate plugin module with proper build.gradle configuration
- Copy plugin source code to android/plugin/src/main/java/
- Update settings.gradle to include plugin module
- Fix plugin build.gradle to remove Kotlin plugin dependency
- Successfully build plugin AAR: android/plugin/build/outputs/aar/plugin-release.aar
- Update BUILDING.md with correct build commands and troubleshooting
This resolves the Android Studio build issues by creating a proper
plugin library module separate from the test app.
- Update Last Updated field to 2025-10-12 04:57:00 UTC
- Use actual system date instead of hardcoded date
- Maintains documentation freshness and accuracy
- Document Android Studio setup and limitations
- Explain plugin development vs full app development
- Provide step-by-step build instructions
- Include troubleshooting and best practices
- Cover all build methods: script, command line, Android Studio
- Add testing strategies and development workflow
- Clarify project structure and file organization
This addresses the need for clear build documentation
for developers working with the Capacitor plugin.
Matthew Raymer