一、包结构
├── sign rpk包签名模块
│ └── debug 调试环境
│ ├── certificate.pem 证书文件
│ └── private.pem 私钥文件
│ └── release 线上环境
│ ├── certificate.pem 证书文件
│ └── private.pem 私钥文件
├── logo.png 游戏图标(非必须)
├── sub1 子包目录(非必须)
│ └── main.js 子包入口js
├── sub2.js 子包js(非必须)
├── main.js 游戏入口js
└── manifest.json 项目配置文件,配置游戏图标、包名等
二、小游戏配置
{
"package": "com.minigame.demo", 快游戏包名
"name": "mini game", 快游戏名称
"icon": "/image/logo.png", 快游戏icon
"versionName": "1.0.0", 快游戏版本
"versionCode": 1, 快游戏版本号,int 类型
"minPlatformVersion": 2000, 最小支持版本,int 类型
"orientation": "portrait", 不填或默认值为portrait,对快应用无效。取值为portrait或landscape
"type": "game", 不填或默认值为app,取值为app或game
"config"": {
"logLevel": "log" logLevel取值off,error,warn,info,log,debug,trace
},
subpackages: [ 分包配置
{
"name": "sub1Name", 子包名称
"root": "sub1/" 可以指定一个目录,目录根目录下的 main.js 会作为入口文件
},
{
"name": "sub2Name", 子包名称
"root": "sub2.js" 也可以指定一个 JS 文件
}
]
}
三、打包命令
1、安装环境
安装nodejs,推荐使⽤8.1.4+版本,升级npm 到5.2.0+
升级npm 命令:npm install npm@latest –g
2、初始化项⽬
2.1、执⾏命令: npx create-quickgame projectName
拷⻉小游戏编译所需配置⽂件 manifest.json 、资源⽂件到项⽬根⽬录
在初始化项⽬的时候可以传递⼀些参数
npx create-quickgame projectName [path='/User/ruby/quickgame']
[package='com.app.demo'][...]
其中[]可以省略
序号 | key | Value |
1 | path | 项⽬目⽣生成的⽬目录 |
2 | package | 包名 |
3 | versionName | 版本名称 |
4 | versionCode | 版本号 |
5 | miniPlatformVersion | 最⼩小平台号 |
6 | icon | Icon图⽚片地址 |
7 | name | 应⽤用名称 |
2.2、举例说明:
npx create-quickgame demo path="/User/ruby/quickgames" package="com.app.demo.mi"
versionName="1.0" versionCode=1 miniPlatformVersion=1000
icon="/images/logo.gif" name="小游戏"
注意:每组[key=value]之间的空格分割
3、编译rpk
执⾏命令: npm run build 在项⽬的dist⽬录编译得到debug包
执⾏命令: npm run release 在项⽬的dist⽬录编译得到release包(release包需要release签
名: ⽣成release签名)
4、启动服务Server
执⾏命令: npm run server 使⽤⼿机安装的调试器 扫码体验
端⼝占⽤情况处理: npm run server -- --port 4000 使⽤指定端⼝4000
四、调试服务
1、环境要求
chrome浏览器
2、启动调试服务
打开游戏运⾏界⾯
⼿机 USB 连接到 PC
执⾏命令: npm run debug 会在chrome浏览器中⾃动启动调试界⾯
如果希望⼿动打开调试界⾯: npm run debug -- --print-only 将命令⾏中的 Debugger
URL 地址粘贴到chrome浏览器中打开
[注]:严格按照先运⾏游戏再启动调试功能的先后顺序
五、常⻅问题
1、npm install 安装失败
解决⽅式:执⾏ npm cache clean --force 清除npm缓存造成的影响
2、执⾏ npm run debug 同时打开了多个调试界⾯
解决⽅式:关闭其他相关的应⽤程序,只保留⼀个小游戏应⽤程序