Flutter SDK

﻿
Custom HTML
(Script tags will be stripped)
​x
 
​
<head>
  <link rel="alternate" hreflang="en" href="https://developers.airbridge.io/v1.1-en/docs/flutter-sdk" />
  <link rel="alternate" hreflang="ko" href="https://developers.airbridge.io/docs/flutter-sdk" />
</head>
## SDK Installation
﻿
xxxxxxxxxx
 
<hr/>
﻿[![Pub Version](https://img.shields.io/pub/v/airbridge_flutter_sdk?label=version&style=flat-square)](🔗﻿)﻿
### Package Installation
#### `pubspec` Setup
Please add the following dependency under the `dependencies` block in your `pubspec.yaml` file
﻿
xxxxxxxxxx
 
dependencies:
  airbridge_flutter_sdk: 3.3.0
Open `Terminal` at the topmost level of the project and execute the following command.
﻿
xxxxxxxxxx
 
flutter pub get
The Airbridge Flutter SDK supports `>= Flutter 1.20.0` and `>= Dart 2.12.0`
﻿
### Project Setup
#### `airbridge.json`
Please add the following under the `flutter/assets` block in your `pubspec.yaml` file.
﻿
xxxxxxxxxx
 
flutter:
  assets:
    - assets/airbridge.json
Create an `assets/airbridge.json` file at the topmost level of the project.
Configure settings in JSON format.
﻿
xxxxxxxxxx
 
{
    "sessionTimeoutSeconds": 300,
    "autoStartTrackingEnabled": true,
    "userInfoHashEnabled": true,
    "trackAirbridgeLinkOnly": false,
    "facebookDeferredAppLinkEnabled": false,
    "locationCollectionEnabled": false,
    "trackingAuthorizeTimeoutSeconds": 0,
    "sdkSignatureSecretID": "YOUR_SDK_SIGNATURE_SECRET_ID",
    "sdkSignatureSecret": "YOUR_SDK_SIGNATURE_SECRET"
}
#### iOS Setup
Add the following code to the `ios/[Project Name]/AppDelegate.m` file.
﻿
xxxxxxxxxx
 
import airbridge_flutter_sdk
​
override func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    AirbridgeFlutter.initSDK(appName: "YOUR_APP_NAME", appToken: "YOUR_APP_TOKEN", withLaunchOptions: launchOptions)
}
`APP_NAME` can be found on the dashboard at **`Settings → Tokens → App Name`**.
`APP_TOKEN` can be found on the dashboard at **`Settings → Tokens → App SDK Token`**.
﻿
#### Android Setup
Add the following code to the `onCreate` function within the `android/app/src/main/java/.../MainApplication.java` file.
﻿
xxxxxxxxxx
 
import co.ab180.airbridge.flutter.AirbridgeFlutter;
import io.flutter.app.FlutterApplication;
​
public class MainApplication extends FlutterApplication {
    @Override
    public void onCreate() {
        super.onCreate();
        AirbridgeFlutter.init(this, "YOUR_APP_NAME", "YOUR_APP_TOKEN");
    }
}
`APP_NAME` can be found on the dashboard at **`Settings → Tokens → App Name`**.
`APP_TOKEN` can be found on the dashboard at **`Settings → Tokens → App SDK Token`**.
﻿
Register the `MainApplication` class created above in the `AndroidManifest.xml` file.
﻿
xxxxxxxxxx
 
<application
  android:name=".MainApplication"
  ...>
    ...
</application>
﻿
### Common Settings
#### airbridge.json
Add an `airbridge.json` file to the project folder.
Configure settings in JSON format.
﻿
xxxxxxxxxx
 
{
    "sessionTimeoutSeconds": 300,
    "autoStartTrackingEnabled": true,
    "userInfoHashEnabled": true,
    "trackAirbridgeLinkOnly": false,
    "facebookDeferredAppLinkEnabled": false,
    "locationCollectionEnabled": false,
    "trackingAuthorizeTimeoutSeconds": 0,
    "sdkSignatureSecretID": "YOUR_SDK_SIGNATURE_SECRET_ID",
    "sdkSignatureSecret": "YOUR_SDK_SIGNATURE_SECRET",
    "logLevel": "warning"
}
﻿
`trackingAuthorizeTimeoutSeconds` in the above code is the default value (0). Please adjust accordingly depending on your user experience and ATT prompt settings. Refer to ]Tracking Authorize Timeout Settings for more details.
NameTypeDefaultDescription
sessionTimeoutSecondsNumber300An app open event will not be sent when the app is reopened within the designated period.
autoStartTrackingEnabledBooleantrueWhen set to false, no events will be sent until `Airbridge.state.startTracking()` is called.
userInfoHashEnabledBooleantrueWhen set to false, user email and user phone information are sent without being hashed.
trackAirbridgeLinkOnlyBooleanfalseWhen set to true, deep link events are sent only when app is opened with an Airbridge deep link.
facebookDeferredAppLinkEnabledBooleanfalseWhen set to true and the Facebook SDK is installed, Facebook Deferred App Link data is collected.
locationCollectionEnabledBooleanfalseWhen set to true, location information is collected. (Android Only)

