插件升级摘要

页面摘要： 从 Strapi v4 升级到 Strapi 5 的插件开发者，必须迁移到 Plugin SDK（插件 SDK），从 Entity Service API 过渡到 Document Service API，更新前端代码以使用 Design System v2，并移除 helper-plugin 依赖。

本页面旨在作为一份简短摘要，供作为插件开发者、正在将插件从 Strapi v4 升级到 Strapi 5 的你参考。页面快速描述了影响插件的变更，并在必要时链接到附加资源。

迁移插件的推荐步骤

将 Strapi v4 插件升级到 Strapi 5 包括：

1. 使用 Plugin SDK 创建一个新的空插件。
2. 将你的 Strapi v4 代码移动到新创建的文件（位于 Strapi 5 的 插件结构 中），同时考虑本页面所总结的变更。

此外，你也可以手动更新你的 Strapi v4 插件以使用 Plugin SDK。 手动步骤包括：

1. 如果你的代码使用的不是 CommonJS 格式，请更新 package.json 文件并指定合适的 exports 属性。
2. 重新组织你的 Strapi v4 代码，以对齐 Strapi 5 的 插件结构

后端变更

• Strapi v4 的 Entity Service API 已被弃用，Strapi 5 改用 Document Service API。已提供一份 迁移指南 来帮助你过渡到 Document Service API。
• 通用的 Strapi v4 到 Strapi 5 的 破坏性变更 可能适用。
• 你可以使用新的 Plugin SDK 来生成插件，并将它们发布到 NPM 和/或提交到 Marketplace（市场）。

前端变更

• Design System 在 Strapi 5 中已升级到 v2：
  • 👉 Design System 文档中提供了一份专属的迁移指南 可在 Design System 文档中查看。
  • 除了 图标（icons） 之外，没有大的视觉变化。
  • 通用的 Strapi v4 到 Strapi 5 的 破坏性变更 可能适用。
• helper-plugin 已被移除。已提供一份 迁移参考 来帮助你从 helper-plugin 迁移离开。
• Strapi 不再为依赖项创建别名（alias）。所有面向客户端的代码预期使用的 4 个依赖项已在项目层级声明（react、react-dom、styled-components 和 react-router-dom）。如果你不声明你所使用的依赖项（例如 axios），用户在使用你的插件时可能会遇到不可预见的问题。
• 如果你正在使用 Plugin SDK，你将需要把前端文件转换为 .jsx 或 .tsx 格式。

自定义提供方

Email 和 Upload 插件的自定义提供方（providers）仅在它们曾使用 Entity Service API 时才需要转换（请参阅 Entity Service API 到 Document Service API 迁移指南）。