search
开发文档
开发文档/小游戏开发/开发指南/目录结构/项目目录
项目目录更新时间:2025-12-16 16:20:00

一、rpk简介

1.什么是rpk

rpk是小游戏领域定义的标准包体格式,包含游戏的代码、资源(图片、音频等)、配置文件等。小游戏主打 “即点即玩”,rpk 包体通常体积较小(远小于传统手游安装包),加载速度快,适合在手机浏览器、应用商店或厂商的小游戏中心分发。开发者使用 Unity, Cocos 等引擎开发小游戏,通过厂商提供的打包工具将项目打包为 rpk 文件。
具体的rpk结构说明可参看文档分包目录及大小限制

2.为什么要按照标准的小游戏工程规则组织游戏工程文件

按照标准的小游戏工程规则组织文件,是确保游戏能在平台正常运行、高效开发和顺利发布的关键,小游戏平台有严格的运行限制,例如:

  • 固定的入口文件main.js
  • 配置文件格式(如manifest.json中定义游戏包名、分包规则、最小平台版本号等)
  • 分包目录规范,需要与manifest.json配置文件中配置的路径对齐

同时,标准结构是行业通用的 “语言”,能降低开发和协作成本,新成员加入项目时,可快速通过标准目录(如 src/ 放代码、assets/ 放资源)理解工程逻辑,无需重新熟悉自定义结构,当游戏出现 bug(如资源加载失败、功能异常)时,标准结构也能快速缩小排查范围。

二、标准小游戏工程目录

各大引擎构建出的小米小游戏均与以下标准的小米小游戏工程保持一致,不同引擎的构建产物可能会有一些文件上的差异,但是核心工程目录和文件是一致的,如下说明:

├── build                      打包时的临时产出
├── dist 存放打包生成的rpk包
│ └── com.xxx.xxx.signed.rpk 小游戏rpk包
├── 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.json Node.js 项目中的核心配置文件,用于描述项目的基本信息、依赖关系、脚本命令等

详细的关于manifest.json文件内容的说明可参看文档manifest配置及须知

上一篇:更新日志
下一篇:manifest配置及须知
文档内容是否有帮助?
有帮助
无帮助