Two permissions must be allowed in AndroidManifest.xml
android.permission.ACCESS_FINE_LOCATION
android.permission.ACCESS_COARSE_LOCATION
trackingAuthorizeTimeoutSecondsNumber0When timeout is set, Install event is delayed until `Request tracking authorization alert` is clicked. (iOS only)
sdkSignatureSecretIDStringnullProtects against SDK spoofing. Both sdkSignatureSecretID and sdkSignatureSecret values must be applied.
sdkSignatureSecretStringnullProtects against SDK spoofing. Both sdkSignatureSecretID and sdkSignatureSecret values must be applied.
logLevelStringwarningAdjusts the log record level for Airbridge.
logLevel: "debug" | "info" | "warning" | "error" | "fault"
### Testing the SDK
Check if install events are sent when the application is installed and opened.
#### Check in the Airbridge Dashboard
Events from the Airbridge SDK are shown at the "Airbridge Dashboard → Raw Data → App Real-time Logs".
Go to `Airbridge Dashboard → Raw Data → App Real-time Logs`.
Search for the device's ADID (IDFA, IDFV, GAID).
﻿
﻿
Logs may be delayed for up to 5 minutes.
<br><br>
## Deep Link Setup
﻿
xxxxxxxxxx
 
<hr/>
### Dashboard Setup
Please refer to the guides below to setup your deep links in the Airbridge dashboard.
iOS Deep Link Dashboard Setup [Guide](🔗﻿)﻿
Android Deep Link Dashboard Setup [Guide](🔗﻿)﻿
﻿
### Project Setup
#### iOS Deep Link Setup
URL Scheme Setup
Go to "Xcode → Project file → Info → URL Types".
From the Airbridge dashboard, copy "iOS URI Scheme" to Xcode's "URL Schemes". (Do not include `://`)
﻿
Universal Link Setup
Go to "Xcode → Project file → Signing & Capabilities".
Click "+ Capability" and add "Associated Domains".
Add `applinks:YOUR_APP_NAME.airbridge.io` to "Associated Domains".
Add `applinks:YOUR_APP_NAME.deeplink.page` to "Associated Domains".
﻿
`YOUR_APP_NAME` can be found at the "Airbridge dashboard → Settings → Tokens → App Name".
Please refer to [Troubleshooting → Webcredentials](🔗﻿) if you want to use the autofill feature.
AppDelegate Setup
Open `ios/[Project name]/AppDelegate`.
Add the following methods. (`handleUniversalLink`, `handleURLSchemeDeeplink`)
﻿
xxxxxxxxxx
 
