iOS 端集成 SDK 资源包

本文为您介绍如何通过 CocoaPods 和手动方式快速集成 iOS SDK 资源包。在您开始集成前，确保已完成以下环境准备工作：

• 已安装 Xcode 12 或更高版本。
• 确保 iOS 系统为 iOS 11 及以上版本。

CocoaPods 集成

请按照以下步骤通过 CocoaPods 集成 SDK 资源包。

1. 更新 .netrc 文件

出于安全考虑，Antom SDK 使用私有的 CocoaPods 源来分发 Pod。要访问私有源，您需要更新包含所需凭据的 .netrc 文件并重启终端。将下面代码复制到您的 .netrc 文件中即可更新 .netrc 文件。

.netrc 文件位于 ~/.netrc 目录中，如果不存在则需创建一个 .netrc 文件。关于 .netrc 文件的更多信息，请参阅 .netrc 文件。

machine globaltech.alipay.com 
login antomsdk@aliyun.com
password Admin1234

2. 添加私有源和依赖项到您的 Podfile

Antom 为您提供多种集成包选择，请根据您的需要使用对应代码将 CocoaPods 私有源和依赖项添加到您的 Podfile 中。

• （必选）基础包

source 'https://globaltech.alipay.com/api/v1/file/common/5700989804217335/antom'

target 'YOUR_TARGET' do

  pod 'AMSComponent'

end

• （可选）安全扩展包：当您需要安全扩展包时，请使用以下代码集成。安全扩展包可以提升安全性能，减少在支付流程中触发更多的安全挑战。

注意：如果您集成的是 EasySafePay 产品，请安装此安全扩展包。

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 还为您提供手动集成方式。请按照以下步骤手动集成资源包：

1. 下载资源包：

在开发者中心下载最新版 SDK 资源包，下载路径如下： Resources > Download Detail > iOS，选择对应的产品包，点击 View the download address of this package 下载。首次下载需要同意下载协议。

2. 添加框架：

在项目中添加以下框架：

3. 在 Build Settings > Linking > Other Linker Flags 路径下添加 -ObjC。

集成支付宝

注意：目前仅 EasySafePay 产品支持集成支付宝。

1. 在主工程 Info.plist 文件中添加 URL Schemes 配置：

2. 集成 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。