test: [SDK-4347] add Appium E2E test support to Flutter demo app

.github/workflows/e2e.yml

@@ -0,0 +1,124 @@
+name: E2E Tests
+
+on:
+  push:
+    branches:
+      - rel/**
+  workflow_dispatch:
+    inputs:
+      platform:
+        description: 'Platform to test'
+        required: true
+        default: 'android'
+        type: choice
+        options:
+          - android
+          - ios
+          - both
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build-android:
+    if: >-
+      github.event_name == 'push' ||
+      github.event.inputs.platform == 'android' ||
+      github.event.inputs.platform == 'both'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Set up Flutter
+        uses: ./.github/actions/setup-flutter
+
+      - name: Set up Java
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '17'
+
+      - name: Create demo .env
+        working-directory: examples/demo
+        run: |
+          echo "ONESIGNAL_APP_ID=${{ vars.APPIUM_ONESIGNAL_APP_ID }}" > .env
+          echo "ONESIGNAL_API_KEY=${{ secrets.APPIUM_ONESIGNAL_API_KEY }}" >> .env
+          echo "E2E_MODE=true" >> .env
+
+      - name: Build release APK
+        working-directory: examples/demo
+        run: flutter build apk --release
+
+      - name: Upload APK
+        uses: actions/upload-artifact@v4
+        with:
+          name: demo-apk
+          path: examples/demo/build/app/outputs/flutter-apk/app-release.apk
+          retention-days: 1
+
+  build-ios:
+    if: >-
+      github.event_name == 'push' ||
+      github.event.inputs.platform == 'ios' ||
+      github.event.inputs.platform == 'both'
+    runs-on: macos-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Set up Flutter
+        uses: ./.github/actions/setup-flutter
+
+      - name: Create demo .env
+        working-directory: examples/demo
+        run: |
+          echo "ONESIGNAL_APP_ID=${{ vars.APPIUM_ONESIGNAL_APP_ID }}" > .env
+          echo "ONESIGNAL_API_KEY=${{ secrets.APPIUM_ONESIGNAL_API_KEY }}" >> .env
+          echo "E2E_MODE=true" >> .env
+
+      - name: Install CocoaPods dependencies
+        working-directory: examples/demo/ios
+        run: pod install
+
+      - name: Build iOS app
+        working-directory: examples/demo
+        run: |
+          flutter build ios --release --no-codesign
+          cd build/ios/iphoneos
+          mkdir Payload
+          cp -r Runner.app Payload/
+          zip -r Runner.ipa Payload
+
+      - name: Upload IPA
+        uses: actions/upload-artifact@v4
+        with:
+          name: demo-ipa
+          path: examples/demo/build/ios/iphoneos/Runner.ipa
+          retention-days: 1
+
+  e2e-android:
+    needs: build-android
+    uses: OneSignal/sdk-shared/.github/workflows/appium-e2e.yml@main
+    secrets: inherit
+    with:
+      platform: android
+      app-artifact: demo-apk
+      app-filename: app-release.apk
+      sdk-type: flutter
+      build-name: flutter-android-${{ github.ref_name }}-${{ github.run_number }}
+
+  e2e-ios:
+    needs: build-ios
+    uses: OneSignal/sdk-shared/.github/workflows/appium-e2e.yml@main
+    secrets: inherit
+    with:
+      platform: ios
+      app-artifact: demo-ipa
+      app-filename: Runner.ipa
+      sdk-type: flutter
+      build-name: flutter-ios-${{ github.ref_name }}-${{ github.run_number }}

examples/build.md

@@ -119,9 +119,9 @@ OneSignal.User.addObserver(...)
 - Use `await Future.delayed(const Duration(milliseconds: 100))` after setting state for render delay
 
 ### SnackBar Messages
-- `AppViewModel` exposes a `snackBarMessage` stream or `ValueNotifier<String?>`
-- `HomeScreen` shows via `ScaffoldMessenger.of(context).showSnackBar()`
-- Clear previous SnackBar with `ScaffoldMessenger.of(context).clearSnackBars()`
+- `AppSnackBar` extension on `BuildContext` defined in `theme.dart`
+- Call `context.showSnackBar(message)` directly from widget callbacks
+- Automatically hides the current SnackBar before showing the new one
 
 ### Send In-App Message Icons
 - TOP BANNER: `Icons.vertical_align_top`
@@ -135,17 +135,6 @@ OneSignal.User.addObserver(...)
 - `TextEditingController`s are properly disposed in `StatefulWidget`s
 - JSON parsing via `jsonDecode` returns `Map<String, dynamic>` for Track Event
 
-### Accessibility (Appium)
-- Use `Semantics` widget with `label` property:
-  ```dart
-  Semantics(label: 'log_entry_${index}_message', child: Text(entry.message))
-  ```
-
-### Log Manager
-- Singleton with `ChangeNotifier` for reactive UI updates
-- `LogManager().d(tag, message)`, `.i()`, `.w()`, `.e()`
-- Also prints via `debugPrint` for development
-
 ---
 
 ## File Structure
@@ -162,8 +151,7 @@ examples/demo/
 │   ├── services/
 │   │   ├── onesignal_api_service.dart
 │   │   ├── preferences_service.dart
-│   │   ├── tooltip_helper.dart
-│   │   └── log_manager.dart
+│   │   └── tooltip_helper.dart
 │   ├── repositories/
 │   │   └── onesignal_repository.dart
 │   ├── viewmodels/
@@ -175,9 +163,9 @@ examples/demo/
 │       ├── section_card.dart
 │       ├── toggle_row.dart
 │       ├── action_button.dart
+│       ├── app_text_field.dart
 │       ├── list_widgets.dart
 │       ├── loading_overlay.dart
-│       ├── log_view.dart
 │       ├── dialogs.dart
 │       └── sections/
 │           ├── app_section.dart
@@ -192,7 +180,8 @@ examples/demo/
 │           ├── tags_section.dart
 │           ├── outcomes_section.dart
 │           ├── triggers_section.dart
-│           ├── track_event_section.dart
+│           ├── custom_events_section.dart
+│           ├── live_activities_section.dart
 │           └── location_section.dart
 ├── android/
 ├── ios/

examples/demo/.env.example

@@ -1 +1,2 @@
-ONESIGNAL_API_KEY=your_rest_api_key
+ONESIGNAL_APP_ID=your-onesignal-app-id # default app id: 77e32082-ea27-42e3-a898-c72e141824ef if empty
+ONESIGNAL_API_KEY=your-onesignal-api-key

examples/demo/README.md

@@ -46,7 +46,20 @@ flutter run -d <device_id>
 
 ## Configuration
 
-The app uses a default OneSignal App ID for testing. To use your own, update the `oneSignalAppId` constant in `lib/main.dart`.
+Copy the example environment file and fill in your values:
+
+```bash
+cp .env.example .env
+```
+
+Set your OneSignal credentials in `.env`:
+
+```
+ONESIGNAL_APP_ID=your-onesignal-app-id
+ONESIGNAL_API_KEY=your-onesignal-api-key
+```
+
+If no `.env` is provided, the app falls back to a built-in default App ID.
 
 ## Build Guide
 

examples/demo/lib/main.dart

@@ -6,30 +6,28 @@ import 'package:provider/provider.dart';
 
 import 'repositories/onesignal_repository.dart';
 import 'screens/home_screen.dart';
-import 'services/log_manager.dart';
 import 'services/onesignal_api_service.dart';
 import 'services/preferences_service.dart';
 import 'services/tooltip_helper.dart';
 import 'theme.dart';
 import 'viewmodels/app_viewmodel.dart';
 
-const String oneSignalAppId = '77e32082-ea27-42e3-a898-c72e141824ef';
+const String _defaultAppId = '77e32082-ea27-42e3-a898-c72e141824ef';
 
 Future<void> main() async {
   WidgetsFlutterBinding.ensureInitialized();
 
-  // Load environment variables
   try {
     await dotenv.load(fileName: '.env');
   } catch (_) {
-    LogManager().w('App', '.env file not found, continuing without API key');
+    debugPrint('.env file not found, using defaults');
   }
 
-  // Initialize preferences
   final prefs = PreferencesService();
   await prefs.init();
 
-  final appId = prefs.appId ?? oneSignalAppId;
+  final envAppId = dotenv.env['ONESIGNAL_APP_ID'];
+  final appId = (envAppId != null && envAppId.isNotEmpty) ? envAppId : _defaultAppId;
 
   // Initialize OneSignal SDK
   OneSignal.Debug.setLogLevel(OSLogLevel.verbose);
@@ -50,29 +48,28 @@ Future<void> main() async {
 
   // Register IAM listeners
   OneSignal.InAppMessages.addWillDisplayListener((event) {
-    LogManager().i('IAM', 'Will display: ${event.message.messageId}');
+    debugPrint('IAM will display: ${event.message.messageId}');
   });
   OneSignal.InAppMessages.addDidDisplayListener((event) {
-    LogManager().i('IAM', 'Did display: ${event.message.messageId}');
+    debugPrint('IAM did display: ${event.message.messageId}');
   });
   OneSignal.InAppMessages.addWillDismissListener((event) {
-    LogManager().i('IAM', 'Will dismiss: ${event.message.messageId}');
+    debugPrint('IAM will dismiss: ${event.message.messageId}');
   });
   OneSignal.InAppMessages.addDidDismissListener((event) {
-    LogManager().i('IAM', 'Did dismiss: ${event.message.messageId}');
+    debugPrint('IAM did dismiss: ${event.message.messageId}');
   });
   OneSignal.InAppMessages.addClickListener((event) {
-    LogManager().i('IAM', 'Clicked: ${event.result.actionId}');
+    debugPrint('IAM clicked: ${event.result.actionId}');
   });
 
   // Register notification listeners
   OneSignal.Notifications.addClickListener((event) {
-    LogManager().i('Notification', 'Clicked: ${event.notification.title}');
+    debugPrint('Notification clicked: ${event.notification.title}');
   });
   OneSignal.Notifications.addForegroundWillDisplayListener((event) {
-    LogManager().i(
-      'Notification',
-      'Foreground will display: ${event.notification.title}',
+    debugPrint(
+      'Notification foreground will display: ${event.notification.title}',
     );
     event.notification.display();
   });
@@ -82,7 +79,7 @@ Future<void> main() async {
   try {
     apiKey = dotenv.env['ONESIGNAL_API_KEY'] ?? '';
   } catch (_) {
-    LogManager().w('App', 'API key not found, continuing without it');
+    debugPrint('API key not found, continuing without it');
   }
   final apiService = OneSignalApiService()
     ..setAppId(appId)
@@ -92,7 +89,7 @@ Future<void> main() async {
   // Fetch tooltips in background
   TooltipHelper().init();
 
-  LogManager().i('App', 'OneSignal initialized with app ID: $appId');
+  debugPrint('OneSignal initialized with app ID: $appId');
 
   runApp(
     ChangeNotifierProvider(