搜索
暂无数据
小游戏编译工具使用说明更新时间: 2024-09-27 14:16:00

一、包结构

├── 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'][...]

其中[]可以省略

序号keyValue
1path项⽬目⽣生成的⽬目录
2package包名
3versionName版本名称
4versionCode版本号
5miniPlatformVersion最⼩小平台号
6iconIcon图⽚片地址
7name应⽤用名称


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 同时打开了多个调试界⾯

解决⽅式:关闭其他相关的应⽤程序,只保留⼀个小游戏应⽤程序



上一篇:
下一篇: