一、接入前须知

1.平台准入要求

接入游戏前请阅读接入及上架指南了解平台接入规则并提前做好准备。

2.快应用服务框架简介

快应用服务框架是系统内置的一种特殊应用，所有小游戏与快应用都在其中运行。 该框架每月都会进行版本更新，并内置了三种运行环境：

• unity runtime
• cocos runtime
• webview

由于runtime环境下游戏启动更快，游戏画质更高，因此目前推荐开发者升级runtime；如不升级，依然可以使用webview环境运行，两种打包方式介绍详见：打包介绍。

小米后台会根据游戏情况自动选择合适的运行模式，线上配置生效策略如下：

3.熟悉快应用框架设置项

开发者在进行真机调试时可能会需要切换运行的环境、设置开启调试模式或者使用vConsole等，需要在设置中进行设置，入口路径为：在设置中搜索“快应用服务框架”点击进入 --> 多次点击关于展开隐藏项
若需要手动切换运行环境，可以在下方游戏引擎模式区域进行点击切换选择使用Unity Runtime, Cocos Runtime或者Webview环境运行游戏。若调试时需要使用vConsole插件查看日志，请打开“vConsole”开关：

注意事项：1312版本以上的快应用框架需要在调试器设启动参数去切换运行环境和打开VConsole模式：
*示例：engineType=cocos&useVConsole=true&waitingDebugger=false
游戏的运行环境类型的取值范围为：unity、cocos、webview

• webview包：需要在webview环境调试
• runtime包：
• cocos游戏：需要在cocos环境调试
• 其他游戏：需要在unity环境调试

二、系统与依赖环境

1.安装Node.js

需要安装Node.js环境，建议安装node16及以上版本的NodeJS，请从NodeJS官网下载安装包进行安装，按照安装器的指引进行安装即可，安装完成后在命令行工具输入node -v，会打印出node版本，则安装成功。

2.安装快应用服务框架

小游戏的运行依赖快应用服务框架，因此需要确保用来进行游戏调试的手机上安装了版本较新版本的快应用服务框架，推荐使用大于等1308版本，框架有三种更新方式：

• 方法一：打开手机应用商店，点击“我的-->应用升级-->快应用服务框架”，看是否有可用更新
• 方法二：部分机型较老，已退出维护名单，无法使用应用商店更新，需手动下载安装。下载后使用USB连上手机并确保adb工具连上，然后在电脑命令行工具调用adb install -t {下载下来的.apk文件路径}进行安装，较新的版本安装时会自动覆盖老版本。在这一步如果安装时提示安装的版本比现版本老，无法安装，可以先执行命令adb uninstall com.miui.hybrid卸载原手机上的快应用服务框架然后再进行安装
• 方法三：直接在手机浏览器中打开下载地址，然后点击对应快应用服务框架版本下的“下载”按钮，手机上会自动弹出一个弹窗，点击“快应用服务框架”旁的升级按钮即可升级安装
  下载地址：快应用服务框架

安装完成后可以在调试工具中看到快应用服务框架的版本号，也可以在设置中搜索“快应用服务框架”查看，如图：

三、开发工具安装

1.安装引擎IDE

若需了解详细的下载、安装及使用方法请参考各引擎官方网站，以下为常用引擎官网地址：

2.安装adb工具

因为真机调试需要使用到adb(Android Debug Bridge)工具与电脑建立通信，这样才能在电脑上查看日志，同时，快应用框架和调试器的安装也会用到adb，所以推荐本地没有adb工具的开发者安装一个adb工具。
前往adb官网进行下载，然后跟随安装指引进行安装即可，安装后在终端执行命令adb即出现adb相关的信息如下图所示，则证明已经安装完成：

注：执行adb devices进行adb连接时，可能会出现卡住没反应的情况，此为正常情况，有可能是因为端口占用问题，可以执行taskkill /F /IM adb.exe将所有adb旧进程清理之后重试，经常连不上也可能是因为adb版本太老，需经常更新adb版本。

3.安装调试器

在游戏开发完成后需要使用调试器进行真机游戏调试，因此需要下载安装调试工具至测试机，调试器下载地址。
调试器是一个手机App，下载下来为一个.apk安装包，可以将安装包放至测试机中某个方便寻找的目录，然后点击.apk安装包进行安装即可，或者使用usb连接后使用adb install {安装包路径}进行安装。
调试器打开后界面见下图，注意上方tab要在应用模式，不要切换到卡片模式。