登录
目录
当前位置： 首页 > 文档资料 > FinClip 帮助文档中心 >

iOS 常见问题

优质
小牛编辑
136浏览
2023-12-01

1. 集成时常见问题

1.1 集成SDK的最低配置是什么？

答：FinClip小程序SDK支持iOS 9 以及 iOS 9以上，低于iOS 9的系统版本不支持。

1.2 是否支持bitcode？

答：不支持。

需要在 'Build Setting' 中 将 Enable Bitcode 设置为NO。

1.3 工程报错，找不到某个类别方法，怎么办？

答：这是因为没有配置-ObjC，SDK中有创建Catogery，需要在Build Setting中的 Other Linker Flags 中添加-ObjC。

1.4 初始化SDK的时候，有哪些参数是必须配置的？

答：appSecret、appKey、apiServer、apiPrefix 都是必须配置的。

FATConfig *config = [FATConfig configWithAppSecret:@"secret" appKey:@"appKey"];
    
config.apiServer = @"https://finchat-mop.finogeeks.club";
config.apiPrefix = @"/api/v1/mop";

另外，如果配置了currentUserId，则数据会缓存到该目录下，便于多账号切换时，加载不同账户下的数据。

1.5 为什么注册的自定义小程序API不起作用？

答：在注册自定义API时，会判断当前的小程序SDK是否初始化成功了。如果没有初始化成功，那么注册自定义Api就不会成功。

所以，注册自定义API前，一定要保证小程序已经初始化成功了。

1.6 小程序是否支持横竖屏切换或强制横屏？

答：支持。

如果想要小程序支持横竖屏切换，首先需要在iOS 工程的【General】 -> 【Deployment Info】 -> Device Orientation】中勾选Portrait、Landscape Left、Landscape Right 三个选项。

然后，在小程序的app.json的window 中配置[pageOrientation]，其值可选：auto / portrait / landscape。

或者，也可以单独在页面对应的json 配置中设置[pageOrientation]。

如果是iPad，想要允许设备支持横竖屏切换，需要设置 app.json的resizable。其值为boolean类型。

1.7 如何配置SDK批量更新的小程序个数？

答：在 FATConfig 中有一个属性appletIntervalUpdateLimit，该值默认为3。也就是后台自动检车版本时，只会检测最近使用的三个小程序。在初始化SDK的时候，可以修改appletIntervalUpdateLimit，取值范围0~50。

1.8 为什么要将FinClip SDK 从动态库改造为静态库？

答：因为精益求精，我们希望集成我们SDK的app，体积增长尽可能的小。以前app集成完整的FinClipSDK(核心SDK+扩展SDK)动态库，app打包出来的ipa会增长2.9M左右；

改造为静态库之后，app集成完整的FinClipSDK(核心SDK+扩展SDK)静态库，app打包出来的ipa只会增长2M。如果只集成核心SDK静态库的话，ipa仅增长1.8M。

1.9 从动态库调整为静态库，app在集成时需要做哪些调整？

答：这里分两种集成方式：pod集成和手动集成。

pod集成
如果是pod集成，不需要做额外的工作，只需要更新FinClip SDK的版本号即可。

手动集成
如果是手动集成，则按照以下步骤处理：

  1. 将frameworks和bundle拖进工程。
  2. General -> Frameworks,Libraries,and Embedded Content 中 添加 libc++.tbd库。
  3. Build Phases ->Copy Files中删除FinApplet.framework和FinAppletExt.framework
  4. 配置archive脚本
    SDK中包含x86_64架构，便于我们开发时用模拟器调试。但是x86_64架构的SDK，打包上传应用市场时会报错，所以配置一个打包时自动去除模拟器架构的脚本，可以让我们既可以用模拟器开发调试，又能正常提交应用市场。

当然，你也可以找我们要一个不包含模拟器的SDK。

脚本内容如下：

#!/bin/sh

# Strip invalid architectures

