Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

iOS 端集成 SDK 资源包

本文为您介绍如何通过 CocoaPods 和手动方式快速集成 iOS SDK 资源包。

CocoaPods 集成

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

  1. 更新 .netrc 文件

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

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

copy
machine globaltech.alipay.com 
login antomsdk@aliyun.com
password Admin1234
  1. 添加私有源和依赖项到您的 Podfile

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

  • 基础包-必选
copy
source 'https://globaltech.alipay.com/api/v1/file/common/5700989804217335/antom'

target 'YOUR_TARGET' do

  pod 'AMSComponent'

end
  • 安全扩展包-可选:当您需要安全扩展包时,请使用一下代码集成。安全扩展包可以提升安全性能,减少在支付流程中触发更多的安全挑战。
copy
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 资源包可以和安全扩展包同时使用。
copy
source 'https://globaltech.alipay.com/api/v1/file/common/5700989804217335/antom'

target 'YOUR_TARGET' do

  pod 'AMSComponent'
  pod 'AMSApplePay'

end
  1. 集成 AlipayCN

注意:目前只有 EasySafePay 产品支持集成 AlipayCN。

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

image.png

手动集成

如果您不使用 CocoaPods 集成,Antom 还为您提供手动集成方式。请按照以下步骤手动集成资源包:

  1. 下载资源包:

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

  1. 添加框架:

在项目中添加以下框架:

  • AMSComponent.framework
  • AlipayWebView.framework

添加 AlipayWebView.framework/IWebContainer.bundle 和 AMSComponent.framework/AMSComponent.bundle。

image.png

  1. 添加 -ObjC

Build Settings > Linking > Other Linker Flags 路径下添加 -ObjC

image.png

  1. 集成 AlipayCN

注意:目前只有 EasySafePay 产品支持集成 AlipayCN。

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

image.png