Files
2026-10-12 15:00:49 +08:00
..
2026-10-12 15:00:49 +08:00
2026-10-12 15:00:49 +08:00

本地活动资源服务

在项目根目录运行 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。