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.
This commit is contained in:
Matthew Raymer
2025-10-23 10:29:32 +00:00
parent ef37b10503
commit 7185c87e93
13 changed files with 113 additions and 135 deletions

View File

@@ -9,13 +9,12 @@
*/
import { Capacitor } from '@capacitor/core';
import { DailyNotification } from '@timesafari/daily-notification-plugin';
/**
* Permission status interface
*/
export interface PermissionStatus {
notifications: 'granted' | 'denied' | 'prompt';
notifications: 'granted' | 'denied' | 'prompt' | 'not_supported';
exactAlarms: 'granted' | 'denied' | 'not_supported';
batteryOptimization: 'granted' | 'denied' | 'not_supported';
overall: 'ready' | 'partial' | 'blocked';
@@ -163,7 +162,7 @@ export class NotificationPermissionManager {
return {
success: false,
permissions: await this.checkPermissions(),
message: 'Failed to request permissions: ' + error.message
message: 'Failed to request permissions: ' + (error instanceof Error ? error.message : String(error))
};
}
}
@@ -272,19 +271,19 @@ export class NotificationPermissionManager {
// Private helper methods
private async checkNotificationPermissions(): Promise<'granted' | 'denied' | 'prompt'> {
private async checkNotificationPermissions(): Promise<'granted' | 'denied' | 'prompt' | 'not_supported'> {
try {
if (Capacitor.getPlatform() === 'web') {
return 'not_supported';
}
// Check if we can access the plugin
if (typeof DailyNotification === 'undefined') {
return 'denied';
if (typeof (window as any).Capacitor?.Plugins?.DailyNotification === 'undefined') {
return 'not_supported';
}
const status = await DailyNotification.checkPermissions();
return status.notifications || 'denied';
const status = await (window as any).Capacitor?.Plugins?.DailyNotification?.checkPermissions();
return status?.notifications || 'denied';
} catch (error) {
console.error('Error checking notification permissions:', error);
@@ -298,12 +297,12 @@ export class NotificationPermissionManager {
return 'not_supported';
}
if (typeof DailyNotification === 'undefined') {
if (typeof (window as any).Capacitor?.Plugins?.DailyNotification === 'undefined') {
return 'denied';
}
const status = await DailyNotification.getExactAlarmStatus();
return status.canSchedule ? 'granted' : 'denied';
const status = await (window as any).Capacitor?.Plugins?.DailyNotification?.getExactAlarmStatus();
return status?.canSchedule ? 'granted' : 'denied';
} catch (error) {
console.error('Error checking exact alarm permissions:', error);
@@ -317,12 +316,12 @@ export class NotificationPermissionManager {
return 'not_supported';
}
if (typeof DailyNotification === 'undefined') {
if (typeof (window as any).Capacitor?.Plugins?.DailyNotification === 'undefined') {
return 'denied';
}
const status = await DailyNotification.getBatteryStatus();
return status.isOptimized ? 'denied' : 'granted';
const status = await (window as any).Capacitor?.Plugins?.DailyNotification?.getBatteryStatus();
return status?.isOptimized ? 'denied' : 'granted';
} catch (error) {
console.error('Error checking battery optimization status:', error);
@@ -346,14 +345,14 @@ export class NotificationPermissionManager {
private async requestNotificationPermissions(): Promise<{ success: boolean; message: string }> {
try {
if (typeof DailyNotification === 'undefined') {
if (typeof (window as any).Capacitor?.Plugins?.DailyNotification === 'undefined') {
return { success: false, message: 'Plugin not available' };
}
const result = await DailyNotification.requestPermissions();
const result = await (window as any).Capacitor?.Plugins?.DailyNotification?.requestPermissions();
return {
success: result.notifications === 'granted',
message: result.notifications === 'granted' ? 'Notification permissions granted' : 'Notification permissions denied'
success: result?.notifications === 'granted',
message: result?.notifications === 'granted' ? 'Notification permissions granted' : 'Notification permissions denied'
};
} catch (error) {
@@ -363,17 +362,17 @@ export class NotificationPermissionManager {
private async requestExactAlarmPermissions(): Promise<{ success: boolean; message: string }> {
try {
if (typeof DailyNotification === 'undefined') {
if (typeof (window as any).Capacitor?.Plugins?.DailyNotification === 'undefined') {
return { success: false, message: 'Plugin not available' };
}
await DailyNotification.requestExactAlarmPermission();
await (window as any).Capacitor?.Plugins?.DailyNotification?.requestExactAlarmPermission();
// Check if permission was granted
const status = await DailyNotification.getExactAlarmStatus();
const status = await (window as any).Capacitor?.Plugins?.DailyNotification?.getExactAlarmStatus();
return {
success: status.canSchedule,
message: status.canSchedule ? 'Exact alarm permissions granted' : 'Exact alarm permissions denied'
success: status?.canSchedule,
message: status?.canSchedule ? 'Exact alarm permissions granted' : 'Exact alarm permissions denied'
};
} catch (error) {
@@ -383,17 +382,17 @@ export class NotificationPermissionManager {
private async requestBatteryOptimizationExemption(): Promise<{ success: boolean; message: string }> {
try {
if (typeof DailyNotification === 'undefined') {
if (typeof (window as any).Capacitor?.Plugins?.DailyNotification === 'undefined') {
return { success: false, message: 'Plugin not available' };
}
await DailyNotification.requestBatteryOptimizationExemption();
await (window as any).Capacitor?.Plugins?.DailyNotification?.requestBatteryOptimizationExemption();
// Check if exemption was granted
const status = await DailyNotification.getBatteryStatus();
const status = await (window as any).Capacitor?.Plugins?.DailyNotification?.getBatteryStatus();
return {
success: !status.isOptimized,
message: !status.isOptimized ? 'Battery optimization exemption granted' : 'Battery optimization exemption denied'
success: !status?.isOptimized,
message: !status?.isOptimized ? 'Battery optimization exemption granted' : 'Battery optimization exemption denied'
};
} catch (error) {
@@ -420,12 +419,12 @@ export class NotificationPermissionManager {
alert(message);
}
private async showExactAlarmDeniedDialog(education: PermissionEducation): Promise<void> {
private async showExactAlarmDeniedDialog(_education: PermissionEducation): Promise<void> {
const message = `Exact alarms are disabled. Notifications may not arrive at the exact time you specified.\n\nTo enable exact alarms:\n• Go to device settings\n• Find this app\n• Enable "Alarms & reminders"`;
alert(message);
}
private async showBatteryOptimizationDeniedDialog(education: PermissionEducation): Promise<void> {
private async showBatteryOptimizationDeniedDialog(_education: PermissionEducation): Promise<void> {
const message = `Battery optimization is enabled. This may prevent notifications from arriving on time.\n\nTo disable battery optimization:\n• Go to device settings\n• Find "Battery optimization"\n• Select this app\n• Choose "Don't optimize"`;
alert(message);
}

View File

@@ -511,39 +511,30 @@ export class ValidatedDailyNotificationPlugin {
}
// Native implementation methods (to be implemented)
private async nativeScheduleDailyNotification(options: z.infer<typeof NotificationOptionsSchema>): Promise<void> {
private async nativeScheduleDailyNotification(_options: z.infer<typeof NotificationOptionsSchema>): Promise<void> {
// Implementation will call the actual plugin
throw new Error('Native implementation not yet connected');
}
private async nativeScheduleDailyReminder(options: z.infer<typeof ReminderOptionsSchema>): Promise<void> {
private async nativeScheduleDailyReminder(_options: z.infer<typeof ReminderOptionsSchema>): Promise<void> {
// Implementation will call the actual plugin
throw new Error('Native implementation not yet connected');
}
private async nativeScheduleContentFetch(config: z.infer<typeof ContentFetchConfigSchema>): Promise<void> {
private async nativeScheduleContentFetch(_config: z.infer<typeof ContentFetchConfigSchema>): Promise<void> {
// Implementation will call the actual plugin
throw new Error('Native implementation not yet connected');
}
private async nativeScheduleUserNotification(config: z.infer<typeof UserNotificationConfigSchema>): Promise<void> {
private async nativeScheduleUserNotification(_config: z.infer<typeof UserNotificationConfigSchema>): Promise<void> {
// Implementation will call the actual plugin
throw new Error('Native implementation not yet connected');
}
private async nativeScheduleDualNotification(config: z.infer<typeof DualScheduleConfigurationSchema>): Promise<void> {
private async nativeScheduleDualNotification(_config: z.infer<typeof DualScheduleConfigurationSchema>): Promise<void> {
// Implementation will call the actual plugin
throw new Error('Native implementation not yet connected');
}
}
// Export schemas and service
export {
NotificationOptionsSchema,
ReminderOptionsSchema,
ContentFetchConfigSchema,
UserNotificationConfigSchema,
DualScheduleConfigurationSchema
};
export default NotificationValidationService;