从 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_KVNEXT_CACHE_R2_...->NEXT_INC_CACHE_R2_...NEXT_CACHE_D1->NEXT_TAG_CACHE_D1NEXT_CACHE_DO_...->NEXT_TAG_CACHE_DO_...NEXT_CACHE_DO_REVALIDATION->NEXT_CACHE_DO_QUEUENEXT_CACHE_REVALIDATION_WORKER->WORKER_SELF_REFERENCE
移除了 NEXT_CACHE_D1_TAGS_TABLE 和 NEXT_CACHE_D1_REVALIDATIONS_TABLE。
D1 表现在使用固定名称 tags 和 revalidations。
CLI 变更
CLI 之前通过 opennextjs-cloudflare 调用,现在需要指定强制命令:
opennextjs-cloudflare build等同于之前执行opennextjs-cloudflareopennextjs-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",