Skip to content

接入指南6.x

afeng159 edited this page Nov 13, 2018 · 17 revisions

一、接入要求

• iOS 8.0 或更高.
• Xcode 9.0 或更高版本(建议使用最新版本)

⚠️注意: 从 6.0.0 开始,我们只提供动态库版本。

使用动态库时,应用上传 App Store 需要删除动态库对模拟器cpu架构的支持才可正常提交,删除方式请参考下文中的「集成动态库上传 App Store」

二、接入流程

引入 framework

推荐使用 CocoaPods 导入 framework。如有特殊需求,也可以手动导入。

CococaPods 导入

基础版(basic):在你的 Podfile 文件中加入一行:pod 'YZAppSDK'

运行 pod install

手动导入

基础版(basic) 需要把 YZSDKCore.framework YZBase.framework 加入到工程

将对应的 framework 添加到 Embedded Binaries 中。

配置 Info.plist 中的权限

  • 设置 Photo Privacy (用户的留言可能需要用户选择图片) Photo Privacy
  • 设置 Photo Privacy (知识付费邀请卡可能需要用户保存图片) Photo Privacy
  • 设置 Location Privacy (多网点的店铺将可以选择附近的门店) Location Privacy
  • 设置 Schemes (付款需要用户打开微信和支付宝) schemes

配置 app scheme(微信支付完成后跳转回App)

在 info.plist 中配置你的 app 的 scheme.

scheme

然后通过 YZConfig 将 scheme 传递给 SDK.

YZConfig *config = [[YZConfig alloc] initWithClientId:kClientID];
NSString* scheme = [[[NSBundle mainBundle].infoDictionary[@"CFBundleURLTypes"] firstObject][@"CFBundleURLSchemes"] firstObject];
config.scheme = scheme;
[YZSDK.shared initializeSDKWithConfig:config];

更多细节请查看 GitHub Demo 中的代码.

⚠️只有配置了 Scheme, 并正确调用 SDK 的对应方法,微信支付完成后才能正确跳转回到你的 app 中。

Web页面加速

AppSDK 提供了 Web 页面加速的能力,大幅提升了 H5 页面的加载速度。配置方式请参见H5 加速指南

集成动态库上传 App Store

由于 iOS 编译的特殊性,为了方便开发者使用,我们将 x86_64 armv7 arm64 几个架构都合并到了一起,所以使用动态库上传 App Store 时需要将x86_64 架构支持删除后,才能正常提交审核

  1. 首先需要下载本项目中 script 文件夹下的 thin.sh 文件。
  2. 在SDK所在目录执行 ./thin.sh 删除 x86_64 平台的支持

bak文件是备份目录,上传 App Store 之后需要替换回bak目录下的SDK以便后续开发