Flutter SDK Basic Integration

👍

SDK Stats

GitHub tag (latest by date)GitHub tag (latest by date)

전제 조건

In order to implement the Branch SDK into your Flutter app, you need to have/complete the following:

  1. Created a Branch Dashboard.
  2. Flutter installed.

1. Configure Your Branch Dashboard

Universal for all platforms, you first need to configure your app in the Branch Dashboard. Once logged in, navigate to the Configuration screen to configure your links and redirects.

기본 URL

Set a URL here to designate where the user will be redirected to when opening a Branch Link on web.

14781478

Android

Input your Android URI scheme to direct the app to open for users clicking on links with the app installed. If you have Android App Links enabled, input your SHA256 Cert Fingerprint as well.

Be sure to set your Google Play store listing as the fallback redirect for users clicking on links without the app installed.

Additional details on setting Android Redirects can be found here.

969969

iOS

Input your iOS URI Schemes to direct the app to open for users clicking on links with the app installed. Add your app's bundle identifiers and Apple App Prefix for Universal Links.

Be sure to set your App Store listing as the fallback redirect for users clicking on links without the app installed.

Additional details on setting iOS Redirects can be found here.

963963

2. Configure Native Platforms

In order to set up Branch, you will need to configure each platform to prepare for session initialization.

Android

For Android, you need to configure your AndroidManifest.xml file,

iOS

For iOS, you need to configure the following:

For Web, you need to add the Branch Javascript in your web\index.html at the top of your <body> tag

<script>
  (function(b,r,a,n,c,h,_,s,d,k){if(!b[n]||!b[n]._q){for(;s<_.length;)c(h,_[s++]);d=r.createElement(a);d.async=1;d.src="https://cdn.branch.io/branch-latest.min.js";k=r.getElementsByTagName(a)[0];k.parentNode.insertBefore(d,k);b[n]=h}})(window,document,"script","branch",function(b,r){b[r]=function(){b._q.push([r,arguments])}},{_q:[],_v:1},"addListener applyCode autoAppIndex banner closeBanner closeJourney creditHistory credits data deepview deepviewCta first getCode init link logout redeem referrals removeListener sendSMS setBranchViewData setIdentity track validateCode trackCommerceEvent logEvent disableTracking".split(" "), 0);
    branch.init('key_live_YOUR_KEY_GOES_HERE');
</script>

3. Install Branch

Add the Dependency

Run the following command in terminal flutter pub get to add the Flutter Branch SDK package.

flutter pub add flutter_branch_sdk

This will add the Flutter Branch SDK to your project's pubspec file.

dependencies:
  flutter_branch_sdk: ^5.0.0

Import Branch Package

In your Dart code, import Branch:

import 'package:flutter_branch_sdk/flutter_branch_sdk.dart';

4. Initialize Branch

In your main Dart file, you need to initialize the Branch Session listener before being able to use any of the SDK methods. A listener should be called early on in your initState() method:

FlutterBranchSdk.initSession().listen((data) {
  ...
}

Validate Integration

After initializing Branch, you can validate your integration verify your keys, schemes, etc. using the validateSDKIntegration() method. Do not forget to remove this line after validation.

FlutterBranchSdk.validateSDKIntegration();

5. Configure Deep Linking

Firstly, when your Branch Session is initialized, the you'll want to configure your deep linking routing logic.

StreamSubscription<Map> streamSubscription = FlutterBranchSdk.initSession().listen((data) {
  if (data.containsKey("+clicked_branch_link") &&
      data["+clicked_branch_link"] == true) {
    //Link clicked. Add logic to get link data and route user to correct screen
    print('Custom string: ${data["custom_string"]}');
    
  }
}, onError: (error) {
  PlatformException platformException = error as PlatformException;
  print(
    'InitSession error: ${platformException.code} - ${platformException.message}');
});

Recommended Next Steps
이 페이지가 도움이 되었습니까?