Skip to main content

appsonair_flutter_applink 2.1.0 copy "appsonair_flutter_applink: ^2.1.0" to clipboard
appsonair_flutter_applink: ^2.1.0 copied to clipboard

The AppsOnAir AppLink Flutter SDK enables deep link tracking and engagement analytics for both iOS and Android. It serves as a powerful alternative to Firebase Dynamic Links.

example/lib/main.dart

import 'dart:developer';

import 'package:appsonair_flutter_applink/models/app_link_params.dart';
import 'package:flutter/material.dart';

import 'package:appsonair_flutter_applink/appsonair_flutter_applink.dart';
import 'package:flutter/services.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _linkDetails = '';
  String _attributionDetails = '';
  String _referralDetails = '';
  String _appLinkInfo = '';
  final _appsonairFlutterApplinkPlugin = AppsonairFlutterApplink();

  // URL Prefix options
  static const List<String> _urlPrefixOptions = [
    'tmdb.appsonair.link',
    'tmdb.tryandtaste.shop',
  ];
  String _selectedUrlPrefix = 'tmdb.appsonair.link';

  // Form Controllers
  final TextEditingController _urlController = TextEditingController(
    text: 'https://tmdb.tryandtaste.shop',
  );
  final TextEditingController _nameController = TextEditingController(
    text: 'TMDB QA',
  );
  final TextEditingController _urlPrefixController = TextEditingController(
    text: 'tmdb.appsonair.link',
  );
  final TextEditingController _shortIdController = TextEditingController();
  final TextEditingController _titleController = TextEditingController(
    text: 'TMDB Movie App',
  );
  final TextEditingController _descriptionController = TextEditingController(
    text: 'Explore movies and TV shows powered by TMDB',
  );
  final TextEditingController _imageUrlController = TextEditingController(
    text: 'https://tmdb.tryandtaste.shop/og-image.png',
  );
  final TextEditingController _androidFallbackController =
      TextEditingController(
        text:
            'https://play.google.com/store/apps/details?id=com.logicwind.tmdb',
      );
  final TextEditingController _iosFallbackController = TextEditingController(
    text: 'https://apps.apple.com/app/id/com.logicwind.tmdb',
  );

  // AppsFlyer Attribution Controllers
  final TextEditingController _appsFlyerChannelController =
      TextEditingController(text: 'appsonair');
  final TextEditingController _appsFlyerCampaignIdController =
      TextEditingController(text: '01');
  final TextEditingController _appsFlyerCampaignController =
      TextEditingController(text: 'test');
  final TextEditingController _appsFlyerSubsController =
      TextEditingController();
  final TextEditingController _appsFlyerMetaTitleController =
      TextEditingController();
  final TextEditingController _appsFlyerMetaDescriptionController =
      TextEditingController();
  final TextEditingController _attributionTtlController = TextEditingController(
    text: '3600',
  );

  // Toggle States
  bool _isOpenInAndroidApp = true;
  bool _isOpenInBrowserAndroid = false;
  bool _isOpenInIosApp = true;
  bool _isOpenInBrowserApple = false;

  @override
  void initState() {
    super.initState();
    _appsonairFlutterApplinkPlugin.initializeAppLink().listen((event) {
      setState(() {
        _linkDetails = event.toString();
      });
    });
    _appsonairFlutterApplinkPlugin.onReferralLinkDetected().listen((event) {
      setState(() {
        _referralDetails = event.toString();
      });
    });
    _appsonairFlutterApplinkPlugin.onAttributionListener().listen((event) {
      setState(() {
        _attributionDetails = event.toString();
      });
    });
  }

  @override
  void dispose() {
    _urlController.dispose();
    _nameController.dispose();
    _urlPrefixController.dispose();
    _shortIdController.dispose();
    _titleController.dispose();
    _descriptionController.dispose();
    _imageUrlController.dispose();
    _androidFallbackController.dispose();
    _iosFallbackController.dispose();
    _appsFlyerChannelController.dispose();
    _appsFlyerCampaignIdController.dispose();
    _appsFlyerCampaignController.dispose();
    _appsFlyerSubsController.dispose();
    _appsFlyerMetaTitleController.dispose();
    _appsFlyerMetaDescriptionController.dispose();
    _attributionTtlController.dispose();
    super.dispose();
  }

  Map<String, dynamic>? _buildAppsFlyerParams() {
    final channel = _appsFlyerChannelController.text.trim();
    final campaignId = _appsFlyerCampaignIdController.text.trim();
    final campaign = _appsFlyerCampaignController.text.trim();
    final subs = _appsFlyerSubsController.text
        .split(',')
        .map((sub) => sub.trim())
        .where((sub) => sub.isNotEmpty)
        .toList();
    final metaTitle = _appsFlyerMetaTitleController.text.trim();
    final metaDescription = _appsFlyerMetaDescriptionController.text.trim();

    final appsFlyer = <String, dynamic>{
      if (channel.isNotEmpty) 'channel': channel,
      if (campaignId.isNotEmpty) 'campaignId': campaignId,
      if (campaign.isNotEmpty) 'campaign': campaign,
      if (subs.isNotEmpty) 'subs': subs,
      if (metaTitle.isNotEmpty) 'metaTitle': metaTitle,
      if (metaDescription.isNotEmpty) 'metaDescription': metaDescription,
    };

    return appsFlyer.isEmpty ? null : appsFlyer;
  }

  Future<void> createLink() async {
    String link;
    String? shortId = _shortIdController.text.trim().isEmpty
        ? null
        : _shortIdController.text.trim();

    try {
      var data = await _appsonairFlutterApplinkPlugin.createAppLink(
        appLinkParams: AppLinkParams(
          url: _urlController.text.trim(),
          name: _nameController.text.trim(),
          urlPrefix: _urlPrefixController.text.trim(),
          shortId: shortId,
          socialMeta: SocialMeta(
            title: _titleController.text.trim(),
            description: _descriptionController.text.trim(),
            imageUrl: _imageUrlController.text.trim(),
          ),
          androidFallbackUrl: _androidFallbackController.text.trim(),
          iosFallbackUrl: _iosFallbackController.text.trim(),
          isOpenInAndroidApp: _isOpenInAndroidApp,
          isOpenInBrowserAndroid: _isOpenInBrowserAndroid,
          isOpenInIosApp: _isOpenInIosApp,
          isOpenInBrowserApple: _isOpenInBrowserApple,
          appsFlyer: _buildAppsFlyerParams(),
          attributionTtl: int.tryParse(_attributionTtlController.text.trim()),
        ),
      );
      link = data.toString();
    } on PlatformException {
      link = 'Failed to create link.';
    }

    if (!mounted) return;

    setState(() {
      _linkDetails = link;
    });
  }

  Future<void> getAttributionInfo() async {
    try {
      var data = await _appsonairFlutterApplinkPlugin.getAttributionInfo();
      setState(() {
        _attributionDetails = data.toString();
      });
    } on PlatformException catch (e) {
      log(e.toString());
      setState(() {
        _attributionDetails = 'Failed to get attribution info: ${e.message}';
      });
    }
  }

  Future<void> getAppLinkInfo() async {
    final shortId = _shortIdController.text.trim();
    final urlPrefix = _urlPrefixController.text.trim();
    if (shortId.isEmpty || urlPrefix.isEmpty) {
      setState(() {
        _appLinkInfo = 'Please enter Short ID and URL Prefix.';
      });
      return;
    }
    try {
      var data = await _appsonairFlutterApplinkPlugin.getAppLinkInfo(
        shortId: shortId,
        urlPrefix: urlPrefix,
      );
      setState(() {
        _appLinkInfo = data.toString();
      });
    } on PlatformException catch (e) {
      log(e.toString());
      setState(() {
        _appLinkInfo = 'Failed to get AppLink info: ${e.message}';
      });
    }
  }

  Widget _buildTextField({
    required TextEditingController controller,
    required String label,
    required String hint,
    bool isMultiline = false,
  }) {
    return Padding(
      padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8),
      child: TextField(
        controller: controller,
        maxLines: isMultiline ? 2 : 1,
        decoration: InputDecoration(
          labelText: label,
          hintText: hint,
          border: const OutlineInputBorder(),
          contentPadding: const EdgeInsets.symmetric(
            horizontal: 12,
            vertical: 10,
          ),
        ),
      ),
    );
  }

  Widget _buildToggle({
    required String label,
    required bool value,
    required Function(bool) onChanged,
  }) {
    return Padding(
      padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8),
      child: Row(
        mainAxisAlignment: MainAxisAlignment.spaceBetween,
        children: [
          Text(
            label,
            style: const TextStyle(fontSize: 14, fontWeight: FontWeight.w500),
          ),
          Switch(
            value: value,
            onChanged: (newValue) => onChanged(newValue),
            activeThumbColor: Colors.green,
            inactiveThumbColor: Colors.grey,
          ),
        ],
      ),
    );
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Flutter AppLink Example'),
          centerTitle: true,
        ),
        body: SingleChildScrollView(
          child: Column(
            children: [
              const SizedBox(height: 16),
              const Padding(
                padding: EdgeInsets.symmetric(horizontal: 12),
                child: Text(
                  'Basic Information',
                  style: TextStyle(fontSize: 16, fontWeight: FontWeight.bold),
                ),
              ),
              const SizedBox(height: 8),
              _buildTextField(
                controller: _urlController,
                label: 'URL',
                hint: 'https://example.com',
              ),
              _buildTextField(
                controller: _nameController,
                label: 'Name',
                hint: 'App Name',
              ),
              Padding(
                padding: const EdgeInsets.symmetric(
                  horizontal: 12,
                  vertical: 8,
                ),
                child: DropdownButtonFormField<String>(
                  initialValue: _selectedUrlPrefix,
                  decoration: const InputDecoration(
                    labelText: 'URL Prefix',
                    border: OutlineInputBorder(),
                    contentPadding: EdgeInsets.symmetric(
                      horizontal: 12,
                      vertical: 10,
                    ),
                  ),
                  items: _urlPrefixOptions
                      .map(
                        (prefix) => DropdownMenuItem(
                          value: prefix,
                          child: Text(prefix),
                        ),
                      )
                      .toList(),
                  onChanged: (value) {
                    if (value != null) {
                      setState(() {
                        _selectedUrlPrefix = value;
                        _urlPrefixController.text = value;
                      });
                    }
                  },
                ),
              ),
              _buildTextField(
                controller: _shortIdController,
                label: 'Short ID',
                hint: 'Leave empty for auto-generation',
              ),
              const SizedBox(height: 20),
              const Padding(
                padding: EdgeInsets.symmetric(horizontal: 12),
                child: Text(
                  'Social Media',
                  style: TextStyle(fontSize: 16, fontWeight: FontWeight.bold),
                ),
              ),
              const SizedBox(height: 8),
              _buildTextField(
                controller: _titleController,
                label: 'Social Title',
                hint: 'Title for social sharing',
              ),
              _buildTextField(
                controller: _descriptionController,
                label: 'Social Description',
                hint: 'Description for social sharing',
                isMultiline: true,
              ),
              _buildTextField(
                controller: _imageUrlController,
                label: 'Image URL',
                hint: 'https://example.com/image.png',
              ),
              const SizedBox(height: 20),
              const Padding(
                padding: EdgeInsets.symmetric(horizontal: 12),
                child: Text(
                  'Fallback URLs',
                  style: TextStyle(fontSize: 16, fontWeight: FontWeight.bold),
                ),
              ),
              const SizedBox(height: 8),
              _buildTextField(
                controller: _androidFallbackController,
                label: 'Android Fallback URL',
                hint: 'https://play.google.com/store/apps/...',
              ),
              _buildTextField(
                controller: _iosFallbackController,
                label: 'iOS Fallback URL',
                hint: 'https://apps.apple.com/app/...',
              ),
              const SizedBox(height: 20),
              const Padding(
                padding: EdgeInsets.symmetric(horizontal: 12),
                child: Text(
                  'AppsFlyer Attribution',
                  style: TextStyle(fontSize: 16, fontWeight: FontWeight.bold),
                ),
              ),
              const SizedBox(height: 8),
              _buildTextField(
                controller: _appsFlyerChannelController,
                label: 'Channel',
                hint: 'e.g. appsonair',
              ),
              _buildTextField(
                controller: _appsFlyerCampaignIdController,
                label: 'Campaign ID',
                hint: 'Unique campaign identifier',
              ),
              _buildTextField(
                controller: _appsFlyerCampaignController,
                label: 'Campaign',
                hint: 'Human-readable campaign name',
              ),
              _buildTextField(
                controller: _appsFlyerSubsController,
                label: 'Subs',
                hint: 'Comma-separated, e.g. sub1, sub2, sub3',
              ),
              _buildTextField(
                controller: _appsFlyerMetaTitleController,
                label: 'Meta Title',
                hint: 'Title used for attribution metadata',
              ),
              _buildTextField(
                controller: _appsFlyerMetaDescriptionController,
                label: 'Meta Description',
                hint: 'Description used for attribution metadata',
                isMultiline: true,
              ),
              _buildTextField(
                controller: _attributionTtlController,
                label: 'Attribution TTL (seconds)',
                hint: 'Minimum 3600 (1 hour)',
              ),
              const SizedBox(height: 20),
              const Padding(
                padding: EdgeInsets.symmetric(horizontal: 12),
                child: Text(
                  'Open Behavior',
                  style: TextStyle(fontSize: 16, fontWeight: FontWeight.bold),
                ),
              ),
              const SizedBox(height: 8),
              _buildToggle(
                label: 'Open in Android App',
                value: _isOpenInAndroidApp,
                onChanged: (value) =>
                    setState(() => _isOpenInAndroidApp = value),
              ),
              _buildToggle(
                label: 'Open in Browser (Android)',
                value: _isOpenInBrowserAndroid,
                onChanged: (value) =>
                    setState(() => _isOpenInBrowserAndroid = value),
              ),
              _buildToggle(
                label: 'Open in iOS App',
                value: _isOpenInIosApp,
                onChanged: (value) => setState(() => _isOpenInIosApp = value),
              ),
              _buildToggle(
                label: 'Open in Browser (Apple)',
                value: _isOpenInBrowserApple,
                onChanged: (value) =>
                    setState(() => _isOpenInBrowserApple = value),
              ),
              const SizedBox(height: 24),
              Padding(
                padding: const EdgeInsets.symmetric(horizontal: 12),
                child: Wrap(
                  alignment: WrapAlignment.center,
                  spacing: 12,
                  runSpacing: 12,
                  children: [
                    ElevatedButton.icon(
                      onPressed: createLink,
                      icon: const Icon(Icons.link),
                      label: const Text('Create Link'),
                      style: ElevatedButton.styleFrom(
                        backgroundColor: Colors.green,
                        foregroundColor: Colors.white,
                        padding: const EdgeInsets.symmetric(
                          horizontal: 20,
                          vertical: 12,
                        ),
                      ),
                    ),
                    ElevatedButton.icon(
                      onPressed: getAttributionInfo,
                      icon: const Icon(Icons.insights),
                      label: const Text('Get Attribution'),
                      style: ElevatedButton.styleFrom(
                        backgroundColor: Colors.deepPurple,
                        foregroundColor: Colors.white,
                        padding: const EdgeInsets.symmetric(
                          horizontal: 20,
                          vertical: 12,
                        ),
                      ),
                    ),
                    ElevatedButton.icon(
                      onPressed: getAppLinkInfo,
                      icon: const Icon(Icons.info_outline),
                      label: const Text('Get AppLink Info'),
                      style: ElevatedButton.styleFrom(
                        backgroundColor: Colors.teal,
                        foregroundColor: Colors.white,
                        padding: const EdgeInsets.symmetric(
                          horizontal: 20,
                          vertical: 12,
                        ),
                      ),
                    ),
                  ],
                ),
              ),
              const SizedBox(height: 24),
              if (_linkDetails.isNotEmpty ||
                  _attributionDetails.isNotEmpty ||
                  _referralDetails.isNotEmpty ||
                  _appLinkInfo.isNotEmpty) ...[
                const Divider(),
                const Padding(
                  padding: EdgeInsets.symmetric(horizontal: 12, vertical: 8),
                  child: Text(
                    'Result',
                    style: TextStyle(fontSize: 16, fontWeight: FontWeight.bold),
                  ),
                ),
                const SelectableText("Link Info (initializeAppLink)"),
                Container(
                  margin: const EdgeInsets.all(12),
                  padding: const EdgeInsets.all(12),
                  decoration: BoxDecoration(
                    border: Border.all(color: Colors.grey),
                    borderRadius: BorderRadius.circular(8),
                    color: Colors.grey[100],
                  ),
                  child: SelectableText(
                    _linkDetails,
                    textAlign: TextAlign.center,
                    style: const TextStyle(fontSize: 12),
                  ),
                ),
                const SelectableText(
                  "Referral Details (onReferralLinkDetected)",
                ),
                Container(
                  margin: const EdgeInsets.all(12),
                  padding: const EdgeInsets.all(12),
                  decoration: BoxDecoration(
                    border: Border.all(color: Colors.grey),
                    borderRadius: BorderRadius.circular(8),
                    color: Colors.grey[100],
                  ),
                  child: SelectableText(
                    _referralDetails,
                    textAlign: TextAlign.center,
                    style: const TextStyle(fontSize: 12),
                  ),
                ),
                const SelectableText(
                  "Attribution Info (onAttributionListener)",
                ),
                Container(
                  margin: const EdgeInsets.all(12),
                  padding: const EdgeInsets.all(12),
                  decoration: BoxDecoration(
                    border: Border.all(color: Colors.grey),
                    borderRadius: BorderRadius.circular(8),
                    color: Colors.grey[100],
                  ),
                  child: SelectableText(
                    _attributionDetails,
                    textAlign: TextAlign.center,
                    style: const TextStyle(fontSize: 12),
                  ),
                ),
                if (_appLinkInfo.isNotEmpty) ...[
                  const SelectableText("AppLink Info (getAppLinkInfo)"),
                  Container(
                    margin: const EdgeInsets.all(12),
                    padding: const EdgeInsets.all(12),
                    decoration: BoxDecoration(
                      border: Border.all(color: Colors.grey),
                      borderRadius: BorderRadius.circular(8),
                      color: Colors.grey[100],
                    ),
                    child: SelectableText(
                      _appLinkInfo,
                      textAlign: TextAlign.center,
                      style: const TextStyle(fontSize: 12),
                    ),
                  ),
                ],
              ],
              const SizedBox(height: 20),
            ],
          ),
        ),
      ),
    );
  }
}
1
likes
160
points
177
downloads

Documentation

API reference

Publisher

verified publisherappsonair.com

Weekly Downloads

The AppsOnAir AppLink Flutter SDK enables deep link tracking and engagement analytics for both iOS and Android. It serves as a powerful alternative to Firebase Dynamic Links.

Homepage
Repository (GitHub)
View/report issues

License

MIT (license)

Dependencies

flutter, plugin_platform_interface

More

Packages that depend on appsonair_flutter_applink

Packages that implement appsonair_flutter_applink