Restructure Android project from nested module layout to standard
Capacitor plugin structure following community conventions.
Structure Changes:
- Move plugin code from android/plugin/ to android/src/main/java/
- Move test app from android/app/ to test-apps/android-test-app/app/
- Remove nested android/plugin module structure
- Remove nested android/app test app structure
Build Infrastructure:
- Add Gradle wrapper files (gradlew, gradlew.bat, gradle/wrapper/)
- Transform android/build.gradle from root project to library module
- Update android/settings.gradle for standalone plugin builds
- Add android/gradle.properties with AndroidX configuration
- Add android/consumer-rules.pro for ProGuard rules
Configuration Updates:
- Add prepare script to package.json for automatic builds on npm install
- Update package.json version to 1.0.1
- Update android/build.gradle to properly resolve Capacitor dependencies
- Update test-apps/android-test-app/settings.gradle with correct paths
- Remove android/variables.gradle (hardcode values in build.gradle)
Documentation:
- Update BUILDING.md with new structure and build process
- Update INTEGRATION_GUIDE.md to reflect standard structure
- Update README.md to remove path fix warnings
- Add test-apps/BUILD_PROCESS.md documenting test app build flows
Test App Configuration:
- Fix android-test-app to correctly reference plugin and Capacitor
- Remove capacitor-cordova-android-plugins dependency (not needed)
- Update capacitor.settings.gradle path verification in fix script
BREAKING CHANGE: Plugin now uses standard Capacitor Android structure.
Consuming apps must update their capacitor.settings.gradle to reference
android/ instead of android/plugin/. This is automatically handled by
Capacitor CLI for apps using standard plugin installation.
- Change ChannelManager DEFAULT_CHANNEL_ID from 'daily_default' to 'timesafari.daily'
- Ensures consistent channel ID usage across Plugin, ChannelManager, and Receivers
- Removes duplicate channel creation - ChannelManager is now single source of truth
- Add ChannelManager class for notification channel management
- Implement channel existence checking and creation
- Add channel importance validation (guards against IMPORTANCE_NONE)
- Add deep link to channel settings when notifications are blocked
- Integrate channel manager into plugin load() method
- Add new plugin methods: isChannelEnabled(), openChannelSettings(), checkStatus()
- Add comprehensive status checking including permissions and channel state
- Add test app UI for channel management testing
P0 Priority Implementation:
- Guards against channel = NONE (blocked notifications)
- Provides actionable error messages with deep links to settings
- Ensures notifications can actually be delivered
- Comprehensive status checking for all notification requirements
This addresses the critical issue where notifications are scheduled
but silently dropped due to blocked notification channels.
Matthew Raymer