从 0.5 迁移到 0.6

@opennextjs/cloudflare@0.6.0 引入了更多的缓存选项。

代码库经过了重构并包含一些破坏性变更，请继续阅读以更新您的应用：

覆盖位置

Cloudflare 覆盖文件现在位于 @opennextjs/cloudflare/overrides：

• 增量缓存覆盖：@opennextjs/cloudflare/overrides/incremental-cache/...
• 标签缓存覆盖：@opennextjs/cloudflare/overrides/tag-cache/...
• 队列覆盖：@opennextjs/cloudflare/overrides/queue/...

例如，KV 增量缓存覆盖现在可以导入为 @opennextjs/cloudflare/overrides/incremental-cache/kv-incremental-cache。

环境变量和绑定

为了保持一致性，我们更新了名称：

• NEXT_CACHE_WORKERS_KV -> NEXT_INC_CACHE_KV
• NEXT_CACHE_R2_... -> NEXT_INC_CACHE_R2_...
• NEXT_CACHE_D1 -> NEXT_TAG_CACHE_D1
• NEXT_CACHE_DO_... -> NEXT_TAG_CACHE_DO_...
• NEXT_CACHE_DO_REVALIDATION -> NEXT_CACHE_DO_QUEUE
• NEXT_CACHE_REVALIDATION_WORKER -> WORKER_SELF_REFERENCE

NEXT_CACHE_D1_TAGS_TABLE 和 NEXT_CACHE_D1_REVALIDATIONS_TABLE 已被移除。 D1 表现在具有固定的名称 tags 和 revalidations。

命令行界面

CLI 以前通过 opennextjs-cloudflare 调用，现在需要必填的命令：

• opennextjs-cloudflare build 等同于以前执行 opennextjs-cloudflare
• opennextjs-cloudflare populateCache local 用于填充 local 或 remote 缓存
• opennextjs-cloudflare preview 用于填充本地缓存并启动开发服务器
• opennextjs-cloudflare deploy 用于填充远程缓存并部署

您需要更新 package.json 中的 scripts：

"preview": "opennextjs-cloudflare build && opennextjs-cloudflare preview",
"deploy": "opennextjs-cloudflare build && opennextjs-cloudflare deploy",