iOS 版本记录



Branch iOS SDK 2.1.2 adds additional support for Meta AEM links. It also includes some bug fixes and debugging improvements.

  • SDK-1796, SDK-1797 and SDK-1906 additional support for Meta AEM links
  • SDK-1908 Xcode 14.3 warns on C functions with empty parameter lists
  • SDK-1747 macCatalyst SKAdNetwork crash on older devices
  • SDK-1893 SKAdNetwork additional logging and safety checks



Branch iOS SDK 2.1.1 contains changes to how URL query parameters, like GBRAID and GCLID, are parsed and stored as well as a small fix for Mac Catalyst.

  • [SDK-1747] Added if available check for SKAN on Mac Catalyst
  • [SDK-1800] Extract GBRAID & GCLID from Branch referred uri/url



Branch iOS SDK 2.1.0 contains improvements to testing and plugin support (Unity, RN, etc). Most clients will see no change.

SDK-1831 - Improved branch.json support

Support for logging via enableLogging.
Removed old Apple Search Ads support.
Support for deferred SDK initialization. This allows improved plugin lifecycle support.
SDK-1802 - Fix tvOS warnings.
SDK-1774 - Update Branch TestBed UI.



Branch iOS SDK 2.0.0 fixes longstanding issues with the umbrella header and project layout. Although the code is largely unchanged, this changes the SDK name from Branch to BranchSDK. Clients will need to update import statements. For example in Swift import Branch should be import BranchSDK

  • SDK-1329 - SDK umbrella header fix
  • SDK-1758 - Add gbraid timestamps to calls
  • SDK-1663 - Revert thread queue priority to avoid a potential priority inversion



  • SDK-1741 Fix iOS 15.4 callback handling when SKAN is enabled



  • SDK-1724 Branch SDK returns an error SKANErrorDomain Code=10 in initSession function - Fix



  • SDK-1659 SKAN 4.0 Support
    • Support for coarse-grained conversion value
    • Support for multiple conversion window
    • Support for locking conversions in SKAN windows
    • Added calls to updatePostbackConversionValue on Branch Open events



  • SDK-1658 Add Support for VIEW_ADINITIATE_STREAMCOMPLETE_STREAM and all V2 Events as Standard events
  • SDK-1480 [iOS 16] UIPaste Support for NativeLink Flow
    • Added API passPasteItemProviders
    • Added class BranchPasteControl
  • Requires Xcode 14+
  • Minimum target deployment updated to iOS 11.0
  • Known Issues:
    • Integration with Carthage fails for tvOS.



  • Updates to gbraid handling
  • Updated podspec to include LinkPresentation.framework



  • Added new methods to create Branch QR codes
  • Support for SKAN 3.0



  • 固定 bnc.lt from showing in the share sheet
  • Added helper method for adding LPLinkMetadata to share sheets



  • Added API for Adobe Launch plugin support.



  • Fix serialization issue.



  • Workaround server side issue with inconsistent response payload.



  • Add support for LPLinkMetadata on share sheets.
  • 使用 NSKeyedUnarchiver secureCoding on iOS 12+
  • Update Crashlytics to FIRCrashlytics
  • 改名 device_fingerprint_id and identity_id to better reflect function. Fingerprinting was removed long ago.
  • Remove credit related methods. The feature has been deprecated and the supporting services will be decommissioned.





  • Add timeout to Apple attribution token. Some users are reporting the call can hang.


(2021 年 3 月 26 日)


(2021 年 3 月 10 日)

  • 解决 podspec AdServices.framework issue. This addresses a crash on launch for older iOS versions.
  • 首次选择加入指示。减少服务器上的负载。


