daily-notification-plugin/test-apps/README.md

Test Apps Setup Guide

Overview

This guide creates minimal Capacitor test apps for validating the Daily Notification Plugin across all target platforms.

Directory Structure

test-apps/
├── android-test/          # Android test app
├── ios-test/              # iOS test app  
├── electron-test/         # Electron test app
├── setup-android.sh       # Android setup script
├── setup-ios.sh           # iOS setup script
├── setup-electron.sh      # Electron setup script
└── README.md              # This guide

Prerequisites

• Node.js 18+
• Capacitor CLI: npm install -g @capacitor/cli
• Android Studio (for Android)
• Xcode (for iOS)
• Platform-specific SDKs

Quick Start

Option 1: Automated Setup (Recommended)

# Setup all platforms
./setup-android.sh
./setup-ios.sh  
./setup-electron.sh

Option 2: Manual Setup

# Android
cd android-test
npm install
npx cap init "Daily Notification Android Test" "com.timesafari.dailynotification.androidtest"
npx cap add android
npm run build
npx cap sync android

# iOS
cd ios-test
npm install
npx cap init "Daily Notification iOS Test" "com.timesafari.dailynotification.iostest"
npx cap add ios
npm run build
npx cap sync ios

# Electron
cd electron-test
npm install
npm run build-web

Test App Features

Each test app includes:

• Plugin Configuration: Test shared SQLite, TTL, prefetch settings
• Notification Scheduling: Basic daily notification setup
• Platform-Specific Features:
  • Android: Exact alarm permissions, reboot recovery
  • iOS: Rolling window management, BGTaskScheduler
  • Electron: Mock implementations, IPC communication
• Performance Monitoring: Metrics collection and display
• Error Handling: Comprehensive error testing
• Debug Information: Platform-specific debug data

Platform-Specific Testing

Android Test App

• Exact Alarm Status: Check permission and capability
• Permission Requests: Test exact alarm permission flow
• Performance Metrics: Monitor Android-specific optimizations
• Reboot Recovery: Validate system restart handling

iOS Test App

• Rolling Window: Test notification limit management
• Background Tasks: Validate BGTaskScheduler integration
• Performance Metrics: Monitor iOS-specific optimizations
• Memory Management: Test object pooling and cleanup

Electron Test App

• Mock Implementations: Test web platform compatibility
• IPC Communication: Validate Electron-specific APIs
• Development Workflow: Test plugin integration
• Debug Information: Platform-specific status display

Running the Test Apps

Android

cd android-test
npm run dev          # Web development server
npx cap open android # Open in Android Studio
npx cap run android  # Run on device/emulator

iOS

cd ios-test
npm run dev         # Web development server
npx cap open ios    # Open in Xcode
npx cap run ios     # Run on device/simulator

Electron

cd electron-test
npm start           # Run Electron app
npm run dev         # Run in development mode

Testing Checklist

Core Functionality

• Plugin configuration works
• Notification scheduling succeeds
• Error handling functions properly
• Performance metrics are accurate

Platform-Specific

• Android exact alarm permissions
• iOS rolling window management
• Electron mock implementations
• Cross-platform API consistency

Integration

• Plugin loads without errors
• Configuration persists across sessions
• Performance optimizations active
• Debug information accessible

Troubleshooting

Common Issues

1. Build Failures: Ensure all dependencies installed
2. Platform Errors: Check platform-specific SDKs installed
3. Permission Issues: Verify platform permissions configured
4. Sync Problems: Run npx cap sync after changes

Development Tips

• Use npm run dev for web testing
• Use platform-specific tools for native testing
• Check console logs for detailed error information
• Test on both physical devices and simulators

Next Steps

1. Run Setup Scripts: Execute platform-specific setup
2. Test Core Features: Validate basic functionality
3. Test Platform Features: Verify platform-specific capabilities
4. Integration Testing: Test with actual plugin implementation
5. Performance Validation: Monitor metrics and optimizations