strip_invalid_archs() {
binary="$1"
echo "current binary ${binary}"
# Get architectures for current file
archs="$(lipo -info "$binary" | rev | cut -d ':' -f1 | rev)"
stripped=""
for arch in $archs; do
if ! [[ "${ARCHS}" == *"$arch"* ]]; then
if [ -f "$binary" ]; then
# Strip non-valid architectures in-place
lipo -remove "$arch" -output "$binary" "$binary" || exit 1
stripped="$stripped $arch"
fi
fi
done
if [[ "$stripped" ]]; then
echo "Stripped $binary of architectures:$stripped"
fi
}

APP_PATH="${TARGET_BUILD_DIR}/${WRAPPER_NAME}"

# This script loops through the frameworks embedded in the application and
# removes unused architectures.
find "$APP_PATH" -name '*.framework' -type d | while read -r FRAMEWORK
do
FRAMEWORK_EXECUTABLE_NAME=$(defaults read "$FRAMEWORK/Info.plist" CFBundleExecutable)
FRAMEWORK_EXECUTABLE_PATH="$FRAMEWORK/$FRAMEWORK_EXECUTABLE_NAME"
echo "Executable is $FRAMEWORK_EXECUTABLE_PATH"

strip_invalid_archs "$FRAMEWORK_EXECUTABLE_PATH"
done

2. 使用时常见问题

2.1 如何启动小程序？

答：调用如下API即可：

[[FATClient sharedClient] startRemoteApplet:appId startParams:startParams InParentViewController:viewController completion:^(BOOL result, NSError *error) {
        NSLog(@"result:%d---error:%@", result, error);
}];

2.2 是否有小程序打开时常见的错误码与排查方式？

答：常见的打开小程序失败的提示有如下 8 种：

  1. appId or appTitle is nil。 这是因为启动小程序时，没有配置appId；或者后台编辑小程序基本信息时，没有配置小程序名称。
  2. copyResources failed 这是因为将 下载的 小程序包或者基础库包移动到运行目录失败，这种情况大多是因为编译出来的小程序zip包或者 基础库zip包有问题导致的。
  3. service.html not found! 这是因为编译出来的 小程序zip包中 缺失 service.html，这种情况可能是因为编译出来的 小程序zip 有问题导致的。
  4. copy app file failed! 这是因为将下载的小程序zip 移动到缓存目录失败，极少会出现这种问题。
  5. 服务异常，获取小程序详情失败 这种情况一般是调用获取小程序详情的接口失败，一般是后台服务有问题，或者是小程序配置有问题。 记得，检查 apiPrefix 是否 正确配置为api/v1/mop。
  6. 合作已终止。 这种情况，一般是因为管理后台终止了与该应用（该对应bundleId）的合作。具体请咨询开放平台，或者后台管理员。
  7. 服务不可用。 这种情况，一般是小程序还未关联应用，或者是后台有问题。
  8. 服务异常，返回小程序详情数据异常。 这种情况，一般是因为后台服务出错，导致返回的数据格式不合法。

2.3 如何为小程序增加微信分享功能？

答：这里主要有如下 2 种场景：

  1. 将转发功能修改成微信分享；
  2. 自定义微信分享接口，然后小程序中调用自定义的微信分享接口。

2.3.1 将转发功能修改为微信分享

FinClip小程序SDK会将转发事件通过代理传递出来，所以只需要为[FATClient sharedClient].delegate设置一个实现的对象。

然后，就可以在如下代理方法中，获取到转发时的信息：

/** 转发事件
 当你点击小程序右上角更多里的转发菜单时，会触发小程序里shareAppMessage方法，然后回调到原生该方法
 @param contentInfo 小程序相关信息，里面包含小程序id、小程序名称、小程序图标、小程序截图（5：4）等。
 {
    appAvatar = "小程序图标地址";
    appDescription = "小程序的描述信息";
    appId = "小程序id";
    appInfo =  {}; // 客户可在appInfo中自定义字段，appInfo内容会透传
    appStartParams =     {
        path = "点击转发时的小程序页面路径";
    };
    appThumbnail = "小程序封面图的路径，可能是网络路径或者本地路径，宽高比是5:4";
    appTitle = "小程序名称";
    userId = "小程序开发者id";
}
 @param completion 执行完后的回调，如果你转发操作执行完后，希望告知小程序端转发结果，就需要调用该block。
 */
- (void)forwardAppletWithInfo:(NSDictionary *)contentInfo completion:(void (^)(FATExtensionCode code, NSDictionary *result))completion;

