集成 SDK 资源包
注意:本文档已停止维护并下线归档,请访问 https://docs.antom.com/ 获取最新内容。
本文为您介绍如何通过 CocoaPods 和手动方式快速集成 iOS SDK 资源包。
CocoaPods 集成
请按照以下步骤通过 CocoaPods 集成 SDK 资源包。
- 更新 .netrc 文件
出于安全考虑,Antom SDK 使用私有的 CocoaPods 源来分发 Pod。要访问私有源,您需要更新包含所需凭据的 .netrc 文件并重启终端。将下面代码复制到您的 .netrc 文件中即可更新 .netrc 文件。
.netrc 文件位于 ~/.netrc 目录中,如果不存在则需创建一个 .netrc 文件。关于 .netrc 文件的更多信息,请参阅 .netrc 文件。
machine globaltech.alipay.com
login antomsdk@aliyun.com
password Admin1234
- 添加私有源和依赖项到您的 Podfile
Antom 为您提供多种集成包选择,请根据您的需要使用对应代码将 CocoaPods 私有源和依赖项添加到您的 Podfile 中。
- 基础包(必选)
source 'https://globaltech.alipay.com/api/v1/file/common/5700989804217335/antom'
target 'YOUR_TARGET' do
pod 'AMSComponent'
end
- 安全扩展包(可选):当您需要安全扩展包时,请使用以下代码集成。安全扩展包可以提升安全性能,减少在支付流程中触发更多的安全挑战。
source 'https://globaltech.alipay.com/api/v1/file/common/5700989804217335/antom'
target 'YOUR_TARGET' do
pod 'AMSComponent'
pod 'AMSSecurity'
end
- Apple Pay 资源包(可选):当您需要集成 Apple Pay 时,请使用以下代码集成。Apple Pay 资源包可以和安全扩展包同时使用。
source 'https://globaltech.alipay.com/api/v1/file/common/5700989804217335/antom'
target 'YOUR_TARGET' do
pod 'AMSComponent'
pod 'AMSApplePay'
end
手动集成
如果您不使用 CocoaPods 集成,Antom 还为您提供手动集成方式。请按照以下步骤手动集成资源包:
- 下载资源包:
在 开发者中心 下载最新版 SDK 资源包,下载路径如下: Resources > Download Detail > iOS,选择对应的产品包,点击 View the download address of this package 下载。首次下载需要同意下载协议。
- 添加框架:
在项目中添加以下框架:
- AMSComponent.xcframework
- AlipayWebView.xcframework
按照 Build Phases > Copy Bundle Resources > Add Other 路径,添加 AlipayWebView.xcframework/ios-arm64/AlipayWebView.framework/IWebContainer.bundle 和 AMSComponent.xcframework/ios-arm64/AMSComponent.framework/AMSComponent.bundle。
- 在 Build Settings > Linking > Other Linker Flags 路径下添加 -ObjC。
集成 AlipayCN
注意:目前仅快捷支付产品支持集成 AlipayCN。
- 在主工程 Info.plist 文件中添加 URL Schemes 配置:
- 集成 AlipaySDK-iOS 包:
a. 启动 IDE(如 Xcode),把 iOS 包中的 AlipaySDK.framework 文件拷贝到项目文件夹下,并导入到项目工程中。
b. 在 Build Phases 选项卡中选择 Link Binary With Libraries,添加 Alipay SDK 依赖库。
c. 按照 Build Phases > Copy Bundle Resources > Add Other 路径,添加 AlipaySDK.framework/AlipaySDK.bundle。