最新版【微信开发者工具】有毒!慎用!

本公众号由以下老铁赞助,感谢他们❗️

引言

再三确认,最新版本的微信开发者工具 版本号:RC 1.06.2503281 有毒!慎用!

昨天有老铁找到晓衡说,使用最新版本的微信开发者工具,不论是之前打包构建的还是新构建的 Cocos Creator 都报错,还发来截图。

我心头想,怎么又出这种幺蛾子,我前两天才帮一老铁解决《微信小游戏远程加载 zip 资源包》的问题。

像这类问题,自己排查一下不就好了。

最好是先去 Cocos 论坛搜索一下亦或是新建一个干净的 HelloWrold 工程做一下排除。我按这个思路回复这位老铁。

不过,看他的样子,还是很不相信的感觉,我也是跟着往坑里跳,跑去升级了下微信开发者工具。

升级完后,打开一个之前的构建的游戏,确实傻眼了,大片大片的爆红。

遇到报错,首先是要冷静,我将报错的提示在 Cocos 论坛上一搜索,还果真有帖子在讨论。

好些人遇到这个情况,解决办法是:回退微信开发者工具版本。

具体原因是:微信开发者工具开发版(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. 1. 左上角点击【新建构建任务】按钮。

  2. 2. 点击【发布平台】右侧下拉菜框,选择【微信小游戏】平台

  3. 3. 点击【初始场景】右侧下拉菜框,选择【HoemScene】作为启动场景

  4. 4. 其它选项默认即可,我们后面来讲,直接点击底部【构建】按钮。

此时进入【wechatgame】的打包过程中,首次会慢一点,但当前这个项目较小在我的电脑上20内秒就能构建完成。

这里多说一句,项目构建的过程,是将当前项目【资源管理器】中的代码、图片、动画、预制体、场景等按一定的规则重新组织文件名与目标结构,过程中或对脚本的编译、或压缩、或添加构建目标平台的适配等等。

构建完成在【构建任务】列表【wechatgame】中点击左下【打开】按钮,如图:

打击按钮,会弹出操作系统的资源管理窗口,注意构建出的项目默认路径:

  1. 1. 构建项目路径为:“.../工程目录/build/wechatgame”;

  2. 2. 通过微信小游戏官方文档可知道:game.json、game.js、project.config.json、project.private.json 是微信小游戏的项目文件;

  3. 3. assets目录为构建后的资源目录,以图片、音效、JSON配置等文件为主,文件名已经完全面目全非(引擎中使用 UUID 全局唯一标识码进行名命管理);

    4. cocos-js引擎目录,包含构建后的核心模块及子模块,是这些文件为你提供Cocos运行时环境;

  4. 5. 其它为引擎适配、启动加载、资源索引等文件。

现在游戏已经打成生成微信小游戏了,现在我们来运行看看,这时就要祭出【微信开发者工具】了。但先别慌,先在 Cocos Creator 引擎中来配置一下,看下图:

  1. 1. 引擎主菜单点击【偏好设置】

  2. 2. 在【偏好设置】面板左侧边栏点击【程序管理器】

  3. 3. 【程序管理器】页面最底部设置【微信开发者工具】的路径,Mac系统指向 .app 应用目录,Windows指向 .exe 文件。

回到之前的构建发布面板,在【wechatgame】构建任务,右下方点击【运行】按钮。

如果你是首次在Cocos引擎中启动【微信开发者工具】,肯定出现如下的报错。

很多人一遇到报错,就慌了,报错提示也不看。其实很简单,着提示操作就行。

02  微信小游戏开发者工具

首次启动【微信开发者工具】会要求使用微信扫码登录。

如果你不想登录,也可以使用游客模式,但使用游客模式无法将游戏运行在手机上预览。

扫码登录,点击【微信开发者工具】→【设置】→【服务端口】项开关设置为开启。

这时完全退出【微信开发者工具】,再回到 CocosCreator 引擎编辑器上,构建发布面板点击【运行】。如果这时【微信开发者工具】成功出现游戏画面+调试窗口,恭喜您!

但以上操作,还是有可能无法在【微信开发者工具】上启动游戏,这时就需要手动进行导入,操作如下:

  1. 1. 【微信开发者工具】点击左侧边栏【小游戏】选项卡

  2. 2. 在切换出现的【小游戏】项目页面点击+号区域,也可以点击右上方向的【导入】文字

  3. 3. 在出现的导入项目界面,目录一项浏览至我们刚在 Cocos Creator 中构建生成的wechatgame 目录,路径为【xxx/项目/build/wechatgame】

  4. 4. 点击,不使用云服务。

这时你点击右下放的【确定】按钮,大概率还会出现问题:AppID不正确的错误。

这时,你需要输入使用你扫码登录的微信号申请的微信小游戏AppID。如果没有也没关系,点击蓝色文字:点此返回填写 AppID,然后在变化的文字中选择使用测试号,见下图:

点击后会自动填写上AppID,需要注意,每个人的测试AppID是不同的。

此时点击【确定】按钮,出现如下界面,点击信任并运行即可。

至此我们将游戏运行在了【微信开发者工具】的模拟器上。

03  在手机微信中预览游戏

我猜,你已经迫不及待地想将游戏运行在微信小游戏上了,在【微信开发者工具】工具栏上点击【预览】按钮。

你会看到【微信开发者工具】经过一阵编译、打包、上传...咣!报错了,提示资源包太大了,超过了4M 不能上传。之前这个项目 2.x 时包体是不会超过 4M 也就是 4096KB,现在是 4794KB 整整大了700KB。

先不急,我们只是预览运行,可将分包体积上限调整为8M。只需要按下面操作:

1.【微信开发者工具】点击详情;
2. 在弹出的右边栏窗口中,选择【本地设置】在下方勾选【预览及真机调试时主包、分包体积上限调整为8M】;
3. 修改配置游戏会重新刷新,这时再点击预览就可以了。

使用你当前登录【微信开发者工具】的微信号扫描二码试试。

你搞定了吗?搞定的记得在评论区留言,也可以在群里晒给大家看下。

04  构建注意事项

接下来,我们回到Cocos Creator引擎,看看几个关于微信小游戏的构建选项。

  1. 1. 设备方向:竖屏、横屏只要是手机上的应用都会有这个设置;

  2. 2. AppId:微信小游戏的AppID,在这里配置后就不用每次重新构建在微信开发者工具中修改了;

  3. 3. 生成开放数据域工程模板:这是用于生成微信好友排行榜的特殊工程,微信好友头像、昵称地理位置等属于用户个人隐私,只能在开放数据域中完成,且不能保存或调用网络。本专栏不涉及该部分内容;

  4. 4. 引擎原生代码(wasm/asmjs)分包:将引擎原生代码做为分引擎,减少主包大小,加快首场景的加载速度;

  5. 5. 启用微信引擎插件(分享引擎):勾选后可以进一步减小包体,使用微信全局缓存中的Cocos Creator引擎库,前提是你的项目没有定制过引擎源码;

  6. 6. 调性能模式:提升 iOS 高性能模式,微信小游戏官方提供的一个开关,游戏没做好内存优化,不建议开启高性能模式,默认为关闭。

要知道微信小游戏的每个主包及分包,都不能超过4M,发下是微信小游戏官方文档。

资源包超过4M怎么办呢?小游戏包体优化,是从项目一开始就需要特别关注的问题,有机会再我们再介绍关于:纹理压缩、引擎裁剪、远程包等方案来降低包体体积。

今天的分享就到这里,感谢点赞再看,下见次!


 以下是广告请按需享用 

像使用 PPT 一样,学会使用 Cocos Creator 引擎编辑器、多平台打包构建、游戏换皮、常用内置组件的使用,以及广告SDK通用组件拿来就用。

为此,晓衡准备换个姿势帮助『非游戏开发者』快速入门 Cocos 游戏开发!

换个姿势入门Cocos游戏开发》小报童专栏,原价¥199,首发¥19.9 每满百人涨价!晓衡计划保底不低于50篇内容。目前已更新34篇, 并开启合伙人计划(60%分销) 一 起实践,游戏开发, 副业 变 现!

Image

下面是两篇免费试读章节:

  • 《入门篇 | 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

Image

专栏教程配套源码请加小助手微信 tddrap 领取!

根据引用内容,你在将Cocos Creator项目打包到微信开发者工具时遇到了"app.json 文件内容错误"的报错。这个错误通常是由于项目根目录下缺少或者无法读取到app.json文件导致的。解决这个问题的具体步骤如下: 1. 首先,确认你的项目根目录下是否存在app.json文件。如果不存在,你需要手动创建一个app.json文件,并确保文件名和大小写都正确。 2. 如果app.json文件已经存在,那么可能是文件内容出现了错误。你可以打开app.json文件,检查其中的内容是否正确。确保文件中的每个字段都是有效的,并且没有任何语法错误。 3. 如果你不确定app.json文件应该包含哪些内容,可以参考Cocos Creator官方文档或者其他可靠的资源,查找正确的app.json文件模板。根据你的项目需求,适当地修改app.json文件的内容。 4. 修改完app.json文件后,保存并重新运行项目。如果仍然出现相同的报错,可能是文件读取失败导致的。你可以尝试重新打开微信开发者工具,或者重新构建项目并将其导入到微信开发者工具中。 总结一下,解决"app.json 文件内容错误"的报错的步骤如下: 1. 确认项目根目录下是否存在app.json文件,如果不存在则手动创建一个。 2. 检查app.json文件的内容是否正确,确保每个字段都是有效的。 3. 参考官方文档或其他资源,查找正确的app.json文件模板,并根据项目需求进行修改。 4. 保存并重新运行项目,如果问题仍然存在,尝试重新打开微信开发者工具或重新构建项目。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值