其中appInfo是小程序在onShareAppMessage新增的属性，内容可以定义各种键值对。

最后，调用微信分享SDK的分享小程序接口即可。

2.3.2 自定义微信分享接口，然后小程序中调用自定义的微信分享接口。

因为FinClip小程序SDK，支持自定义小程序API，所以我们可以先自定义一个分享API。在小程序SDK初始化之后，可以像如下这样注册一个小程序API：

    [[FATClient sharedClient] registerExtensionApi:@"shareToWechat" handle:^(id param, FATExtensionApiCallback callback) {
       // 这里可以获取到param，也就是小程序内传过去来的对象。
       
       // 然后调用微信分享接口，分享即可。
       
        callback(FATExtensionCodeSuccess, nil);
    }];

同时，在小程序根目录创建 FinClipConf.js 文件，配置示例如下：

module.exports = {
  extApi:[
    { //普通交互API
      name: 'shareToWechat', //扩展api名 该api必须Native方实现了
      params: { //扩展api 的参数格式，可以只列必须的属性
        path: '',
        title: '',
        description: ''
      }
    }
  ]
}

最后，在小程序里调用自定义的微信分享接口即可：

ft.shareToWechat

2.4 为何无法调用request、uploadFile、downloadFile接口？抓包也没看到接口调用过程。

答：如果上述三个接口无法调用，一般会看到如下的错误信息：url not in domain list。

这是因为没有在后台给小程序配置域名，配置域名的方式与微信的域名配置类似，都是要单独配置request/uploadFile/downloadFile 的域名。

2.5 为何在小程序的 webView 组件中无法加载网络链接？

答：如果你在使用webView打开链接时，提示 不支持打开非业务域名xxxxxxxx，请重新配置。那是因为没有在管理平台配置业务域名，这个业务域名是webView加载链接的域。

2.6 如何设置启动小程序时的转场动画方式？

答：现在启动小程序有如下 2 种动画方式：

  1. present的方式；
  2. 类似push的动画方式。

在调用如下启动函数时，设置transitionStyle即可，这个枚举值有：FATTranstionStyleUp、FATTranstionStylePush。

[[FATClient sharedClient] startRemoteApplet:appId startParams:appStartParams InParentViewController:self transitionStyle:FATTranstionStyleUp completion:^(BOOL result, NSError *error) {
    NSLog(@"result:%d---error:%@", result, error);
}];

2.7 如何注册自定义小程序API?

答：请参考iOS 注册自定义的小程序API进行对应操作

2.8 如何获取小程序当前页面截图？

答：调用如下函数即可获取小程序当前页面的截图（截图是5:4）。

UIImage *coverImage = [[FATClient sharedClient] getCurrentAppletImage];

2.9 小程序右上角的更多按钮里的菜单支持自定义吗？如果支持，要怎么实现？

答：支持。

需要实现两个代理方法。首先，自定义一个FATClientHelper类，实现FATAppletDelegate协议。

#import <Foundation/Foundation.h>
#import <FinApplet/FinApplet.h>

@interface FATClientHelper : NSObject<FATAppletDelegate>

+ (instancetype)shareInstance;

@end

然后，在SDK初始化成功后后，设置SDK的代理为 FATClientHelper 对象。

示例代码：

[[FATClient sharedClient] initWithConfig:config error:nil];
    
[FATClient sharedClient].delegate = [FATClientHelper shareInstance];

最后，在FATClientHelper中实现，如下协议方法：

// 返回要注入的菜单对象，菜单对象是要实现 FATAppletMenuProtocol 协议的
// 菜单对象分为两种类型（默认为Common类型）：
// 1.OnMiniProgram类型：需要后台配置+小程序配置，取相同menuId的集合显示
// 2.Common类型：配置则显示
// PS: 这里兼容旧版本，若后台未升级版本，或后台升级版本后未配置，则仅需要适配菜单对象的menuId为NSString类型