override func application(
    _ application: UIApplication,
    continue userActivity: NSUserActivity,
    restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void
) -> Bool {
    if let universalLink = userActivity.webpageURL {
        AirbridgeFlutter.deeplink.handleUniversalLink(universalLink)
    }
    
    return true
}
​
override func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    AirbridgeFlutter.deeplink.handleURLSchemeDeeplink(url)
    
    return true
}
#### Android Deep Link Setup
AndroidManifest.xml Setup
Open AndroidManifest.xml
Add the following intent-filter to the activity that will process the deep link.
﻿
xxxxxxxxxx
</activity>
 
<activity ...>
    ...
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
​
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
​
        <data android:scheme="http" android:host="YOUR_APP_NAME.deeplink.page" />
        <data android:scheme="https" android:host="YOUR_APP_NAME.deeplink.page" />
    </intent-filter>
    <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
​
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
​
        <data android:scheme="http" android:host="YOUR_APP_NAME.airbridge.io" />
        <data android:scheme="https" android:host="YOUR_APP_NAME.airbridge.io" />
    </intent-filter>
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
​
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
Enter your app name at `YOUR_APP_NAME`.
Enter your scheme value set in the Airbridge dashboard at `YOUR_APP_URI_SCHEME`. (e.g. `abc://`)
MainActivity Setup
Insert the following code to the `android/app/src/main/java/.../MainActivity.java` file.
﻿
xxxxxxxxxx
 
@Override
protected void onResume() {
    super.onResume();
    AirbridgeFlutter.processDeeplink(intent);
}
​
@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    setIntent(intent);
}
#### Callback Setup
Register a function that will be called whenever a "deep link" or a "deferred deep link" opens the application.
﻿
xxxxxxxxxx
 
Airbridge.deeplink.setDeeplinkListener((deeplink) {
    // airbridge deeplink = SCHEME://...
    print('$deeplink');
});
If `setDeeplinkListener` is called from the `main` function, make sure that `WidgetsFlutterBinding.ensureInitialized();` is called first.
#### Custom Domain (Optional)
Please refer to the below guides to setup your custom domain with Airbridge.
﻿[iOS deep link dashboard setup](🔗﻿)﻿
﻿[Android deep link dashboard setup](🔗﻿)﻿
﻿
### Test Deep Link
Click on your URI scheme to test if your deep link has been properly set up in the Airbridge SDK.
`YOUR_APP_URI_SCHEME://`
The results will show on the "Airbridge dashboard → Row Data → App Real-time Log" tab if everything is working.
﻿
<br><br>
## User Setup
﻿
xxxxxxxxxx
 
<hr/>
### User Identifier Setup
### User Identifier Setup
To measure the fragmented contributions of users between web and app, Airbridge collects the following user identifier information.
User Email: Email address
User Phone: Phone number
User ID: Unique User ID (The ID value that specifies the user must be the same in both web and mobile)
User Alias: Identifiers that can represent users (e.g. loyalty program ID, affiliate integrated ID, etc)
﻿
The user's email and phone numbers are hashed (SHA256) by default and then sent to servers.
You can set the user identifier as below for the Airbridge Flutter SDK.
﻿
xxxxxxxxxx
 
