docs: add comprehensive AAR integration troubleshooting guide

- Add AAR Duplicate Class Issues section to BUILDING.md with step-by-step solutions
- Create dedicated docs/aar-integration-troubleshooting.md with complete troubleshooting guide
- Document project reference approach (recommended) vs AAR-only approach
- Add verification steps, prevention strategies, and best practices
- Update README.md with links to new documentation
- Resolve duplicate class issues through proper project reference configuration

Fixes AAR integration issues that caused build failures due to plugin being
included both as project reference and AAR file simultaneously.

test-apps/daily-notification-test/src/types/global.d.ts

@@ -28,6 +28,26 @@ declare global {
       }): Promise<void>
       cancelNotification(id: string): Promise<void>
       requestPermissions(): Promise<boolean>
+      getNotificationStatus(): Promise<{
+        isEnabled: boolean
+        isScheduled: boolean
+        lastNotificationTime: number
+        nextNotificationTime: number
+        pending: number
+        error?: string
+      }>
+      checkPermissions(): Promise<{
+        notifications: 'granted' | 'denied' | 'prompt'
+        exactAlarms: 'granted' | 'denied' | 'not_supported'
+        batteryOptimization: 'granted' | 'denied' | 'not_supported'
+        overall: 'ready' | 'partial' | 'blocked'
+      }>
+      getExactAlarmStatus(): Promise<{
+        supported: boolean
+        enabled: boolean
+        canSchedule: boolean
+      }>
+      requestNotificationPermissions(): Promise<void>
     }
     Capacitor?: {
       Plugins?: {
@@ -50,6 +70,26 @@ declare global {
           }): Promise<void>
           cancelNotification(id: string): Promise<void>
           requestPermissions(): Promise<boolean>
+          getNotificationStatus(): Promise<{
+            isEnabled: boolean
+            isScheduled: boolean
+            lastNotificationTime: number
+            nextNotificationTime: number
+            pending: number
+            error?: string
+          }>
+          checkPermissions(): Promise<{
+            notifications: 'granted' | 'denied' | 'prompt'
+            exactAlarms: 'granted' | 'denied' | 'not_supported'
+            batteryOptimization: 'granted' | 'denied' | 'not_supported'
+            overall: 'ready' | 'partial' | 'blocked'
+          }>
+          getExactAlarmStatus(): Promise<{
+            supported: boolean
+            enabled: boolean
+            canSchedule: boolean
+          }>
+          requestNotificationPermissions(): Promise<void>
         }
         Clipboard?: {
           write(options: { string: string }): Promise<void>

test-apps/daily-notification-test/src/views/HomeView.vue

@@ -239,6 +239,13 @@ const checkSystemStatus = async (): Promise<void> => {
           // Log permission status for debugging
           if (!mappedStatus.postNotificationsGranted) {
             console.warn('⚠️ Notification permissions not granted - user needs to enable in settings')
+            console.log('🔧 Testing permission request...')
+            try {
+              await plugin.requestPermissions()
+              console.log('✅ Permission request completed')
+            } catch (permError) {
+              console.error('❌ Permission request failed:', permError)
+            }
           }
         } catch (error) {
           console.error('❌ Plugin status check failed:', error)