0Pricing
Lua Academy · 课时

版本管理和依赖管理

跟踪插件版本，并在加载时检查兼容性。

版本管理和依赖管理 是 CoddyKit 上的免费 Lua Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Lua Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Lua Academy 课程共包含 4 节课。

为什么版本管理很重要

插件会不断演进。插件 v2.0 可能与 v1.0 API 不兼容。跟踪版本可以防止不易察觉的兼容性失败。

语义化版本控制

使用语义化版本控制：MAJOR.MINOR.PATCH。重大变更递增 MAJOR，新功能递增 MINOR，错误修复递增 PATCH。

带版本的插件清单

每个插件都会声明自身的版本和所需的应用程序 API 版本。

return {
  name        = "auth",
  version     = "2.1.0",
  apiRequired = ">=1.0.0",
  deps        = { {name="logger", version=">=1.0.0"} },
  init        = function(app) -- ... end
}

版本解析

将版本字符串解析为可比较的组成部分。

local function parseVersion(v)
  local major, minor, patch = v:match("(%d+)%.(%d+)%.(%d+)")
  return {tonumber(major), tonumber(minor), tonumber(patch)}
end
local function versionGe(a, b)
  a, b = parseVersion(a), parseVersion(b)
  for i = 1, 3 do
    if a[i] ~= b[i] then return a[i] > b[i] end
  end
  return true
end

兼容性检查

加载插件时，验证应用程序的 API 版本是否满足插件的要求。

local APP_VERSION = "1.5.0"
local function checkCompatibility(plugin)
  local req = plugin.apiRequired or ">=0.0.0"
  local minVer = req:match(">=(.+)")
  if minVer and not versionGe(APP_VERSION, minVer) then
    error(("Plugin %s requires app >= %s, got %s"):format(
      plugin.name, minVer, APP_VERSION))
  end
end

依赖图解析

构建依赖图，并执行拓扑排序以确定加载顺序。

循环依赖检测

跟踪当前正在加载的插件。如果某个插件依赖另一个正在加载的插件（从而形成循环），则引发错误。

local loading = {}
local function loadWithCycleCheck(name, plugins)
  if loading[name] then error("Circular dependency: " .. name) end
  loading[name] = true
  -- load deps then load plugin
  loading[name] = nil
end

升级路径

为 MAJOR 版本升级记录迁移指南。在过渡期间，可以考虑为旧版插件 API 提供兼容层。

带版本的插件注册表

中央注册表存储所有已安装的插件版本。通过优先选择兼容的最高版本来解决冲突。

锁文件模式

类似 npm 的 package-lock.json：记录生产部署中使用的确切版本，以确保构建可复现。

运行时版本协商

允许插件声明多个兼容的 API 版本。宿主应用程序会进行协商，并选择双方共同支持的最高版本。

版本管理问题

语义化版本控制中的 MAJOR 版本升级表示什么？

回顾：版本管理与依赖项

在每个插件清单中加入版本和 apiRequired。在加载时解析并比较版本。检测循环依赖。使用拓扑排序确定加载顺序。保留锁文件，以确保生产部署可复现。

常见问题解答

「版本管理和依赖管理」课时是免费的吗？

是的 — 「版本管理和依赖管理」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Lua Academy 课程的其余内容，请升级到 CoddyKit PRO。 Lua Academy 课程共包含 4 节课。

「版本管理和依赖管理」这节课中我会学到什么？

跟踪插件版本，并在加载时检查兼容性。 你通过在浏览器中直接运行的动手代码来练习 Lua Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Lua Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Lua Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。

「版本管理和依赖管理」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Lua Academy 课中编写并运行代码吗？

能。每节 Lua Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 发现和加载插件
  2. 插件 API 和钩子系统
  3. 沙箱化插件执行
  4. 版本管理和依赖管理
← 返回 Lua Academy