Airbridge.state.setUser(
  User(
    id: 'personID',
    email: 'persondoe@airbridge.io',
    phone: '1(123)123-1234',
    alias: {
      'alias_key': 'alias_value',
    },
  )
);
NameDescriptionLimitations
idUser ID-
emailUser emailHashed by default
(SHA256, can be disabled)
phoneUser phone numberHashed by default
(SHA256, can be disabled)
aliasUser alias- Maximum 10 aliases
- `"key"` type is String, maximum 128 characters
- `"key"` must satisfy `^[a-z_][a-z0-9_]*$` regex
- \`"value" type is String, maximum 1024 characters
Once the user identifier has been configured, all events will be forwarded with the corresponding identity information.
﻿
The user identifier properties can be reset or overwritten through user events.
﻿
Below is an example of how a particular field can be updated.
﻿
xxxxxxxxxx
 
Airbridge.state.updateUser(
    User(
        id: 'sam1234',
    )
);
﻿
### User Attribute Setup
Additional user attributes can be used for more accurate Multi-Touch Attribution (MTA) analyses, additional internal data analyses, and linking third-party solutions.
﻿
xxxxxxxxxx
 
Airbridge.state.setUser(
  User(
    attributes: {
      'attr_key': 'attr_value',
    },
  )
);
NameDescriptionLimitations
attributesUser attribute- Maximum 100 attributes
- "key" type is string, maximum 128 characters
- "key" must satisfy `^[a-z_][a-z0-9_]*$` regex
- "value" type is primitive or string
- Maximum 1024 characters when "value" is string
﻿
The user attribute information can be reset or overwritten through user events.
﻿
### Testing
Make sure that your user information settings are being properly sent through the SDK.
Configure user identifier information.
Send an event using the SDK.
Click the event at "Airbridge dashboard → Raw Data → App Real-time Logs"
Check if the user information is correctly sent under the `user` block.
﻿
<br><br>
## Device Setup
﻿
xxxxxxxxxx
 
<hr/>
### Setup Device Alias
Setup a device alias through the Airbridge SDK. The alias will be sustained even after the app closes, unless otherwise deleted.
﻿
xxxxxxxxxx
 
Airbridge.setDeviceAlias("ADD_YOUR_KEY", "AND_YOUR_VALUE");
Airbridge.removeDeviceAlias("DELETE_THIS_KEY");
Airbridge.clearDeviceAlias();
﻿
﻿
`setDeviceAlias(key: string, value: string)`Add the key value pair to the device identifier.
`removeDeviceAlias(key: string)`Delete the corresponding device alias.
`clearDeviceAlias()`Delete all device aliases.
<br><br>
## Event Setup
﻿
xxxxxxxxxx
 
<hr/>
When important user actions occur, in-app events can be sent to measure performance by channel.
All event parameters are optional. However, more information about the event will help provide a more accurate analysis.
`action`, `label`, `value`, `customAttributes` and `semanticAttributes` can be used for event options.
NameTypeDescription
Event CategoryStringName of the event
**Required**
Event ActionStringEvent attribute 1
Event LabelStringEvent attribute 2
Event ValueFloatEvent attribute value
Custom AttributesMap\<String, Object>Custom attributes
Semantic AttributesSemantic Attributes ClassSemantic attributes
﻿
xxxxxxxxxx
 
static void trackEvent(String category, [ AirbridgeEventOption? option ]) {
    event.trackEvent(category, option);
}
﻿
### User Events
Send user events with the SDK.
`action`, `label`, `value`, `customAttributes` and `semanticAttributes` can be used for user events.
#### Sign Up
User identifiers are set with `setUser` and then sent with `AirbridgeCategory.SIGN_UP` for user sign ups.
﻿
xxxxxxxxxx
 
Airbridge.state.setUser(User(
    ID: 'personID1',
    email: 'persondoe@airbridge.io',
    phone: '1(123)123-1234',
));
Airbridge.trackEvent(AirbridgeCategory.SIGN_UP);
#### Sign In
User identifiers are set with `setUser` and then sent with `AirbridgeCategory.SIGN_IN` for user sign ins.
﻿
xxxxxxxxxx
 
Airbridge.state.setUser(User(
    ID: 'personID1',
    email: 'persondoe@airbridge.io',
    phone: '1(123)123-1234',
));
Airbridge.trackEvent(AirbridgeCategory.SIGN_IN);
#### Sign Out
 Send the sign out event with `AirbridgeCategory.SIGN_OUT`, and then reset the user identifiers with `Airbridge.state.setUser({})`.
﻿
xxxxxxxxxx
 
Airbridge.trackEvent(AirbridgeCategory.SIGN_OUT);
Airbridge.state.setUser(User());
﻿
All user identifier properties will disappear after `sign out` is called.
﻿
### E-commerce Events
#### Send e-commerce events with the SDK.
`action`, `label`, `value`, `customAttributes` and `semanticAttributes` can be used for e-commerce events.
It is possible to include product information using `semanticAttributes`. Custom key values can be used as well as the pre-defined values.
#### View Home Screen
﻿
xxxxxxxxxx
 
Airbridge.trackEvent(AirbridgeCategory.HOME_VIEW);
#### View Product Detail
﻿
xxxxxxxxxx
 
Airbridge.event.trackEvent(
  AirbridgeCategory.PRODUCT_DETAILS_VIEW,
  AirbridgeEventOption(
    semanticAttributes: {
      AirbridgeAttributes.PRODUCTS: [{
          AirbridgeProduct.PRODUCT_ID: 'coke_zero',
          AirbridgeProduct.NAME: 'Coke Zero',
          AirbridgeProduct.PRICE: 1.99,
          AirbridgeProduct.CURRENCY: 'USD',
          AirbridgeProduct.POSITION: 1,
          AirbridgeProduct.QUANTITY: 1,
        },
      ]
    }
));
#### View Product List
﻿
xxxxxxxxxx
 
Airbridge.event.trackEvent(
  AirbridgeCategory.PRODUCT_DETAILS_VIEW,
  AirbridgeEventOption(
    semanticAttributes: {
      AirbridgeAttributes.PRODUCT_LIST_ID: 'ID-1234567890',
      AirbridgeAttributes.PRODUCTS: [{
          AirbridgeProduct.PRODUCT_ID: 'coke_zero',
          AirbridgeProduct.NAME: 'Coke Zero',
          AirbridgeProduct.PRICE: 1.99,
          AirbridgeProduct.CURRENCY: 'USD',
          AirbridgeProduct.POSITION: 1,
          AirbridgeProduct.QUANTITY: 1,
        }, {
          AirbridgeProduct.PRODUCT_ID: 'burger_cheese_double',
          AirbridgeProduct.NAME: 'Double Cheeseburger',
          AirbridgeProduct.PRICE: 3.99,
          AirbridgeProduct.CURRENCY: 'USD',
          AirbridgeProduct.POSITION: 2,
          AirbridgeProduct.QUANTITY: 1,
        }
      ]
    }
));
#### View Search Result
﻿
xxxxxxxxxx
 
Airbridge.event.trackEvent(
  AirbridgeCategory.SEARCH_RESULT_VIEW,
  AirbridgeEventOption(
    semanticAttributes: {
      AirbridgeAttributes.QUERY: 'product',
      AirbridgeAttributes.PRODUCTS: [{
          AirbridgeProduct.PRODUCT_ID: 'coke_zero',
          AirbridgeProduct.NAME: 'product A',
          AirbridgeProduct.PRICE: 1.99,
          AirbridgeProduct.CURRENCY: 'USD',
          AirbridgeProduct.POSITION: 1,
          AirbridgeProduct.QUANTITY: 1,
        }, {
          AirbridgeProduct.PRODUCT_ID: 'burger_cheese_double',
          AirbridgeProduct.NAME: 'product B',
          AirbridgeProduct.PRICE: 3.99,
          AirbridgeProduct.CURRENCY: 'USD',
          AirbridgeProduct.POSITION: 2,
          AirbridgeProduct.QUANTITY: 1,
        }
      ]
    }
));
#### Add To Cart
﻿
xxxxxxxxxx
 
Airbridge.event.trackEvent(
  AirbridgeCategory.ADD_TO_CART,
  AirbridgeEventOption(
    semanticAttributes: {
      AirbridgeAttributes.CART_ID: 'ID-1234567890',
      AirbridgeAttributes.CURRENCY: 'USD',
      AirbridgeAttributes.TOTAL_VALUE: 5.98,
      AirbridgeAttributes.PRODUCTS: [{
          AirbridgeProduct.PRODUCT_ID: 'coke_zero',
          AirbridgeProduct.NAME: 'Coke Zero',
          AirbridgeProduct.PRICE: 1.99,
          AirbridgeProduct.CURRENCY: 'USD',
          AirbridgeProduct.POSITION: 1,
          AirbridgeProduct.QUANTITY: 1,
        }, {
          AirbridgeProduct.PRODUCT_ID: 'burger_cheese_double',
          AirbridgeProduct.NAME: 'Double Cheeseburger',
          AirbridgeProduct.PRICE: 3.99,
          AirbridgeProduct.CURRENCY: 'USD',
          AirbridgeProduct.POSITION: 2,
          AirbridgeProduct.QUANTITY: 1,
        }
      ]
    }
));
#### Purchase
﻿
xxxxxxxxxx
));
 
Airbridge.event.trackEvent(
  AirbridgeCategory.ORDER_COMPLETED,
  AirbridgeEventOption(
    semanticAttributes: {
      AirbridgeAttributes.TRANSACTION_ID: 'transactionID-purchase',
      AirbridgeAttributes.CURRENCY: 'USD',
      AirbridgeAttributes.TOTAL_VALUE: 5.98,
      AirbridgeAttributes.IN_APP_PURCHASED: true,
      AirbridgeAttributes.PRODUCTS: [{
          AirbridgeProduct.PRODUCT_ID: 'coke_zero',
          AirbridgeProduct.NAME: 'Coke Zero',
          AirbridgeProduct.PRICE: 1.99,
          AirbridgeProduct.CURRENCY: 'USD',
          AirbridgeProduct.POSITION: 1,
          AirbridgeProduct.QUANTITY: 1,
        }, {
          AirbridgeProduct.PRODUCT_ID: 'burger_cheese_double',
          AirbridgeProduct.NAME: 'Double Cheeseburger',
          AirbridgeProduct.PRICE: 3.99,
          AirbridgeProduct.CURRENCY: 'USD',
          AirbridgeProduct.POSITION: 2,
          AirbridgeProduct.QUANTITY: 1,
        }
      ]
    }
﻿
To configure and deliver `Semantic Attributes` directly, please refer to this [guide](🔗﻿).
﻿
### Verify Event Transmission
Make sure that the events are being properly sent through the SDK.
Send an event with the SDK.
Check if the event shows up at "Airbridge dashboard → Raw Data → App Real-time Logs".
﻿
<br><br>
## Advanced Setup
﻿
xxxxxxxxxx
 
<hr/>
Please refer to the below guide for advanced settings.
﻿[Advanced Setup Guide](🔗﻿)﻿
﻿
### SDK Signature Setup
Protection against SDK spoofing is possible once you set your SDK Signature.
This feature is available for the Airbridge Flutter SDK v3.2.0 and above.
Add the following lines in the airbridge.json file.
﻿
xxxxxxxxxx
 
{
    "sdkSignatureSecretID": "YOUR_SDK_SIGNATURE_SECRET_ID",
    "sdkSignatureSecret": "YOUR_SDK_SIGNATURE_SECRET"
}
﻿
Please ask your CSM for the "SDK Signature Secret ID" and "SDK Signature Secret" values.
﻿
### Uninstall Tracking
﻿
This feature is available only for Flutter SDK v3.0.2+.
Airbridge Android SDK v2.6.0+
Airbridge iOS SDK v1.28.2+
Please refer to [this guide](🔗﻿) for details.
#### Send Push Token
﻿
xxxxxxxxxx
 
Airbridge.registerPushToken(token);
Forward the push token to Airbridge using the `registerPushToken` method.
Make sure the notification is not shown on the device if the remote message value is `airbridge-uninstall-tracking`.
<br><br>
## Hybrid App Setup
﻿
xxxxxxxxxx
 
<hr/>
While basic events (e.g. "install", "open", "deep link open") can be automatically tracked by only installing the Flutter SDK in your hybrid app, in-app events (e.g. sign-up, purchase, etc.) cannot be tracked as they are actually in-browser events that occur within a website of the WebView environment. Airbridge provides a simpler way to track in-app events by enabling the Flutter SDK to automatically pull all events from the web SDK that is installed on the website of the WebView environment. This replaces the hassle of having to create bridge functions between native and WebView environments.
﻿
xxxxxxxxxx
 
Airbridge.createWebInterface(
      webToken: 'YOUR_WEB_TOKEN',
      postCommandFunction: (arg) {
        return """..."""; 
    });
You can control the web interface using `Airbridge.createWebInterface`. Refer to the [Flutter Hybrid App Integration Guide](🔗﻿) for details.
<br><br>
## Troubleshooting
﻿
xxxxxxxxxx
 
<hr/>
### Update 2.X.X → 3.X.X
The event API has been replaced to the below.
﻿
xxxxxxxxxx
 
static void trackEvent(String category, [ AirbridgeEventOption? option ]) {
  event.trackEvent(category, option);
}
Refer to the [Flutter 3.X.X migration guide](🔗﻿) for details.
﻿
### Bitcode Compile Error
An error like below may occur when creating iOS builds with Flutter SDK v3.0.1+.
﻿
xxxxxxxxxx
 
ld: XCFrameworkIntermediates/AirBridge/AirBridge.framework/AirBridge(AirBridge-arm64-master.o)' does not contain bitcode. You must rebuild it with bitcode enabled (Xcode setting ENABLE_BITCODE)
Flutter SDK v3.0.1+ uses Airbridge iOS SDK v1.28.0+, and Bitcode is no longer supported. Please refer to the [Bitcode compile error guide](🔗﻿) for more details.
﻿
### `settings.gradle` (Android only)
If a `Plugin project ... not found. Please update settings.gradle` error occurs, please edit the `android/settings.gradle` file as below.
﻿
xxxxxxxxxx
 
include ':app'
​
def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
​
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
    pluginsFile.withReader('UTF-8') { reader -> plugins.load(reader) }
}
​
plugins.each { name, path ->
    def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
    include ":$name"
    project(":$name").projectDir = pluginDirectory
}
### Could not find or use auto-linked library...
Flutter issue: <https://github.com/flutter/flutter/issues/16049>
Airbridge Flutter SDK is a Swift plugin, and Flutter has an issue when a 100% Objective C project uses the Swift Plugin.
Click `File → New > File... → Swift File` to create an empty Swift file and a bridge header.
Issue does not exist with an "Objective C & Swift Project" or a  "100% Swift Project".
﻿
### Update 1.X.X to 2.X.X
iOS
Change the `AirbridgeFL` classes to `AirbridgeFlutter` in the `AppDelegate` file.
Android
Change the `AirbridgeFL` classes to `AirbridgeFlutter` in `MainApplication` and `MainActivity`.
Change the `processDeeplinkData` method to `processDeeplink` in `MainActivity`.
## SDK Installation

### Package Installation

#### `pubspec` Setup

### Project Setup

#### `airbridge.json`

#### iOS Setup

#### Android Setup

### Common Settings

#### airbridge.json

🚧﻿

### Testing the SDK

#### Check in the Airbridge Dashboard

🚧﻿

## Deep Link Setup

### Dashboard Setup

### Project Setup

#### iOS Deep Link Setup

#### Android Deep Link Setup

#### Callback Setup

#### Custom Domain (Optional)

### Test Deep Link

## User Setup

### User Identifier Setup

### User Identifier Setup

📘﻿

🚧﻿

📘﻿

### User Attribute Setup

🚧﻿

### Testing

## Device Setup

### Setup Device Alias

## Event Setup

### User Events

#### Sign Up

#### Sign In

#### Sign Out

🚧﻿

### E-commerce Events

#### Send e-commerce events with the SDK.

#### View Home Screen

#### View Product Detail

#### View Product List

#### View Search Result

#### Add To Cart

#### Purchase

📘﻿

### Verify Event Transmission

## Advanced Setup

### SDK Signature Setup

📘﻿

### Uninstall Tracking

📘﻿

#### Send Push Token

## Hybrid App Setup

## Troubleshooting

### Update 2.X.X → 3.X.X

### Bitcode Compile Error

### `settings.gradle` (Android only)

### Could not find or use auto-linked library...

### Update 1.X.X to 2.X.X

#### ``pubspec`` Setup

#### ``airbridge.json``

### ``settings.gradle`` (Android only)