- (NSArray<id<FATAppletMenuProtocol>> *)customMenusInApplet:(FATAppletInfo *)appletInfo atPath:(NSString *)path
{
    
    FATCustomMenuModel *favModel1 = [[FATCustomMenuModel alloc] init];
    favModel1.menuId = @"WXShareAPPFriends";
    favModel1.menuTitle = @"微信好友";
    favModel1.menuIconImage = [UIImage imageNamed:@"minipro_list_wx_chat"];
    favModel1.menuType = FATAppletMenuStyleOnMiniProgram;

    FATCustomMenuModel *favModel2 = [[FATCustomMenuModel alloc] init];
    favModel2.menuId = @"WXShareAPPMoments";
    favModel2.menuTitle = @"微信朋友圈";
    favModel2.menuIconImage = [UIImage imageNamed:@"minipro_list_wx_monents"];
    favModel2.menuType = FATAppletMenuStyleOnMiniProgram;

    FATCustomMenuModel *favModel3 = [[FATCustomMenuModel alloc] init];
    favModel3.menuId = @"Restart";
    favModel3.menuTitle = @"重启";
    favModel3.menuIconImage = [UIImage imageNamed:@"minipro_list_restart"];
    favModel3.menuType = FATAppletMenuStyleCommon;

    return @[favModel1, favModel2, favModel3];
}

// 点击自定义菜单时的事件（旧版，后台未升级或升级后未配置菜单时使用）
- (void)customMenu:(id<FATAppletMenuProtocol>)customMenu inApplet:(FATAppletInfo *)appletInfo didClickAtPath:(NSString *)path
{
    NSLog(@"点击了%@",customMenu.menuTitle);
    NSLog(@"path = %@",path);
}

// 点击自定义菜单时的事件（新版，后台与小程序配置时使用）
- (void)clickCustomItemMenuWithInfo:(NSDictionary *)contentInfo completion:(void (^)(FATExtensionCode, NSDictionary *))completion 
{
    /**
    contentInfo 中包含
    {
         @"title": @"标题",
         @"description": @"描述",
         @"imageUrl": @"图片路径",
         @"path": @"点击时的小程序页面路径"",
         @"menuId": @"点击的菜单按钮标识",
         @"params": self.params     // 原始参数数据，由小程序提供
    }
    */
    // 小程序回调调用，通知小程序点击事件处理情况
    completion(FATExtensionCodeSuccess, contentInfo);
}

2.10 是否支持小程序某页面完全隐藏导航栏？如果支持，该如何实现？

答：支持。

像微信、支付宝、百度等小程序的navigationStyle有 default/custom两个值，而FinClip小程序SDK在此基础上，新增了一个hide，即有default/custom/hide三个值。

所以在需要隐藏导航栏的页面，设置navigationStyle为 hide即可。

2.11 如何设置灰度发布自定义规则？

答：小程序SDK的FATAppletDelegate中一个协议方法：

- (NSDictionary *)grayExtensionWithAppletId:(NSString *)appletId

实现这个协议方法即可。

示例代码如下：

/// 小程序灰度扩展参数
/// @param appletId 小程序id
- (NSDictionary *)grayExtensionWithAppletId:(NSString *)appletId
{
    NSDictionary *grayExtension = @{@"key1":@"value1"};
//    if ([appletId isEqualToString:@"5e017a61c21ecf0001343e31"]) {
//        grayExtension = @{@"fckey1":@"fcvalue1"};
//    }
    return grayExtension;
}

然后，小程序SDK在加载小程序时，会调用该协议方法获取小程序的灰度扩展参数，透传给后台服务匹配相关规则。

2.12 小程序中加载网页失败怎么办？

答：小程序加载网页失败时，可以打开SDK的Log日志开关。当然，错误信息也会在 webView的binderror回调中返回。

例如，如果看到如下这样的错误信息：

Code=-1022 "The resource could not be loaded because the App Transport Security policy requires the use of a secure connection."

分析得知是因为网络地址是http协议的，需要在app工程的info.plist中配置App Transport Security Settings -> Allow Arbitrary Loads为YES。

2.13 小程序SDK是否支持暗黑模式的适配？

答：支持。

小程序SDK初始化时，FATUIConfig类中有一个属性，只需要设置一下即可uiconfig.autoAdaptDarkMode = YES;。 小程序SDK中的暗黑模式适配，包括 更多 菜单页、关于页面、投诉与反馈页面。小程序的导航栏颜色不受暗黑模式影响。

