appvue_plugin 0.0.1

Flutter plugin for AppVue SDK integration, supporting install tracking, event reporting, and deep linking.

AppVue Flutter Plugin

A Flutter plugin for AppVue SDK integration, supporting install tracking, event reporting, and deep linking.

Features

• ✅ SDK Initialization
• ✅ Install Tracking & Attribution
• ✅ Event Reporting
• ✅ Deep Link (Universal Links & URL Schemes)
• ✅ Wakeup Data Stream

Platform Support

Platform	Support
Android	✅ SDK 24+
iOS	✅ iOS 13+

Installation

Add appvue_plugin to your pubspec.yaml:

dependencies:
  appvue_plugin: ^0.0.1

Then run:

flutter pub get

Platform Configuration

Android

1. Download AAR file from AppVue Console

2. Add AAR to your project:

   your_flutter_app/
   └── android/
       └── app/
           └── libs/
               └── appvue-v1.0.0-release.aar
   

3. Configure build.gradle (android/app/build.gradle):

   dependencies {
       implementation(fileTree(dir: 'libs', include: ['*.aar']))
   }
   

4. Configure AppKey (android/app/build.gradle):

   android {
       defaultConfig {
           manifestPlaceholders = [APPVUE_APPKEY: "YOUR_APP_KEY"]
       }
   }
   

iOS

1. AppVueSDK is automatically installed via CocoaPods

2. Configure AppKey (ios/Runner/Info.plist):

   <key>com.appvue.appkey</key>
   <string>YOUR_APP_KEY</string>
   

3. Configure Universal Links (Optional):

   Create ios/Runner/Runner.entitlements:

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
       <key>com.apple.developer.associated-domains</key>
       <array>
           <string>applinks:your-domain.appvue.net</string>
       </array>
   </dict>
   </plist>
   

Usage

Import

import 'package:appvue_plugin/appvue_plugin.dart';

Initialize SDK

await AppvuePlugin.initializeSDK();

Report Event

await AppvuePlugin.reportEvent("event_code", 1);

Get Install Data

final installData = await AppvuePlugin.getInstallData();
print('Channel: ${installData.channel}');
print('Referrer: ${installData.referrer}');

Handle Deep Link Wakeup

// Check if app was opened via deep link
bool hasWakeupData = await AppvuePlugin.hasWakeupData();
if (hasWakeupData) {
  final wakeupData = await AppvuePlugin.getWakeupData();
  print('Wakeup Channel: ${wakeupData.channel}');
}

// Listen for wakeup events (when app is already running)
AppvuePlugin.wakeupDataStream.listen((data) {
  print('Received wakeup: ${data.channel}');
});

API Reference

Method	Description
initializeSDK()	Initialize AppVue SDK
reportEvent(code, value)	Report custom event
getInstallData()	Get install attribution data
hasWakeupData()	Check if deep link wakeup data exists
getWakeupData()	Get deep link wakeup data
wakeupDataStream	Stream of deep link wakeup events

Error Handling

try {
  await AppvuePlugin.initializeSDK();
} on AppVueSDKNotFoundException catch (e) {
  print('SDK not found: ${e.message}');
} on AppVueSDKInvalidException catch (e) {
  print('SDK invalid: ${e.message}');
} on AppVueInitializationException catch (e) {
  print('Init failed: ${e.message}');
}

Requirements

• Flutter >= 3.3.0
• Dart >= 3.0.0
• Android SDK >= 24
• iOS >= 13.0

Links

• AppVue Website
• Documentation
• Console

License

MIT License. See LICENSE file.