技术分享：如何在FinClip中运行小程序游戏？原创

wx638feca57f04b

发布于 2022-12-7 15:04

浏览

0收藏

千呼万唤始出来！FinClip 终于支持小游戏了。

我们团队算是FinClip的老用户了，年初就向官方提出了希望FinClip 支持微信小游戏的建议。随着前段时间“羊了个羊”微信小游戏的爆火，官方也把小游戏支持提上了日程，近期官方开启了公测通道。我们用周末用小游戏进行了测试，记录分享一下测试情况。
技术分享：如何在FinClip中运行小程序游戏？-鸿蒙开发者社区

实现效果将微信小游戏搬到自己的APP中
使用技术 FinClip 小程序容器
测试机系统 ios
测试demo 飞机大战小游戏
以下操作均是使用FinClip 小程序容器去实现的。iOS端操作如下：

第一步：获取凭据（ SDK KEY 及 SDK SECRET）

首先，集成 SDK 需要先在 FinClip 平台中创建应用并绑定小程序游戏应用，获得每个应用专属的SDK KEY及SDK SECRET后，随后就可以在集成 SDK 时填写对应的参数。打开小程序时 SDK 会自动初始化，并校验SDK KEY，SDK SECRET与BundleID(Application ID)是否正确，这一步正确了才能初始化成功并正常使用。

1.1 创建小程序游戏

需要登录FinClip管理后台「应用管理-新增合作应用」，完成应用创建；

1.2 获取 SDK KEY 及 SDK SECRET

创建应用并添加 Bundle ID后，选择对应 Bundle ID 后的「复制」，就可以导出对应的 SDK KEY 与 SDK SECRET了。
技术分享：如何在FinClip中运行小程序游戏？-鸿蒙开发者社区
SDK KEY：是合作应用能使用小程序SDK的凭证，如果SDK Key校验失败，则SDK的所有Api都无法使用。
SDK SECERT：是访问服务的安全证书。

第二步：集成 SDK

FinClip 小程序 SDK 目前支持pod集成或者手动集成，此次测试我们用的是pod集成。

2.1.1 安装pod环境

Cocoapods 提供了一个非常简单的依赖管理系统，避免手动导入产生的错误，非常方便。官方安装指南（英文） (opens new window)或CocoaPods安装教程（中文） (opens new window)。
技术分享：如何在FinClip中运行小程序游戏？-鸿蒙开发者社区
2.1.2 创建Podfile文件

如果你不需要使用扩展 SDK，那么在podfile中只依赖FinApplet即可。如果你需要使用扩展 SDK 中的 API，那么你还需要依赖FinAppletExt。比如：如果需要在小程序中使用蓝牙功能，可以在podfile中添加FinAppletBLE依赖；

集具体操作方法可以去详细查看官方的的文档。iOS如何引入一个SDK：https://design.finclip.com/technology_book/start-applet/02-应用开发入门/004.html

2.1.3 安装或更新依赖

然后，执行 pod update 或者 pod install 即可。

2.1.4 打开工程

执行完 pod update 或者 pod install ，打开工程目录，找到xxx.xcworkspace文件，双击打开即可。

三、添加SDK头文件

在需要使用 FinClip 小程序 SDK 的地方，添加如下代码：

#import <FinApplet/FinApplet.h>

如果还集成了扩展 SDK，那么调用扩展 SDK 中的 api，还需要加上下面的代码：

#import <FinAppletExt/FinAppletExt.h>

当然，最方便的方式是在 pch 文件中添加以上代码，这样在使用的地方就不用再引用了。

四、初始化 SDK

在工程的AppDelegate中的以下方法中，调用 SDK 的初始化方法。
技术分享：如何在FinClip中运行小程序游戏？-鸿蒙开发者社区

本次测试需要使用微信的登录，获取用户信息等能力，因此需要进行初始化注册组件。
技术分享：如何在FinClip中运行小程序游戏？-鸿蒙开发者社区
并在AppDelegate.m中增加下面的代码。

五、handleOpenURL处理

一般来说小游戏都需要支持外部通过链接打开，便于分享。则需要做如下处理。

- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
    /*  微信登录和分享    */
    if ([WXApi handleOpenURL:url delegate:[FATWXApiManager sharedManager]]) {
        return YES;
    }
    return YES;
}

// iOS 9.0 之前
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation{
    /*  微信登录和分享    */
    // `WeChatHandleURLDelegate ` 为 `WXApiDelegate`代理文件
    if ([WXApi handleOpenURL:url delegate:[FATWXApiManager sharedManager]]) {
        return YES;
    }
    return YES;
}

- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url{
    /*  微信登录和分享    */
    if ([WXApi handleOpenURL:url delegate:[FATWXApiManager sharedManager]]) {
        return YES;
    }
    return YES;
}

- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
  return [WXApi handleOpenUniversalLink:userActivity delegate:[FATWXApiManager sharedManager]];
}