兼容性
Tuist CLI 会与 Tuist 服务器通信,以使用缓存、构建和测试洞察、预览以及注册表等功能。服务器会持续独立地发布更新,不受你升级 CLI 的时间影响,因此服务器的变更不得破坏你正在运行的 CLI 版本。为确保这一点,服务器会在定义的时间窗口内保持与近期 CLI 版本的兼容性。
支持时间窗口#
Tuist 服务器支持来自最近 3 个月的 CLI 版本。在该窗口期内,服务器保持向后兼容:过去 3 个月内发布的任何 CLI 都能继续针对服务器进行构建、缓存和运行测试,你可以按自己的计划升级 CLI,而不会因服务器变更导致中断。
CLI 遵循语义化版本控制。最近 3 个月内发布的任何版本都受支持。
超出时间窗口#
早于支持时间窗口的 CLI 版本被视为已弃用。服务器仍会响应,但:
- 较新的服务端功能可能无法在该版本上正常工作。
- 由服务器支持的命令可能会输出警告,提示你升级。
不保证已弃用版本的行为。如果你正在使用此类版本,请升级到支持时间窗口内的版本。
我们如何兑现承诺#
向后兼容性经过验证,而非假设。每次服务器部署都会针对仍处于支持时间窗口内的最旧 CLI 版本(当前为4.150.0)运行自动化验收测试,端到端地执行缓存拉取流程。如果某项变更会破坏该版本,部署将在进入生产环境之前被阻止。该测试会与针对最新 CLI 的测试并行运行,因此能够以相同的方式捕获针对旧客户端和新客户端的回归问题。
建议#
至少每 3 个月升级一次 CLI,以保持在受支持的时间窗口内。在 CI 中固定 CLI 版本并按固定节奏更新,可确保你的团队始终使用一致且受支持的版本。