干货|SDK集成指南—iOS集成指南（android studio集成sdk）

1、接入指南

·集成易动小程序 SDK 之前，您首先需要到【易动】官网注册并添加您的小程序 SDK

·选择 iOS 并输入即将集成到的工程的 bundleId

请注意：这里的 bundleId 不支持带有 * 通配符

·添加需要使用的插件

·点击"生成SDK"

2、iOS项目集成

·cocoapod集成

·点击”代码复制“，将复制的代码粘贴到工程的 Podfile 文件里

pod 'EMSDK' // 在实际使用中，这里替换成平台上”代码复制“的代码

3、SDK Api使用

引用头文件

#import <EMSDK/EMSDK.h>

初始化SDK

/// 初始化SDK
/// @param key 初始化的KEY，对应平台上的 License
+ (BOOL)initWithKey:(NSString *)key;

注意

License 过期后 SDK 的 api 将不能调用；

License 发生变动后，旧的 License 在未过期之前仍可以使用，但是新加入的插件，在采用旧的 License SDK中将不能使用；

综上：

License 过期后和License 发生变动（bundleId、添加的插件发生变动）后需要及时更新初始化 SDK 的 KEY

打开小程序

/// 打开小程序
/// @param startURL 小程序首页地址
/// @param fullscreen 是否全屏
/// @param viewController 控制器
+ (void)showWithStartURL:(NSURL *)startURL
              fullscreen:(BOOL)fullscreen
          viewController:(UIViewController *)viewController;




/// 打开小程序，带有系统导航栏（不适配暗黑模式）
/// @param startURL 小程序首页地址
/// @param toolbarTitle 导航栏标题
/// @param toolbarBackColor 导航栏背景颜色
/// @param toolbarTitleColor 导航栏标题颜色
/// @param isShowBackBtn 是否显示返回按钮
/// @param isHideToolBar 是否隐藏导航栏
/// @param isHideFunctionButton 是否隐藏右侧更多按钮
/// @param isHideButtonLine 是否隐藏导航栏线的分割线
/// @param viewController 控制器
+ (void)showWithStartURL:(NSURL *)startURL
            toolbarTitle:(NSString *)toolbarTitle
        toolbarBackColor:(NSString *)toolbarBackColor
       toolbarTitleColor:(NSString *)toolbarTitleColor
           isShowBackBtn:(BOOL)isShowBackBtn
           isHideToolBar:(BOOL)isHideToolBar
    isHideFunctionButton:(BOOL)isHideFunctionButton
        isHideButtonLine:(BOOL)isHideButtonLine
          viewController:(UIViewController *)viewController;








/// 打开小程序，带有系统导航栏（适配暗黑模式）
/// @param startURL 小程序首页地址
/// @param toolbarTitle 导航栏标题
/// @param toolbarBackColor 导航栏背景颜色(浅色模式)，仅支持16进制的颜色，如：#FF0000
/// @param toolbarDarkBackColor 导航栏背景颜色(深色模式)，仅支持16进制的颜色，如：#FF0000
/// @param toolbarTitleColor 导航栏标题颜色(浅色模式)，仅支持16进制的颜色，如：#FF0000
/// @param toolbarTitleDarkColor 导航栏标题颜色(深色模式)，仅支持16进制的颜色，如：#FF0000
/// @param isShowBackBtn 是否显示返回按钮
/// @param isHideToolBar 是否隐藏导航栏
/// @param isHideFunctionButton 是否隐藏右侧更多按钮
/// @param isHideButtonLine 是否隐藏导航栏线的分割线
/// @param viewController 控制器
+ (void)showWithStartURL:(NSURL *)startURL
            toolbarTitle:(NSString *)toolbarTitle
        toolbarBackColor:(NSString *)toolbarBackColor
        toolbarDarkBackColor:(NSString *)toolbarDarkBackColor
       toolbarTitleColor:(NSString *)toolbarTitleColor
       toolbarTitleDarkColor:(NSString *)toolbarTitleDarkColor
           isShowBackBtn:(BOOL)isShowBackBtn
           isHideToolBar:(BOOL)isHideToolBar
    isHideFunctionButton:(BOOL)isHideFunctionButton
        isHideButtonLine:(BOOL)isHideButtonLine
          viewController:(UIViewController *)viewController;












