本公众号由以下老铁赞助,感谢他们❗️
引言
再三确认,最新版本的微信开发者工具
版本号:RC 1.06.2503281 有毒!慎用!
昨天有老铁找到晓衡说,使用最新版本的微信开发者工具,不论是之前打包构建的还是新构建的 Cocos Creator 都报错,还发来截图。
我心头想,怎么又出这种幺蛾子,我前两天才帮一老铁解决《微信小游戏远程加载 zip 资源包》的问题。
像这类问题,自己排查一下不就好了。
最好是先去 Cocos 论坛搜索一下亦或是新建一个干净的 HelloWrold 工程做一下排除。我按这个思路回复这位老铁。
不过,看他的样子,还是很不相信的感觉,我也是跟着往坑里跳,跑去升级了下微信开发者工具。
升级完后,打开一个之前的构建的游戏,确实傻眼了,大片大片的爆红。
好些人遇到这个情况,解决办法是:回退微信开发者工具版本。
具体原因是:微信开发者工具开发版(Nightly),破坏了 readFile 接口读取二进制文件的兼容性,请用最新的微信开发者工具稳定版。
我将 Cocos 论坛上这个帖子转给这位老铁,果然很快他就解决问题。
最近,关于微信小游戏的问题还真不少,而且还有不少同学是第一次接触 Cocos Creator 开发微信小游戏。
他们对微信小游戏的开流程、概念、术语、规则还不太了解,急于开干,想看到游戏能跑在手机微信上,而且还能分享给朋友玩。
在此分享一篇 Cocos Creator 微信小游戏构建打包流程,希望能帮助到你。
01 构建微信小游戏资源包
将一款 Cocos Creator 项目构建运行在微信小游戏上,它包含【微信开发者工具】与【手机微信】这两个必备工具,请先下载安装【微信开发者工具】如图:
• 下载地址:
https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html
首先回到 Cocos Creator 引擎编辑器,打开《消消大冒险》项目(你也可以到Cocos Store 上下载任意免费游戏)点击【主菜单】→【项目】→【构建发布】。
在弹出的【构建发布】窗口,如图操作:
1. 左上角点击【新建构建任务】按钮。
2. 点击【发布平台】右侧下拉菜框,选择【微信小游戏】平台
3. 点击【初始场景】右侧下拉菜框,选择【HoemScene】作为启动场景
4. 其它选项默认即可,我们后面来讲,直接点击底部【构建】按钮。
此时进入【wechatgame】的打包过程中,首次会慢一点,但当前这个项目较小在我的电脑上20内秒就能构建完成。
这里多说一句,项目构建的过程,是将当前项目【资源管理器】中的代码、图片、动画、预制体、场景等按一定的规则重新组织文件名与目标结构,过程中或对脚本的编译、或压缩、或添加构建目标平台的适配等等。
构建完成在【构建任务】列表【wechatgame】中点击左下【打开】按钮,如图:
打击按钮,会弹出操作系统的资源管理窗口,注意构建出的项目默认路径:
1. 构建项目路径为:“.../工程目录/build/wechatgame”;
2. 通过微信小游戏官方文档可知道:game.json、game.js、project.config.json、project.private.json 是微信小游戏的项目文件;
3. assets目录为构建后的资源目录,以图片、音效、JSON配置等文件为主,文件名已经完全面目全非(引擎中使用 UUID 全局唯一标识码进行名命管理);
4. cocos-js引擎目录,包含构建后的核心模块及子模块,是这些文件为你提供Cocos运行时环境;
5. 其它为引擎适配、启动加载、资源索引等文件。
现在游戏已经打成生成微信小游戏了,现在我们来运行看看,这时就要祭出【微信开发者工具】了。但先别慌,先在 Cocos Creator 引擎中来配置一下,看下图:
1. 引擎主菜单点击【偏好设置】
2. 在【偏好设置】面板左侧边栏点击【程序管理器】
3. 【程序管理器】页面最底部设置【微信开发者工具】的路径,Mac系统指向 .app 应用目录,Windows指向 .exe 文件。
回到之前的构建发布面板,在【wechatgame】构建任务,右下方点击【运行】按钮。
如果你是首次在Cocos引擎中启动【微信开发者工具】,肯定出现如下的报错。
很多人一遇到报错,就慌了,报错提示也不看。其实很简单,着提示操作就行。
02 微信小游戏开发者工具
首次启动【微信开发者工具】会要求使用微信扫码登录。
如果你不想登录,也可以使用游客模式,但使用游客模式无法将游戏运行在手机上预览。
扫码登录,点击【微信开发者工具】→【设置】→【服务端口】项开关设置为开启。
这时完全退出【微信开发者工具】,再回到 CocosCreator 引擎编辑器上,构建发布面板点击【运行】。如果这时【微信开发者工具】成功出现游戏画面+调试窗口,恭喜您!
但以上操作,还是有可能无法在【微信开发者工具】上启动游戏,这时就需要手动进行导入,操作如下:
1. 【微信开发者工具】点击左侧边栏【小游戏】选项卡
2. 在切换出现的【小游戏】项目页面点击+号区域,也可以点击右上方向的【导入】文字
3. 在出现的导入项目界面,目录一项浏览至我们刚在 Cocos Creator 中构建生成的wechatgame 目录,路径为【xxx/项目/build/wechatgame】
4. 点击,不使用云服务。
这时你点击右下放的【确定】按钮,大概率还会出现问题:AppID不正确的错误。
这时,你需要输入使用你扫码登录的微信号申请的微信小游戏AppID。如果没有也没关系,点击蓝色文字:点此返回填写 AppID,然后在变化的文字中选择使用测试号,见下图:
点击后会自动填写上AppID,需要注意,每个人的测试AppID是不同的。
此时点击【确定】按钮,出现如下界面,点击信任并运行即可。
至此我们将游戏运行在了【微信开发者工具】的模拟器上。
03 在手机微信中预览游戏
我猜,你已经迫不及待地想将游戏运行在微信小游戏上了,在【微信开发者工具】工具栏上点击【预览】按钮。
你会看到【微信开发者工具】经过一阵编译、打包、上传...咣!报错了,提示资源包太大了,超过了4M 不能上传。之前这个项目 2.x 时包体是不会超过 4M 也就是 4096KB,现在是 4794KB 整整大了700KB。
先不急,我们只是预览运行,可将分包体积上限调整为8M。只需要按下面操作:
1.【微信开发者工具】点击详情;
2. 在弹出的右边栏窗口中,选择【本地设置】在下方勾选【预览及真机调试时主包、分包体积上限调整为8M】;
3. 修改配置游戏会重新刷新,这时再点击预览就可以了。
使用你当前登录【微信开发者工具】的微信号扫描二码试试。
你搞定了吗?搞定的记得在评论区留言,也可以在群里晒给大家看下。
04 构建注意事项
接下来,我们回到Cocos Creator引擎,看看几个关于微信小游戏的构建选项。
1. 设备方向:竖屏、横屏只要是手机上的应用都会有这个设置;
2. AppId:微信小游戏的AppID,在这里配置后就不用每次重新构建在微信开发者工具中修改了;
3. 生成开放数据域工程模板:这是用于生成微信好友排行榜的特殊工程,微信好友头像、昵称地理位置等属于用户个人隐私,只能在开放数据域中完成,且不能保存或调用网络。本专栏不涉及该部分内容;
4. 引擎原生代码(wasm/asmjs)分包:将引擎原生代码做为分引擎,减少主包大小,加快首场景的加载速度;
5. 启用微信引擎插件(分享引擎):勾选后可以进一步减小包体,使用微信全局缓存中的Cocos Creator引擎库,前提是你的项目没有定制过引擎源码;
6. 调性能模式:提升 iOS 高性能模式,微信小游戏官方提供的一个开关,游戏没做好内存优化,不建议开启高性能模式,默认为关闭。
要知道微信小游戏的每个主包及分包,都不能超过4M,发下是微信小游戏官方文档。
资源包超过4M怎么办呢?小游戏包体优化,是从项目一开始就需要特别关注的问题,有机会再我们再介绍关于:纹理压缩、引擎裁剪、远程包等方案来降低包体体积。
今天的分享就到这里,感谢点赞再看,下见次!
以下是广告请按需享用
像使用 PPT 一样,学会使用 Cocos Creator 引擎编辑器、多平台打包构建、游戏换皮、常用内置组件的使用,以及广告SDK通用组件拿来就用。为此,晓衡准备换个姿势帮助『非游戏开发者』快速入门 Cocos 游戏开发!
下面是两篇免费试读章节:
《入门篇 | 02 构建你的第一个H5游戏》
https://xiaobot.net/post/81a06aa8-8fe0-4f03-9004-09698621e6ad
《入门篇 | 04 引擎编辑器—资源管理》
https://xiaobot.net/post/ba0e6815-7209-4553-8e5f-d59f03bb6647
《基础篇 | 02 将游戏运跑在微信小游戏上》
https://xiaobot.net/post/53a4af47-74f0-4c97-b084-175ab1886fd9
专栏教程配套源码请加小助手微信 tddrap 领取!