2.14 小程序SDK支持禁用权限申请吗？

我们的APP是金融类型的app，对于权限，尤其是敏感权限（比如定位）等的控制非常重要，我们希望SDK不会主动申请权限，而是由APP在合适的时机申请权限，这样可以吗？

答：支持。

小程序SDK的config类中有一个属性disableAuthorize，可以控制权限的申请。

如果该属性不配置，或者配置为NO，那么小程序SDK中使用到还未用户授权的权限时，会向用户申请； 如果该属性设置为YES（config.disableAuthorize = YES;），那么当小程序SDK使用到还未用户授权的api时，会在api的失败回调中返回失败，errMsg中包含失败的原因（比如chooseImage:fail 无相册访问权限）。

2.15 支持替换返回按钮icon吗？要如何替换？

答：支持。

只需要在工程里放一个png图片，然后命名为fin_btn_navi_back即可，需要通过mianBundle 能访问到哦。

2.16 是否支持小程序中打开safari？

答：支持。

虽然，我们SDK中没有使小程序打开手机safari，并且加载指定url的api。但是我们SDK 支持注册自定义api，所以通过注入自定义H5 api，可以实现该功能。 因为注入自定义api分两个场景：注册小程序使用的api 和 注册小程序中的H5使用的api。 SDK 为这两种场景分别提供了函数，并且他们的处理流程也不同，所以要分开讲。

小程序中的H5里打开safari 首先，初始化SDK之后，注册一个自定义api，代码片段示例如下：

[[FATClient sharedClient] fat_registerWebApi:@"openInSafari" handle:^(id param, FATExtensionApiCallback callback) {
    NSString *url = param[@"url"];
    [[UIApplication sharedApplication] openURL:[NSURL URLWithString:url]];
    
    callback(FATExtensionCodeSuccess, nil);
}];

然后，加载H5的页面中引入凡泰小程序jssdk。

最后，在H5中的逻辑中，调用注册的自定义api:

window.FinChatJSBridge.invoke('openInSafari', {url:'https://www.finclip.com'}, (result) => {
    console.log(result)
});

小程序中打开safari

首先，注册小程序用的自定义api，片段示例：

[[FATClient sharedClient] registerExtensionApi:@"openInSafari" handle:^(id param, FATExtensionApiCallback callback) {
    NSString *url = param[@"url"];
    [[UIApplication sharedApplication] openURL:[NSURL URLWithString:@""]];
    
    callback(FATExtensionCodeSuccess, nil);
}];

然后，小程序的根目录FinClipConf.js中，配置自定义的api。

module.exports = {
  extApi:[
    { 
      name: 'openInSafari', 
      params: { 
        url: ''
      }
    }
  ]
}

最后，小程序中调用该自定义即可：

ft.openInSafari({
    url:'https://www.baidu.com',
    success: function (res) {
        console.log("startRecord success");
        console.log(res);
    },
    fail: function (res) {
        console.log("startRecord fail");
        console.log(res);
    }
});

2.17 小程序中支持获取到启动小程序的参数？如何获取？

答：支持。 但小程序中只能获取到启动参数里的query参数。

query里参数会被转成json，小程序可以在生命周期事件onLaunch(options)、onShow(options) 的options中获取。

比如，以如下参数启动小程序：

    NSDictionary *startParam = @{
        @"query":@"key1=value1&key2=value2",
        @"path":@"pages/showToast/showToast"
    };
    [[FATClient sharedClient] startRemoteApplet:@"afdfddfdfdf" startParams:startParam InParentViewController:self completion:nil];

那么，在小程序的生命周期事件中获取启动参数：

onLaunch(options) {
    console.log("App onLaunch =====>" + JSON.stringify(options))
    //options.query.key1
    //options.path
  },
  
 onShow(options) {
    // Do something when show.
    console.log("App onShow =====>" + JSON.stringify(options))
    //options.query.key1
    //options.path
  },

2.18 SDK 能设置UserAgent吗？如何设置？

答：支持。

FATUIConfig中有个appendingCustomUserAgent的配置项，你设置的内容会添加到小程序页面对应的webView的userAgent中。

示例：

