Files
engine/docs/zh/platform/wechatMiniGame.mdx
2025-02-10 11:09:40 +08:00

75 lines
3.9 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
order: 2
title: 导出到微信小游戏
type: 多平台导出
label: Platform
---
## 平台配置说明
在导出到微信小游戏平台的时候,有以下这些配置项:
<Image src="https://mdn.alipayobjects.com/huamei_w6ifet/afts/img/A*natiS7i3cvUAAAAAAAAAAAAADjCHAQ/fmt.webp" />
| 配置 | 描述 | 对应到微信小游戏的配置文件 | 对应到微信小游戏中的字段
| ------------- | ------------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| AppId | 微信小游戏的 AppId必填截图中的 wxdf8199565c509fb9 为测试账号 | project.config.json | appid |
| Orientation | 设置游戏屏幕方向: Landscape横屏、Portrait竖屏| game.json | deviceOrientation |
| Request | wx.request 的超时时间,单位:毫秒 | game.json | networkTimeout.request |
| Connect Socket | wx.connectSocket 的超时时间,单位:毫秒 | game.json | networkTimeout.connectSocket |
| Upload File | wx.uploadFile 的超时时间,单位:毫秒 | game.json | networkTimeout.uploadFile |
| Download File | wx.downloadFile 的超时时间,单位:毫秒 | game.json | networkTimeout.downloadFile |
更多配置详见:[project.config.json](https://developers.weixin.qq.com/minigame/dev/devtools/projectconfig.html)、[game.json](https://developers.weixin.qq.com/minigame/dev/reference/configuration/app.html)
## 导出
选择好微信小游戏平台后,点击导出面板最下方的下载按钮,即可导出所需工程:
<Image src="https://mdn.alipayobjects.com/huamei_w6ifet/afts/img/A*a1-PQIsWlgIAAAAAAAAAAAAADjCHAQ/fmt.webp" />
## 调试
1、工程导出到本地后先进入到根目录执行以下命令进行依赖包的安装
```bash
npm i
```
2、打开**微信开发者工具** ,选择小游戏,并导入刚才的工程,如下:
<Image src="https://mdn.alipayobjects.com/huamei_w6ifet/afts/img/A*gCnXSqRgLnMAAAAAAAAAAAAADjCHAQ/fmt.webp" />
3、在微信开发者工具中点击**工具->构建 npm**,如下:
<Image src="https://mdn.alipayobjects.com/huamei_w6ifet/afts/img/A*G5aBQKNFdV8AAAAAAAAAAAAADjCHAQ/fmt.webp" />
4、完成上述 3 后,即可在微信开发者工具中预览最终的结果,如下:
<Image src="https://mdn.alipayobjects.com/huamei_w6ifet/afts/img/A*JyoIS54k3uYAAAAAAAAAAAAADjCHAQ/fmt.webp" />
5、在微信开发者工具中的调试详见[微信小游戏调试](https://developers.weixin.qq.com/minigame/dev/guide/runtime/debug/)
## 发布
本地完成调试后,即可进行发布,具体发布流程详见:[微信小游戏发布](https://developers.weixin.qq.com/minigame/introduction/guide/)
## 导出工程目录说明
导出到本地的工程目录如下:
<Image src="https://mdn.alipayobjects.com/huamei_w6ifet/afts/img/A*3jBDQYE5T9AAAAAAAAAAAAAADjCHAQ/fmt.webp" style={{zoom: "50%"}} />
**工程目录说明**
|目录或文件|说明|
|-------------|-------------|
|adapters|项目用到的引擎相关的包,按需导出|
|public|资产目录,编辑器所有资产导出到这个目录下,资产的 path 为 /public/xxx|
|scripts|开发者在编辑器中添加的脚本组件,导出到本地后,开发者可以在里面的脚本组件中进行二次开发|
|game.json|对应微信小游戏工程所需要的 [game.json](https://developers.weixin.qq.com/minigame/dev/reference/configuration/app.html)|
|game.ts|入口文件,初始化的逻辑都放在这里|
|package.json|主要存放项目依赖包|
|polyfill.js|平台 DOM 适配代码和全局变量适配代码,开发者无需关心|
|project.config.json|对应微信小游戏工程所需要的 [project.config.json](https://developers.weixin.qq.com/minigame/dev/devtools/projectconfig.html)|
|project.ts|Galacean 的工程文件,在初始化的时候会解析|