正文 

当前位置： 首页 > 代码 > java教程

如何把小程序游戏运行到自有app中？（ios篇）(代码片段)

finogeeks finogeeks     2023-04-02     542

关键词：

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

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

第一步：获取凭据（ 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 了。

 

  • 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)。

sudo gem install cocoapods
pod setup

2.1.2 创建 Podfile 文件

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

集具体操作方法可以去详细查看官方的的文档。iOS 如何引入一个 SDK

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 的初始化方法。

NSMutableArray *storeArrayM = [NSMutableArray array];
FATStoreConfig *storeConfig = [[FATStoreConfig alloc] init];
storeConfig.sdkKey = @"您的sdkKey信息";
storeConfig.sdkSecret = @"您的sdkSecret信息";
storeConfig.apiServer = @"服务器域名";
storeConfig.apmServer = @"apm统计事件的域名";
[storeArrayM addObject:storeConfig];
    
FATStoreConfig *storeConfig2 = [[FATStoreConfig alloc] init];
storeConfig2.sdkKey = @"您的sdkKey信息";
storeConfig2.sdkSecret = @"您的sdkSecret信息";
storeConfig2.apiServer = @"服务器域名";
storeConfig2.apmServer = @"apm统计事件的域名";
storeConfig2.cryptType = FATApiCryptTypeSM;
[storeArrayM addObject:storeConfig2];
 
FATConfig *config = [FATConfig configWithStoreConfigs:storeArrayM];
[[FATClient sharedClient] initWithConfig:config error:nil];

本次测试需要使用微信的登录，获取用户信息等能力，因此需要进行初始化注册组件。

// 微信扩展SDL初始化
[FATWXExtComponent registerComponent:@"微信appid" universalLink:@"universalLink"];

并在 AppDelegate.m 中增加下面的代码。

- (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]];

五、handleOpenURL 处理

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

- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation

    if ([[FATClient sharedClient] handleOpenURL:url]) 
        return YES;
    
    return YES;

 
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options

    if ([[FATClient sharedClient] handleOpenURL:url]) 
        return YES;
    
    return YES;

六、打开小程序

FATAppletRequest *request = [[FATAppletRequest alloc] init];
request.appletId = @"小游戏id";
request.apiServer = @"服务器地址";
request.transitionStyle = FATTranstionStyleUp;
request.startParams = startParams;
     
[[FATClient sharedClient] startAppletWithRequest:request InParentViewController:self completion:^(BOOL result, FATError *error) 
    NSLog(@"打开小游戏:%@", error);
 closeCompletion:^
    NSLog(@"关闭小游戏");
];

打开效果如下：

 本次测试使用的是官方给到的 demo，整体流程跑下来是比较顺利的，没有遇到特别卡壳的地方，目前官方正在做内测，感兴趣的朋友都可以去官方平台看看。小游戏开发指南

接下来，安卓系统我们打算使用自己的小游戏再跑一次流程，届时再给大家做分享。

可以从ios应用程序中提取游戏文件吗？

】可以从ios应用程序中提取游戏文件吗？【英文标题】：Possibletoextractgamefilesfromiosapp?【发布时间】：2018-08-2712:56:50【问题描述】：我最近不小心删除了Xcode中的一些关键IOS游戏文件。在删除上述文件之前，我将我的IOS游戏上传到... 查看详情

如何将智能设备关联至云开发中的项目？

将应用中已经连接的设备关联至云项目后，就可以在 涂鸦IoT开发平台 通过云开发主动管理和控制对应的设备。云开发提供多种应用中的设备关联方式：关联自有App账号关联自有小程序关联涂鸦App账号关联SaaS方式一࿱... 查看详情

Xcode：如何将 Unity 游戏添加到现有的 iOS 应用程序？

】Xcode：如何将Unity游戏添加到现有的iOS应用程序？【英文标题】：Xcode:HowtoaddUnitygametoanexistingiOSapp?【发布时间】：2020-01-0611:35:07【问题描述】：我想将Unity游戏添加到现有的iOS应用中。我在Xcode中使用Swift进行编程，所以我更喜... 查看详情

集成unity3d到ios应用程序中

...交互、2D迷你游戏等。Unity静态库提供了多种方法来管理如何在原生应用程序中加载、激活和卸载Unity3DPlayer。以下平台目前支持Unity用作库：Android，iOS，Windows和通用Windows平台。使用Unity构建iOS工程先使用Unity构建一个Xcode项目，... 查看详情

如何将app程序发布到appstore

　　即便是免费应用也需要一个开发者账号，注册Developer账户这里就不详细介绍了。然后自然是将App准备好。确保iOS应用程序已经在模拟器（Simulator）中做了全面的测试确认没有已知Bug了。App发布的工作一切准备好了之后，就可... 查看详情