/// 获取SDK下绑定的小程序列表
/// @param page 获取列表第几页数据
/// @param size 每页的数据长度
/// @param success 成功回调,返回的数组中的每项字段的含义：
/*
  id（Int） --小程序id
  uniqueCode（String） --小程序唯一标识
  name（String） --小程序名称
  type（Int） --小程序类型(0:在线,1:离线)
  indexUrl（String） --小程序首页地址
  logoUrl（String） --小程序图标
  remark（String） --小程序备注
  scope（String） --小程序领域
  offlineUrl（String） --离线资源地址
  updateTime（Int） --更新时间,毫秒
  remoteUrl（String） --服务器地址
*/
/// @param failure 失败回调，返回的字符串为失败的具体原因
+ (void)getBindAppletListWithPage:(NSInteger)page
                             size:(NSInteger)size
                          success:(nullable void (^)(NSArray * _Nullable))success
                          failure:(nullable void (^)(NSString * _Nonnull))failure;








/// 打开小程序
/// @param uniqueCode 小程序唯一标识
/// @param viewController 控制器
+ (void)openAppletWithId:(NSString *)uniqueCode
          viewController:(UIViewController *)viewController;




/// 打开小程序
/// @param uniqueCode 小程序唯一标识
/// @param toolbarTitle 导航栏标题
/// @param toolbarBackColor 导航栏背景颜色，仅支持16进制的颜色，如：#FF0000
/// @param toolbarTitleColor 导航栏标题颜色，仅支持16进制的颜色，如：#FF0000
/// @param isShowBackBtn 是否显示返回按钮
/// @param isHideToolBar 是否隐藏导航栏
/// @param isHideFunctionButton 是否隐藏右侧更多按钮
/// @param isHideButtonLine 是否隐藏导航栏线的分割线
/// @param viewController 控制器
+ (void)openAppletWithId:(NSString *)uniqueCode
            toolbarTitle:(NSString *)toolbarTitle
        toolbarBackColor:(NSString *)toolbarBackColor
       toolbarTitleColor:(NSString *)toolbarTitleColor
           isShowBackBtn:(BOOL)isShowBackBtn
           isHideToolBar:(BOOL)isHideToolBar
    isHideFunctionButton:(BOOL)isHideFunctionButton
        isHideButtonLine:(BOOL)isHideButtonLine
          viewController:(UIViewController *)viewController;




/// 打开小程序，带有系统导航栏（适配暗黑模式）
/// @param uniqueCode 小程序唯一标识
/// @param toolbarTitle 导航栏标题
/// @param toolbarBackColor 导航栏背景颜色(浅色模式)，仅支持16进制的颜色，如：#FF0000
/// @param toolbarDarkBackColor 导航栏背景颜色(深色模式)，仅支持16进制的颜色，如：#FF0000
/// @param toolbarTitleColor 导航栏标题颜色(浅色模式)，仅支持16进制的颜色，如：#FF0000
/// @param toolbarTitleDarkColor 导航栏标题颜色(深色模式)，仅支持16进制的颜色，如：#FF0000
/// @param isShowBackBtn 是否显示返回按钮
/// @param isHideToolBar 是否隐藏导航栏
/// @param isHideFunctionButton 是否隐藏右侧更多按钮
/// @param isHideButtonLine 是否隐藏导航栏线的分割线
/// @param viewController 控制器
+ (void)openAppletWithId:(NSString *)uniqueCode
            toolbarTitle:(NSString *)toolbarTitle
        toolbarBackColor:(NSString *)toolbarBackColor
        toolbarDarkBackColor:(NSString *)toolbarDarkBackColor
       toolbarTitleColor:(NSString *)toolbarTitleColor
       toolbarTitleDarkColor:(NSString *)toolbarTitleDarkColor
           isShowBackBtn:(BOOL)isShowBackBtn
           isHideToolBar:(BOOL)isHideToolBar
    isHideFunctionButton:(BOOL)isHideFunctionButton
        isHideButtonLine:(BOOL)isHideButtonLine
          viewController:(UIViewController *)viewController;

打开 SDK 的 log (正式发布的时候请关闭此设置)

·pod 中引入 debug 子组件

pod 'EMSDK/Debug'

·打开 log 输出开关

在工程中找到EMSDK/Core/Resources/config.xml

将buildType字段对应的 value 值改为 debug

·监听 log 的输出

[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(log:) name:@"CDVConsoleLogNotification" object:nil];
  - (void)log:(NSNotification *)noti{
      NSLog(@"%@",[noti.object lastObject]);
  }

注意

使用 Scanner 时，需要向 info.plist 中引入相机的使用权限；