版本策略
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 包使用语义版本控制,并不意味着你的应用必须遵循相同的方案。
你可以完全自由地为自己的应用程序设置版本!你可以使用语义版本控制、代号、基于日期的版本或任何适合你的项目、团队或业务的方案。
请记住,你的应用版本通常是面向公众的(例如在商店列表和设备上的设置和更新屏幕中),如果客户需要联系你寻求帮助和支持,它们可以作为有用的参考。