Skip to content

版本策略

NativePHP for Mobile 遵循语义版本控制,采用针对移动端的特定方法,区分仅 Laravel 的更改和原生代码更改。这确保了可预测的更新和最佳兼容性。

我们的目标是尽量减少你获取最新更新所需的工作量,并确保一切正常运行。

我们会在每个版本发布时提供更新说明。

发布类型

补丁版本

nativephp/mobile 的补丁版本应该没有破坏性更改,并且只更改 Laravel/PHP 代码。 这通常包括不影响原生代码的 bug 修复和依赖更新。

这些版本应该与你的原生应用程序的现有版本完全兼容。

这意味着你可以:

  • 通过 composer update 安全更新。
  • 避免完全重建(无需 native:install --force)。
  • 允许更轻松的应用更新,避免应用商店。

次要版本

次要版本可能包含原生代码更改。遵循语义版本控制,这些仍然不应包含破坏性更改,但可能有新的原生 API、Kotlin/Swift 更新、平台特定功能或原生依赖更改。

次要版本将:

  • 需要完全重建(php artisan native:install --force)才能使用最新的 API。
  • 需要提交应用商店进行分发。
  • 在必要时提前通知和迁移指南。

主要版本

主要版本保留用于破坏性更改。这通常会在一段时间的弃用之后进行,以便你有时间对应用程序代码进行必要的更改。

版本约束

我们建议在 composer.json 中使用波浪号范围运算符并定义完整的最低补丁版本:

json
{
    "require": {
        "nativephp/mobile": "~2.0.0"
    }
}

这会自动接收补丁更新,同时让你控制次要版本。

你的应用程序版本控制

仅仅因为我们对 nativephp/mobile 包使用语义版本控制,并不意味着你的应用必须遵循相同的方案。

你可以完全自由地为自己的应用程序设置版本!你可以使用语义版本控制、代号、基于日期的版本或任何适合你的项目、团队或业务的方案。

请记住,你的应用版本通常是面向公众的(例如在商店列表和设备上的设置和更新屏幕中),如果客户需要联系你寻求帮助和支持,它们可以作为有用的参考。

基于 NativePHP 官方文档翻译