跳转到内容
搜索文档

2. 更新到 Wrangler v2

最后更新 查看 MarkdownAgent 设置

本文档描述将项目从 Wrangler v1 迁移到 Wrangler v2 的步骤。在更新 Wrangler 版本之前,如果适用于你的项目,请先查看并完成从 Wrangler 版本 1 迁移 webpack 项目

Wrangler v2 附带新功能和改进,可能需要对配置进行一些更改。

CLI 本身将引导你完成升级过程。

更新 Wrangler 版本

1. 卸载 Wrangler v1

如果你之前使用 npm 全局安装了 Wrangler v1,可以用以下命令卸载:

npm uninstall -g @cloudflare/wrangler

如果你使用 Cargo 安装了 Wrangler v1,可以用以下命令卸载:

cargo uninstall wrangler

2. 安装 Wrangler

现在,安装最新版本的 Wrangler。

npm install -g wrangler

3. 验证安装

要检查是否安装了正确的 Wrangler 版本,请运行:

npx wrangler --version

在之前的项目上测试 Wrangler v2

现在你将测试 Wrangler v2 能否构建你的 Wrangler v1 项目。在大多数情况下,它可以正常构建。如果有错误,命令行会准确指示你需要更改什么才能成功构建。

如果你想了解更多导致 Wrangler v2 报错的已弃用 Wrangler 配置文件 字段,请参阅已弃用

运行 wrangler dev 命令。这将显示需要处理的任何警告或错误。 请注意,在大多数情况下,消息将包含可操作的说明,告诉你如何解决该问题。

npx wrangler dev
  • 错误需要在 Wrangler 构建 Worker 之前修复。
  • 在大多数情况下,你只会看到警告。 这些不会阻止 Wrangler 构建 Worker,但请考虑更新配置以消除它们。

以下是一些警告和错误的示例:

 ⛅️ wrangler 2.x
-------------------------------------------------------
 [WARNING] Processing wrangler.toml configuration:
  - 😶 Ignored: "type":
    Most common features now work out of the box with wrangler, including modules, jsx,
  typescript, etc. If you need anything more, use a custom build.
  - Deprecation: "zone_id":
    This is unnecessary since we can deduce this from routes directly.
  - Deprecation: "build.upload.format":
    The format is inferred automatically from the code.


 [ERROR] Processing wrangler.toml configuration:
  - Expected "route" to be either a string, or an object with shape { pattern, zone_id | zone_name }, but got "".

已弃用

有关不再支持的内容的更多详情,请参阅已弃用

这篇文档对您有帮助吗?