appsonair_flutter_applink 2.1.0
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.
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),
],
),
),
),
);
}
}