(2021 年 3 月 4 日)

  • Check AppTrackingTransparency status. The Branch SDK does not prompt the user, however, it does check what the current ATT authorization status is. This provides more clarity into why IDFA is not authorized.
  • Add support for AdServices.framework and the Apple Attribution Token. For CocoapodsAdServices.framework is included by default. For other integration options, you should include the AdServices.framework.
  • 缩短每个 FB 请求的默认 SKAN 超时。
  • 删除调试日志消息,以解决安全扫描程序的错误警报。



  • 切换到语义版本控制。
  • 添加静态 xcframework。预先构建的静态 xcframework 是附加到 github 发布页面的 Branch_static.zip。请注意,tvOS 不支持静态框架。
  • Remove some non-inclusive terms. The method addWhiteListedScheme is now named addAllowedScheme The method setWhiteListedSchemes is now named setAllowedSchemes
  • 现在,获取最后归因触点数据的方法在完成块中包括 NSError。
    • (void)lastAttributedTouchDataWithAttributionWindow:(NSInteger)window completion:(void(^) (BranchLastAttributedTouchData * _Nullable latd, NSError * _Nullable error))completion;
  • 删除旧的数据传输代码。解决潜在的 crash。



  • Remove some non-inclusive terms. The method blackListURLRegex is now named urlPatternsToIgnore
  • 将 API 以将 Facebook 合作伙伴参数附加到 Branch 安装、打开和事件上。有关有效参数的详细信息,请参阅 Facebook 的高级匹配文档。
  • Add support for xcframeworkBranch.xcframework has replaced Branch.framework. iOS and tvOS are both included in the same xcframework. The pre-built xcframework is Branch.zip attached to the github release page.
  • Carthage integrations require the --use-xcframeworks flag. This feature is not yet in the general carthage release, you will need to install carthage from source.
  • 改善服务器性能指标的 thread 安全性。



  • 启用 App Clip 以与 Full App 分享数据 此可选功能需要客户端设置应用分组(App Group)并将该应用分租 ID 提供给 Branch SDK。
  • 通过删除可变的 log 方法,日志归档和程序断点来解决安全扫描程序警告。如果您是直接使用这些 Branch 调试和日志功能,则需要更新代码。
  • 通过 json 文件支持 SDK 配置。这改善了对 React Native 和 Cordova 等平台的支持。
  • 默认情况下,通过省略 close call 来减少 SDK 网络流量。
  • 记录服务器请求 ID,以帮助调试请求问题。



  • 如果禁用了追踪,则删除了对安装数据的检查。



  • Removed default inclusion of AdSupport.framework in Cocoapods.
  • 添加了对 Swift Package Manager 的支持。
  • 添加了 Apple SKAdNetwork 支持,
  • 现在支持的最低版本为 iOS 9+。
  • 现在需要 Xcode 12+。



  • 添加了 tvOS 支持
  • 澄清了 LATD API 说明
  • 删除了 CircleCI
  • 启用了 disbale tracking (禁用追踪)后,更正了错误消息。



  • 记录 API 更新
  • 带有 UIScene 的深度链接处理程序
  • 现在需要 Xcode 11+。苹果将不再接受旧版本的提交。



  • Add new method disableAdNetworkCallouts
  • 带回调的 BranchEvent logEvent。
  • 删除证书固定。
  • 用 SHA256替换 MD5来缓存对象。防止安全扫描仪误报。
  • 恢复以前总是返回 main 的行为。



  • 添加 sharesheet 选项以覆盖占位符 url。这样可以更好地控制 iOS 13 preview header。
  • 修复编译警告。



  • Change type of field cpu_type



  • Change type of field cpu_type



  • 修复 logEvent 的首次运行问题。



  • 添加用于 Tune 兼容性的字段。
  • 运营商名称,连接类型,CPU 类型。
  • 添加回退功能以支持禁用模块。 C ++兼容性。
  • BranchEvent 安全性得到改善。
  • 添加用于插件支持的 API。



  • 在主线程上调用 FB SDK 的修补程序。



  • 更新 Apple Search Ads 行为和 API。
  • 最后归因触点 API 现在可以接受归因窗口。
  • 添加 URL 黑名单配置。
  • 删除了弃用的 Safari cookie 集成。
  • 修复 SDK 初始化中的竞争条件。
  • 从源代码修复 Carthage Swift 构建。
  • 修复 Swift getInstance 为空性。
  • 修复对象序列化错误。



  • 添加了对先前 Tune 数据的检查;找到后,将数据的状态设置为 "updated" ,以用于确定是新用户还是现有用户。



  • 修复为空性警告。



  • 新增了对跨平台 ID(CPID)和最后归因触点数据(LATD)的支持。
  • 修复了启动缓慢时的竞争条件。
  • 修复了罕见的 Keychain 死锁。



  • Remove deprecated UIWebView and replace with WebKit
  • 添加标准事件客户别名字段。
  • Cocoapods adds iAd by default.
  • 删除已弃用的 Fabric 集成。
  • 删除与 Apple 现有调试冗余的 Apple Search Ads 调试。
  • 收集 install 收据。
  • 修复代理网络调用错误。
  • 修复网络重试错误。



  • 修复由于 key 类型无效而可能导致的崩溃



  • 启用 privacy 时允许创建短链接。
  • 修复 Swift 示例和清理发行脚本。



  • 针对已改进 Facebook 和 Tune 的新标准事件。
  • 改善应用在前台时对非 Branch Link 的处理。
  • CircleCI 支持。
  • Carthage 预构建的二进制文件现在使用 Xcode 10构建,并且不再与旧 Xcode 兼容。



  • 已改进推荐文档。
  • 默认情况下禁用证书锁定。