本地活动资源服务
在项目根目录运行 npm run serve:activities,默认只监听本机 127.0.0.1:8780。
也可运行 node tools/serve-activity-resources.cjs 8781 指定其他端口。前台启动时按 Ctrl+C 停止。
构建流程保持不变。构建后,手动将 build/wechatgame-activities/remote/ 中要测试的文件复制到本目录的 remote/,保留目录结构:
local-activity-resources/
remote/
manifest.json
pyramid/
pyramid.<SHA-256>.zip
- 清单地址:
http://127.0.0.1:8780/remote/manifest.json - 分包地址:
http://127.0.0.1:8780/remote/pyramid/pyramid.<SHA-256>.zip - 先放 ZIP,后放引用它的清单;文件名和哈希使用构建产物中的真实值,不手动改写哈希。
- 覆盖文件后立即生效,不需要重启服务。未放入文件时返回 404,不生成示例清单。
- 服务只读取指定目录的 JSON 和 ZIP,不上传、修改或解压文件。资源副本不纳入 Git。
让微信开发者工具使用本地服务
构建完成后,手动编辑本次测试代码包的 build/wechatgame/activity-bundles-config.js,只将 baseUrl 改为:
module.exports = {
baseUrl: "http://127.0.0.1:8780/remote/",
bundles: ["pyramid"]
};
保留该文件原有的 bundles 名单。下一次构建会重新生成此文件,测试时需再次修改。
不要将 Creator 正式资源服务器配置改成本机 HTTP 地址:现有构建工具仍按 HTTPS CDN 地址生成发布配置。
开发者工具的本地 HTTP 调试需要允许本地请求(若被域名校验拦截,检查工具中的“不校验合法域名、web-view(业务域名)、TLS 版本以及 HTTPS 证书”调试选项);本服务不会修改开发者工具设置。
改完地址后重新编译/启动小游戏。之后更换资源,可重新进入首页或切回前台触发新的清单检查;持续停留首页不会轮询。
不同资源服务器地址使用独立缓存,本地服务不会覆盖 CDN 缓存。服务仅用于这台电脑的本地测试,手机上的 127.0.0.1 不指向电脑。
确认后上传同一份 ZIP,再更新 CDN 清单。正式发布前重新构建或恢复代码包中的 CDN baseUrl。