NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #1219 most downloaded on pub.dev
Flutter Plugin for create deep link using Brach SDK (https://branch.io). This plugin provides a cross-platform (iOS, Android, Web).
Last release 6 days ago
01 Oct 2026
Release timing varies
gaps range from 9 days to 3 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
96 releases · first in 2020
Updated included Branch Android SDK to exact version 5.21.3 - Android Version History
README.md native SDK version table with the Android SDK 5.21.3.Pinned included Branch Android SDK to exact version 5.21.2 to avoid unexpected native SDK updates on build.
BranchSDK and Swift Package Manager ios-branch-sdk-spm) to exact version 3.14.2One column per quarter.
BranchSDK and Swift Package Manager ios-branch-sdk-spm) to exact version 3.14.2README.md native SDK version table with the pinned Android/iOS versions and the updated Web SDK version.Pinned included Branch Android SDK to exact version 5.21.2 to avoid unexpected native SDK updates on build.
BranchSDK and Swift Package Manager ios-branch-sdk-spm) to exact version 3.14.2README.md native SDK version table with the pinned Android/iOS versions and the updated Web SDK version.Updated included Branch iOS SDK (ios-branch-sdk-spm / BranchSDK CocoaPods spec) to 3.14.2 - iOS Version History
Fix issue #502 - iOS scene lifecycle handlers returning true unconditionally, breaking URL handling for other plugins.
true unconditionally, breaking URL handling for other plugins.Fix issue #498 - Ensure that deep-link/session initialization functions correctly when applications use the UIScene lifecycle.
Updated included Branch Android SDK to 5.21.0 - Android Version History
setInstallReferrerTimeout - Provides a setting to cancel the external Install Referrer string fetch. This is useful to optimize performance on Android by limiting the time the SDK waits for the Install Referrer. Only applicable on Android - iOS ignores this setting.installReferrerTimeout configuration key in branch-config.json. This allows you to set the Install Referrer timeout during app initialization without code changes.
"installReferrerTimeout": 5000 (in milliseconds)README.md for full documentationREADME.md with comprehensive documentation for setInstallReferrerTimeout methodbranch-config.json sectionAdded optional deferred SDK initialization for iOS, allowing apps to initialize the native Branch SDK later (e.g., after obtaining user consent).
README.md and updated installation instructions.Fix issue #492 : enableLogging in branch-config.json breaks JSON key selection on iOS
Updated included iOS SDK to 3.14.0 - iOS Version History
platformLogs with more detailed information.configureBranchSDK() on iOS 13+ with Scene Delegate support. The method was being called from both application(_:didFinishLaunchingWithOptions:) and scene(_:willConnectTo:options:), causing duplicate logging callback registration and other redundant SDK initialization. Added idempotency guard with isSdkConfigured flag to prevent re-execution.Minimum Flutter version : 3.38.0 (was 3.19.0)
iOS UISceneDelegate Support (iOS 13+) Fluuter UISceneDelegate adoption
Pinned included Branch Android SDK to exact version 5.21.2 to avoid unexpected native SDK updates on build.
BranchSDK and Swift Package Manager ios-branch-sdk-spm) to exact version 3.14.2README.md native SDK version table with the pinned Android/iOS versions and the updated Web SDK version.Updated project configuration and dependencies for compatibility with iOS 12 and Flutter 3.32.7.
🐛 Bug Fixes
New Method: setInstallReferrerTimeout - Provides a setting to cancel the external Install Referrer string fetch. This is useful to optimize performanc
setInstallReferrerTimeout - Provides a setting to cancel the external Install Referrer string fetch. This is useful to optimize performance on Android by limiting the time the SDK waits for the Install Referrer. Only applicable on Android - iOS ignores this setting.installReferrerTimeout configuration key in branch-config.json. This allows you to set the Install Referrer timeout during app initialization without code changes.
"installReferrerTimeout": 5000 (in milliseconds)README.md for full documentation🐛 Bug Fixes
README.md with comprehensive documentation for setInstallReferrerTimeout methodbranch-config.json sectionAdded FlutterBranchSdk.platformLogs stream to receive Branch SDK log messages in real-time
New Platform Logging Stream
FlutterBranchSdk.platformLogs stream to receive Branch SDK log messages in real-timebranch-config.json (enableLogging and logLevel keys) or programmatically through FlutterBranchSdk.init()VERBOSE, DEBUG, INFO, WARNING, ERROR, and NONEFlutterBranchSdk.platformLogs.listen((logMessage) {
debugPrint('Branch Log: $logMessage');
});
Introduced platform-specific API URL configuration. This allows developers to define different API endpoints for Android and iOS in branch-config.json
Introduced platform-specific API URL configuration. This allows developers to define different API endpoints for Android and iOS in branch-config.json.
apiUrlAndroid in branch-config.json to configure the API URL for the Android platform.apiUrlIOS in branch-config.json to configure the API URL for the iOS platform.apiUrl key has been removed from branch-config.json. Please update your configuration to use the new platform-specific keys (apiUrlAndroid and apiUrlIOS).Updated README.MD with correct configuration for branch-config.json.
README.MD with correct configuration for branch-config.json.Android: Resolved build warnings (unchecked or unsafe operations, deprecated api) for a cleaner build process.
unchecked or unsafe operations, deprecated api) for a cleaner build process.showShareSheet function, which now requires a minimum of API level 22 (Android 5.1) to work correctly.FlutterBranchSdk.disableTracking() has been removed.Configuration through branch-config.json file.
branch-config.json file.
assets/branch-config.json file to your project.AndroidManifest.xml and Info.plist).branch-config.json file, streamlining the development and release process.branch-config.json file and its keys are optional. The plugin will gracefully handle its absence, allowing for programmatic setup or backward compatibility with the manual native setup. If the file is present but a key is missing, the plugin will use default values where applicable.Fix issue #461 : iOS Build Failure using CocoaPods
Nothing published for this version
Updated included iOS SDK to 3.13.0 - iOS Version History
setAnonID - Sets a custom Meta Anon ID for the current user.setSDKWaitTimeForThirdPartyAPIs - Set the SDK wait time for third party APIs (for fetching ODM info and Apple Attribution Token) to finishUpdated included Branch Android SDK to 5.19.0 - Android Version History
FlutterBranchSdk.validateSDKIntegration() methodUpdated included iOS SDK to 3.12.0 - iOS Version History
Fix issue #423: setRequestMetadata doesn't populate the key value pairs in the event request as expected
Updated included iOS SDK to 3.9.0 - iOS Version History
Minimum required Dart SDK version 3.3.0 (Flutter 3.19.0 - 15/02/2024)
Minimum required Dart SDK version 3.3.0 (Flutter 3.19.0 - 15/02/2024)
branch_disable_nativelink) that allows disable NativeLink™ Deferred Deep LinkingMinimum required Dart SDK version 3.3.0 (Flutter 3.19.0 - 15/02/2024)
setConsumerProtectionAttributionLevel - Sets the consumer protection attribution level. Read Branch documentation for details:
FlutterBranchSdk.disableTracking(). Use FlutterBranchSdk.setConsumerProtectionAttributionLevel().initSession method.Minimum required Dart SDK version 3.3.0 (Flutter 3.19.0 - 15/02/2024)
Fix issue #368: "-118, Warning. Session initialization already happened" triggered in the listSession callback
Updated included iOS SDK to 3.6.0 - iOS Version History
This is a major release which contains breaking API changes.
This is a major release which contains breaking API changes.
useTestKey parameter is no longer supported at FlutterBranchSdk.init().Check the instructions in README.MD on how to activate the key_test_.
This is a major release which contains breaking API changes.
This is a major release which contains breaking API changes.
useTestKey parameter is no longer supported at FlutterBranchSdk.init().Check the instructions in README.MD on how to activate the key_test_.
This is a major release which contains breaking API changes.
This is a major release which contains breaking API changes.
useTestKey parameter is no longer supported at FlutterBranchSdk.init().Check the instructions in README.MD on how to activate the key_test_.
FlutterBranchSdk.init() methodThis is a major release which contains breaking API changes.
This is a major release which contains breaking API changes.
useTestKey parameter is no longer supported at FlutterBranchSdk.init().Check the instructions in README.MD on how to activate the key_test_.
This is a major release which contains breaking API changes.
This is a major release which contains breaking API changes.
useTestKey parameter is no longer supported at FlutterBranchSdk.init().Check the instructions in README.MD on how to activate the key_test_.
Updated included Branch Android SDK to 5.11.0 - Android Version History
showShareSheet method will now display the native Android share sheet.
showShareSheet method will now display the native Android share sheet.js. From version 0.6.7 to 7.0.0setDMAParamsForEEA - In response to the European Union's enactment of the Digital Markets Act (DMA), this new method help pass consent information fro
setDMAParamsForEEA - In response to the European Union's enactment of the Digital Markets Act (DMA), this new method help pass consent information from your user to Google.
See documentation for details.Fix issue #289 : reverts js dependency update. From version 0.7.0 to 0.6.7
js dependency update. From version 0.7.0 to 0.6.7Fix issue #277 : PlatformException - NullPointerException
Fix issue #261 / #266 / #268: Calling startActivity() from outside of an Activity
Fix issue #255: Attempt to invoke virtual method 'int android.content.Intent.getFlags()' on a null object reference when using FlutterFragmentActivity
Attempt to invoke virtual method 'int android.content.Intent.getFlags()' on a null object reference when using FlutterFragmentActivityA problem occurred configuring project ':flutter_branch_sdk'. - Add compatibility with AGP 8 (Android Gradle Plugin)⚠️ This is a major release which contains breaking API changes.
⚠️ This is a major release which contains breaking API changes.
FlutterBranchSdk.init() method to initialize the SDK.Initialization must be called from main or at any time (for example after getting consent for GPDR).
await FlutterBranchSdk.init(
useTestKey: false, enableLogging: false, disableTracking: false);
Check additional instructions in the README
FlutterBranchSdk.initSession(). Use FlutterBranchSdk.listSession().setIOSSKAdNetworkMaxTime methodNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Issue #244 - Support for setting customer_event_alias for BranchEvent
Android Native SDK Update 5.7.+ - Android Version History
Android SDKs:
branch_enable_facebook_ads)Fix issue #237: Pass long URL when try creating Short URL in Offline
Pass long URL when try creating Short URL in OfflineUpdated Native Android and iOS SDKs:
Android and iOS SDKs:
listOnSearch and removeFromSearch return success but do not perform any action)branch_check_apple_ads)Updated Native Android and iOS SDKs:
Updated Native Android and iOS SDKs:
New Methods:
addSnapPartnerParameter - See documentation on partner parameters for details.iOS Native SDK Update 2.0.0 - iOS Version History
iOS SDK:
Fix issue #193: Flutter app won't get notified about the quick link event if the app is at foreground on Android devices
Fix issue #193: Flutter app won't get notified about the quick link event if the app is at foreground on Android devices
New Methods:
addFacebookPartnerParameter - See documentation on partner parameters for details.clearPartnerParameter - Clears all Partner ParameterssetPreinstallCampaign - Add the pre-install campaign analyticssetPreinstallPartner - Add the pre-install campaign analyticsUpdated Native iOS SDK:
Note: Requires Xcode 14+
Fix issue #188: Failed to handle method call: java.lang.NullPointerException
handleDeepLinkFailed to handle method call: java.lang.NullPointerExceptionFix crash when adding a boolean control paramgetTrackingAuthorizationStatus will open the iOS-dialog to requestTrackingAuthorizationFix issue #181: Calling the getLastAttributedTouchData() exit with exception on IOS 15.7
Calling the getLastAttributedTouchData() exit with exception on IOS 15.7Update BranchStandardEvent list.
BranchStandardEvent list.Updated Android Advertising ID (AAID) version in Android SDK.
Android Advertising ID (AAID) version in Android SDK.Your coding agent can read these notes before it upgrades. Set up the MCP server →