如何将一个应用程序添加到 App Store，而在这个应用程序中，一个用于 ios7，一个用于其余的？

】如何将一个应用程序添加到AppStore，而在这个应用程序中，一个用于ios7，一个用于其余的？【英文标题】：HowcanIaddoneapptotheAppStoreandinthisappthereisoneforios7andonefortherest?【发布时间】：2013-06-1817:39:30【问题描述】：您好，因为ios7... 查看详情

如何快速的开发一个完整的ios直播app(播放篇)

...看这篇之前，如果您还不了解直播原理，请查看上篇文章如何快速的开发一个完整的iOS直播app(原理篇)开发一款直播app，集成ijkplayer成功后，就算完成直播功能一半的工程了，只要有拉流url，就能播放直播啦本篇主要讲解的是直... 查看详情

mac电脑中的macos.app文件如何运行

...行的应用程序，然后点击该应用程序即可运行。以上就是如何在Mac电脑上运行macOS.app文件的方法，希望能够帮助到您。参考技术AMac电脑中的macOS.app文件可以通过双击来运行，也可以在Finder中搜索“macOS.app”，然后点击它来运行... 查看详情

如何快速的开发一个完整的ios直播app(原理篇)

前言 大半年没写博客了，但我一直关注着互联网的动向，最近会研究很多东西，并分享，今年移动直播行业的兴起，诞生了一大批网红，甚至明星也开始直播了，因此不得不跟上时代的步伐，由于第一次接触的原因，因此花... 查看详情

如何快速的开发一个完整的ios直播app(原理篇)

目录【如何快速的开发一个完整的iOS直播app】(原理篇)【如何快速的开发一个完整的iOS直播app】(播放篇)【如何快速的开发一个完整的iOS直播app】(采集篇)【如何快速的开发一个完整的iOS直播app】(美颜篇)前言大半年没写博客了，... 查看详情

如何在应用程序运行之间本地检测用户的 iPhone 时钟提前？

】如何在应用程序运行之间本地检测用户的iPhone时钟提前？【英文标题】：HowcanIlocallydetectiPhoneclockadvancementbyauserbetweenappruns?【发布时间】：2011-10-3015:15:09【问题描述】：休闲游戏中的一个常见漏洞是人为地提前系统时钟以在游... 查看详情

如何快速的开发一个完整的ios直播app(原理篇)

前言大半年没写博客了，但我一直关注着互联网的动向，最近会研究很多东西，并分享，今年移动直播行业的兴起，诞生了一大批网红，甚至明星也开始直播了，因此不得不跟上时代的步伐，由于第一次接触的原因，因此花了很... 查看详情

如何从组合的 iOS/Watch Xcode 项目中仅将独立的 Apple Watch 应用程序发布到 App Store

】如何从组合的iOS/WatchXcode项目中仅将独立的AppleWatch应用程序发布到AppStore【英文标题】：HowtoreleaseonlyindependentAppleWatchapptoAppStorefromcombinediOS/WatchXcodeproject【发布时间】：2020-12-1304:30:02【问题描述】：我将iOS应用与Watch应用Xcode模... 查看详情

如何在 iOS 7 App 中禁用 iCloud

】如何在iOS7App中禁用iCloud【英文标题】：HowtodisableiCloudiniOS7App【发布时间】：2014-06-0211:57:51【问题描述】：目前我的iOS应用程序支持iCloud备份，因此我的应用程序被AppStore拒绝。我在Xcode的目标部分的功能选项卡中禁用了iCloud选... 查看详情

如何将 socket.io 部署到 Google App Engine？

】如何将socket.io部署到GoogleAppEngine？【英文标题】：HowdoIdeploysocket.iotoGoogleAppEngine?【发布时间】：2016-09-2022:33:03【问题描述】：我使用socket.io创建了我的第一个node.js应用程序。具体来说，我实现了socket.io发布的chatexample。它在本... 查看详情

进程测试

...机制有的不一样。3)app切换到后台，再回到前台时，注意程序是否崩溃，功能状态是否正常，尤其是对于从后台切换回前台数据有自 查看详情

如何将 fortumo In-App purchase 插件集成到 Corona Sdk 游戏中？

】如何将fortumoIn-Apppurchase插件集成到CoronaSdk游戏中？【英文标题】：HowtointegratefortumoIn-ApppurchaseplugintoCoronaSdkgame?【发布时间】：2013-05-3108:50:51【问题描述】：我正在尝试将fortumo应用内购买插件集成到我的游戏中我目前正在关注... 查看详情

linux自有服务-linux从入门到精通第五天

文章大纲一、运行模式二、用户与用户组管理（重点）三、网络设置四、ssh服务（重点）五、学习资料下载六、参考文章 自有服务，即不需要用户独立去安装的软件的服务，而是当系统安装好之后就可以直接使用的服务（内... 查看详情