FATUIConfig *uiConfig = [[FATUIConfig alloc] init];//[FATClientHelper uiConfig];
uiConfig.progressBarColor = [UIColor redColor];
// 添加userAgent内容
uiConfig.appendingCustomUserAgent = @"custom agent";

[[FATClient sharedClient] initWithConfig:config uiConfig:uiConfig error:nil];

2.19 怎么在小程序中实现第三方登录？

1.集成 FinClip SDK（凡泰小程序SDK）

开发者首先需要集成 FinClip SDK，集成指南请参照 FinClip 小程序开放平台 iOS 集成文档，开放平台已有详尽的 iOS 集成文档，此处不再赘述。

2.自定义小程序接口以实现授权登录，获取用户信息，获取登录状态等功能

为了让小程序能过获取到小程序以外的 APP 数据，需要注册小程序自定义接口，自定义接口具体说明请参照 FinClip 小程序开放平台-自定义小程序接口。下面示例中的参数，均由开发者自行决定，本文仅为示范。

  • 自定义授权登录 login 接口
@property (nonatomic,strong) FATExtensionApiCallback callBack;
  
[[FATClient sharedClient] registerExtensionApi:@"login" handle:^(id param, FATExtensionApiCallback callback) {
  self.callBack = callback;
  // 进行三方登录。
  [self thirdLogin];
}];

- (void)thirdLogin {
  // ToDo 处理三方登录的逻辑 拿到结果后，将想要发送给小程序的信息进行回调。由开发者自行决定发生什么信息，凡泰只做传递，不会进行保存

  // For example 微信三方登录的文档 https://developers.weixin.qq.com/doc/oplatform/Mobile_App/WeChat_Login/Development_Guide.html

  self.callBack(FATExtensionCodeSuccess, @{@"code": @"success", @"openid": @"XXXXXXXXXXXXXXXXX"});
}
  • 自定义获取用户信息 getUserProfile 接口
[[FATClient sharedClient]registerExtensionApi:@"getUserProfile" handle:^(id param, FATExtensionApiCallback callback) {
    NSDictionary *userInfo = @{@"nickName": @"张三", @"avatarUrl": @"", @"gender": @1, @"country": @"中国", @"province": @"广东省", @"city": @"深圳",@"language": @"zh_CN"};
    NSDictionary *resDic = @{@"userInfo": userInfo};
    callback(FATExtensionCodeSuccess, resDic);
}];
  • 自定义检查用户token的checkSession 接口
[[FATClient sharedClient] registerExtensionApi:@"checkSession" handle:^(id param, FATExtensionApiCallback callback) {
  // For example
  if ([param[@"code"] intValue] == 1) {
      // ToDo something
  }
}];

2.20 是否支持把SDK中“小程序”文案替换为其它名称？

答：支持。

FATUIConfig中有个appletText的配置项，你设置的内容会替换显示原来的“小程序”文案。

示例：

FATUIConfig *uiConfig = [[FATUIConfig alloc] init];//[FATClientHelper uiConfig];
// 把“小程序”替换为“x应用”
uiConfig.appletText = @"x应用";

[[FATClient sharedClient] initWithConfig:config uiConfig:uiConfig error:nil];

2.21 数据上报时，是否会对上报的数据进行压缩？

答：数据上报时，SDK默认不对上报的数据进行压缩，如果要开启压缩，可以通过SDK初始化配置enableApmDataCompression参数为YES来实现。

示例：

FATConfig *config = [FATConfig configWithAppSecret:@"secret" appKey:@"appKey"];
config.apiServer = @"https://finchat-mop.finogeeks.club";
config.apiPrefix = @"/api/v1/mop";
config.enableApmDataCompression = YES;

2.22 是否支持禁用获取监管信息的小程序API？

答：支持。

SDK默认允许小程序调用获取监管信息的小程序API（getSuperviseInfo），如果要禁用，则可以通过SDK初始化配置disableGetSuperviseInfo参数为YES来实现。

示例：

FATConfig *config = [FATConfig configWithAppSecret:@"secret" appKey:@"appKey"];
config.apiServer = @"https://finchat-mop.finogeeks.club";
config.apiPrefix = @"/api/v1/mop";
config.disableGetSuperviseInfo = YES;

