Braintree iOS SDK

CocoaPods compatible Swift Package Manager compatible Carthage compatible

GitHub Actions Tests

欢迎使用 Braintree 的 iOS SDK。该库将帮助你在 iOS 应用中接受银行卡和替代支付方式。

📣 公告

Braintree iOS SDK 允许的部署目标为 iOS 14.0 或更高版本。它需要 Xcode 15.0+ 和 Swift 5.9+。

支持的支付方式

安装

我们建议使用 Swift Package ManagerCocoaPodsCarthage 将 Braintree SDK 集成到你的项目中。

Swift Package Manager

要将 Braintree 包添加到你的 Xcode 项目,请选择File > Swift Packages > Add Package Dependency,然后输入 https://github.com/braintree/braintree_ios 作为存储库 URL。 勾选你要包含的特定 Braintree 库的复选框。

如果你查看你的应用目标,你将看到你选择的 Braintree 库会自动链接为应用的框架(参见General > Frameworks, Libraries, and Embedded Content)。

BraintreePayPalBraintreeLocalPayment 也需要包含 BraintreeDataCollector 模块。

在你的应用源代码文件中,使用以下导入语法来包含 Braintree 的库

import BraintreeCore
import BraintreeCard
import BraintreeApplePay
import BraintreePayPal

CocoaPods

# Includes Cards and PayPal
pod 'Braintree'

# Optionally include additional Pods
pod 'Braintree/DataCollector'
pod 'Braintree/Venmo'

Carthage

Braintree 6.0.0+ 需要 Carthage 0.38.0+ 以及运行 carthage update 时的 --use-xcframeworks 选项。

github "braintree/braintree_ios" 添加到你的 Cartfile,并 将框架添加到你的项目

注意: 长期支持 Carthage 无法得到保证。请尽可能更新到 SPM。 如果有任何疑问,请在此讨论线程上发表评论。

文档

首先阅读 'Hello, Client!',了解有关基本设置和用法的说明。

接下来,阅读完整文档,以获取有关集成其他支付方式(如 PayPal 和 Venmo)的信息,并探索我们预构建的Drop-In UI 产品

升级你的 SDK 版本

如果你想更新到我们 SDK 的更新版本,请参阅以下推荐方法。

使用 Swift Package Manager

要使用 Swift Package Manager 进行更新,请选择File→ Packages → Update to Latest Package Versions

使用 Cocoapods

你可以使用 pod update 更新 Podfile 中列出的所有 pod,或者根据需要使用 pod update PODNAME 更新特定的 pod。 有关更多详细信息,请参阅Cocoapods 指南

使用 Carthage

要更新到每个框架的最新版本,只需运行 carthage update 命令。 有关更多详细信息,请查看Carthage 指南

版本

此 SDK 遵守我们的客户端 SDK 弃用政策。 有关 SDK 的潜在状态的更多信息,请查看我们的开发者文档

主要版本号 状态 已发布 已弃用 不支持
6.x.x 活跃 2023 年 6 月 待定 待定
5.x.x 非活跃 2021 年 2 月 2024 年 6 月 2025 年 6 月
4.x.x 不支持 2015 年 11 月 2022 年 2 月 2023 年 2 月

演示

  1. 我们的 Xcode 项目使用 SwiftLint。 要确保你已安装它,请参阅 DEVELOPMENT.md
  2. 运行 pod install
  3. 如果需要,解析 Swift Package Manager 包:File > Packages > Resolve Package Versions 或在终端中运行 swift package resolve
  4. 在 Xcode 中打开 Braintree.xcworkspace
  5. 选择 Demo 方案,然后运行

运行演示应用程序需要 Xcode 15.0+。

贡献

我们欢迎向此存储库提交 PR。 请参阅我们的 开发文档

反馈

Braintree iOS SDK 正在积极开发中,我们欢迎你的反馈!

以下是一些联系方式

帮助

许可证

Braintree iOS SDK 是开源的,并且在 MIT 许可证下可用。 有关更多信息,请参阅 LICENSE 文件。