支付宝使用流程和踩坑整理

官方开发指南

本文记录了我使用支付宝的一些过程
第一部分是一些我根据官方文档中摘录的可用的重要信息
第二部分是整理的 iOS/Android App 接入主要流程 && Demo
第三部分是遇到的几个坑，比较重要，特别记录一下

第一部分

---

应用创建及使用流程：

01_liucheng.jpg

1.创建应用

开发者使用支付宝账号登录开放平台（需实名认证的支付宝账号），根据实际需求创建应用（如“支付应用”）。
备注：创建应用时的应用状态为“开发中”，无法在线上正式调用接口。如您已经了解应用的基本功能，可点击此处跳过此步骤；

2.填写应用基础信息

名称 && 图标 将来会作为审核依据，审核规则

3. 配置应用环境

字段名称	字段描述
应用网关 对应下图1	用于接收支付宝异步通知，例如口碑开店中， 需要配置此网关来接收开发者门店被动通知
授权回调地址 对应下图2	第三方授权或用户信息授权后回调地址。 授权链接中配置的redirect_uri的值必须与此值保持一致。 (如：https://www.alipay.com) 注：当填入该地址时，系统会自动进行安全检测， 详情请参考安全检测。
RSA(SHA256)密钥 （对应下图3）	开发者要保证接口中使用的私钥与此处的公钥匹配， 否则无法调用接口。可参考密钥的生成与配置，且接口参数sign_type=RSA2。
RSA(SHA1)密钥 （对应下图4）	同上，且接口参数sign_type=RSA。

UI 页面参考

02_peizhi.png

签名与生成密钥

如何生成与配置密钥详见签名专区。
TIPS：必须填写“接口加密方式”（加密方式只需填写一个），才可以提交审核。

4.接入沙箱环境

开发中的应用无法调用线上正式环境的接口，蚂蚁提供了沙箱环境帮助开发者进行开发调通工作，沙箱环境自动为开发者分配沙箱应用，不依赖线上环境的应用创建；
点击“开放平台-开发者中心-沙箱环境”。进入沙箱环境页面，系统已经自动为你创建一个应用。与线上流程一致，只要配置了沙箱应用的密钥即可开始开发。

应用安全性开发指南

《开放平台第三方应用安全开发指南》给出常见开发场景下，帮助开发人员完善应用安全性的开发建议，同时也对常见的安全漏洞进行描述，并提供对应的修复方案。

各种官方Demo下载

各种版本Demo体验与下载 https://docs.open.alipay.com/399/106844/

开发上线指南

上线和使用指南https://docs.open.alipay.com/399/106853/

<center> 第二部分 </center>

iOS端接入指南

Android端接入指南

<center> 第三部分 </center>

遇到的坑和解决

这部分是集成Demo过程中主要遇到的三个问题解决，下面是我解决的方法，希望能帮到有缘人

• 集成支付宝 报错 “openssl/asn1.h file not found”
• 集成支付宝 报错 “library not found for -xxx”
• 集成支付宝 报错 "duplicate symbol _base64_encode"

下面分别说一下这三个问题

1.集成支付宝 报错 “openssl/asn1.h file not found”

03_q1.jpg

这个问题应该是最常见的问题，官方文档中也说了是查找头文件路径问题，解决方案如下:
点击项目名称，点击“Build Settings”选项卡，在搜索框中，以关键字“search”搜索，对“Header Search Paths”增加头文件路径：$(SRCROOT)/项目名称。如果头文件信息已增加，可不必再增加。

这里着重说一下原理

Build Setting 下面 Search 主要分三个类型

• Framework Search Paths
• Header Search Paths
• Library Search Paths

这三个类别在官方文档里解释很清楚(如图)

03_q12.jpg

• Framework Search Paths

在编译C、Objective-C、c++或objective - c++，以及产品使用的框架的链接器时，这是一个目录列表，其中包含了包含或导入头文件的编译器的目录。路径是由空格分隔的，因此任何带有空格的路径都必须正确引用。

• Header Search Paths

这是在编译C、Objective-C、c++或objective - c++时，编译器要搜索的文件夹的路径列表。路径是由空格分隔的，因此任何带有空格的路径都需要正确引用。

• Library Search Paths

这是一个目录列表，用于为该产品使用的库进行链接搜索。路径是由空格分隔的，因此任何带有空格的路径都需要正确引用。

小结
懂了原理就变的很清楚了，找不到文件实际上就是我们的路径没有配置正确

• 路径可以根据我们的项目分层自己设置，相应的路径配置也要配置正确
• 经测试，openssl文件夹，Utils文件夹，和支付宝SDK的文件夹要配置在同一级
• Framework Search Paths 和 Library Search Paths 是编译器和连接器找库和头文件的路径，配置内容是一致的
• 支付宝SDK的文件夹内部文件可以放一起，Header Search Paths 配置中只需要找到对应文件夹上一级即可

最终配置方式：

03.q13.jpg 03_q14.jpg

2.集成支付宝 报错 “library not found for -xxx”

04_q1.jpg

这个问题就是上面说的 Library Search Paths 配置问题。
原因就是项目中使用的第三方库，Xcode找不到对应的静态库，根据上面原理配置即可

3.集成支付宝 报错 "duplicate symbol _xxxxxx"

05_q1.jpg

这个问题是我项目中在集成支付宝的同时也有其他的支付相关库，仔细看报错会发现其中有两个路径。一个是支付宝下面 libcrypto.a 一个LLPayUtils下的libRsaCrypto.a 两者在编译过程中生成了同样的连接符号 gost_sign.o 导致连接器在连接过程中无法正确连接。

实际上就是两个库中都定义了 gost_sign.m 这样的源文件，文件内部有符号_unpack_cp_signature 和 _gost94_compute_public 等等

解决办法

1. 如果是自己写的文件直接修改内部符号
2. 如果是三方静态库自己看不了实现，就删除一个吧（欢迎补充更好的方法）

小结

1. 支付宝有些坑，但是如果懂原理，其实是很好解决的。要多学习

最后献上一个自己集成的小Demo欢迎下载查看
支付宝集成Demo:https://github.com/xiaoyouPrince/AliPayDemo