禁止后，小程序调用getSuperviseInfo时将会收到getSuperviseInfo:fail disabled回调

2.23 是否支持打开体验版小程序？

答：支持。

平台支持为小程序配置体验版本和体验成员，拥有体验权限的成员能够打开体验版小程序。

使用体验版小程序的步骤：

  1. 在平台中上传小程序，并为小程序配置体验版，配置方式请参考小程序开发-调试

  2. 在初始化SDK的时候传入用户ID：

FATConfig *config = [FATConfig configWithAppSecret:@"secret" appKey:@"appKey"];
config.apiServer = @"https://finchat-mop.finogeeks.club";
config.apiPrefix = @"/api/v1/mop";
config.currentUserId = @"userId";

只有当传入的用户ID在小程序配置的成员列表中时，才能打开体验版小程序，否则在打开小程序的时候，会提示“无体验权限”。

  1. 通过调用SDK提供的接口打开小程序，接口如下：
/// 解密信息，并启动小程序
/// @param request 加密信息的request
/// @param parentVC 父页面
/// @param completion 完成回调
/// @param closeCompletion 关闭小程序时的回调
- (void)startAppletWithDecryptRequest:(FATAppletDecryptRequest *)request
              InParentViewController:(UIViewController *)parentVC
                          completion:(void (^)(BOOL result, FATError *error))completion
                     closeCompletion:(dispatch_block_t)closeCompletion;

FATAppletDecryptRequest的结构如下：

/// 小程序解密请求（二维码打开小程序）
@interface FATAppletDecryptRequest : NSObject

/**
加密信息
*/
@property (nonatomic, copy) NSString *info;

/**
打开小程序时的转场动画方式
*/
@property (nonatomic, assign) FATTranstionStyle transitionStyle;

/**
是否动画，默认为YES
*/
@property (nonatomic, assign) BOOL animated;

@end

FATAppletDecryptRequest的info字段表示小程序加密信息，和小程序体验版二维码中的info字段对应。因此打开体验版小程序时，

FATAppletDecryptRequest的info字段传小程序体验版二维码中的info字段对应的value即可。

以下面这段体验版小程序二维码内容为例：

https://finchat-mop.finogeeks.club/mop/scattered-page/#/sdktip?type=scanOpen&info=SFODj9IW1ENO8OA0El8P79aMuxB1DJvfKenZd7hrnemVCNcJ+Uj9PzkRkf/Pu5nMz0cGjj0Ne4fcchBRCmJO+As0XFqMrOclsqrXaogsaUPq2jJKCCao03vI8rkHilrWxSDdzopz1ifJCgFC9d6v29m9jU29wTxlHsQUtKsk/wz0BROa+aDGWh0rKvUEPgo8mB+40/zZFNsRZ0PjsQsi7GdLg8p4igKyRYtRgOxUq37wgDU4Ymn/yeXvOv7KrzUT&codeType=trial

则info字段值应为：

SFODj9IW1ENO8OA0El8P79aMuxB1DJvfKenZd7hrnemVCNcJ+Uj9PzkRkf/Pu5nMz0cGjj0Ne4fcchBRCmJO+As0XFqMrOclsqrXaogsaUPq2jJKCCao03vI8rkHilrWxSDdzopz1ifJCgFC9d6v29m9jU29wTxlHsQUtKsk/wz0BROa+aDGWh0rKvUEPgo8mB+40/zZFNsRZ0PjsQsi7GdLg8p4igKyRYtRgOxUq37wgDU4Ymn/yeXvOv7KrzUT

3. 调试方面

3.1 如何调试小程序？

如果需要调试小程序，可以在app.json 里设置 debug:true，这样小程序就会开启vconsole。可以在vconsole看到小程序的log信息。

另外，在集成小程序SDK后，运行起小程序后，可以打开Safari，然后在工具栏 开发 中，选中运行的模拟器或者 真机设备，就可以选择小程序打开的页面列表，选中当前打开的页面，就可以审核页面元素、查看网络调用，已经一些log日志等。

免责声明： 以上内容版权归原作者所有，如有侵犯您的原创版权请告知，我们将尽快删除相关内容。感谢每一位辛勤著写的作者，感谢每一位的分享。
@小牛知识库 xnip.cn