版本控制
最后更新于
对扩展进行版本控制非常简单，因为我们设计系统的方式使您无需处理版本控制方案和兼容性。该模型类似于应用商店的模型，其中只有一个隐式最新版本，当扩展在商店中发布时，该版本将被更新。扩展会自动为最终用户更新。
对于开发来说，这意味着您无需在 manifest 中声明版本属性。如果您希望使用更高版本中添加的 API 功能，只需更新您的 @raycast/api npm 依赖项，开始使用该功能，并向商店提交扩展更新即可。
对于安装或更新扩展的终端用户，Raycast 会自动检查扩展实际使用的 API 版本与用户当前的 Raycast 应用程序版本（包含 API 运行时并管理 Node 版本）之间的兼容性。如果存在兼容性不匹配的情况，例如用户没有所需的最新 Raycast 应用程序版本，我们会显示提示并提示用户更新 Raycast，以便下一次兼容性检查成功。
如果您愿意，您可以在扩展中提供一个 changelog.md 文件，并在每次更新时提供详细的更改。用户可以在扩展详细信息屏幕、版本历史记录下以及 上查看这些更改。
您可以在 了解有关版本历史记录的更多信息、如何将其添加到您的扩展以及最佳外观所需的格式。
一般来说，我们遵循 API 演进过程，这意味着我们保持向后兼容，并且不会在同一主要 API 版本中引入重大更改。我们将 1) 添加新功能，2) 我们将随着时间的推移将某些 API 方法和组件标记为已弃用，这向您发出提示，表明您应该停止使用这些功能并迁移到新推荐的替代方案。在未来的某个时候，我们可能会推出一个新的重大版本；但是，此时您会收到通知，并且迁移扩展会有一个过渡期。