Lua 模拟 require 函数

Lua emulating the require function

在嵌入式 lua 环境中(魔兽世界 - WoW)缺少 require 功能。

我想要端口一现有的 lua 源代码 (an great OO-library) 以便在 WoW 中使用它。该库本身相对较小(大约 8 个小文件),但当然它大量使用了 require.

魔兽世界通过在 XML 文件中定义来加载文件和库,例如:

<Ui xsi:schemaLocation="http://www.blizzard.com/wow/ui/">
    <Script file="LibOne.lua"/>
    <Script file="LibTwo.lua"/>
</Ui>

但我不知道魔兽世界中的低级库操作是如何完成的。

WoW 中的 AFAIK 甚至 package. table 也不见了。 :(

所以问题:对我来说,简化的方法是编写一个函数,该函数将使用 WoW 中可用的界面模拟 require 函数。问题是如何。有人可以给我指路吗?

或者作为替代方案,为了将提到的现有源移植到 WoW,我需要将 lua 源中的 require Some.Other.Module 行替换为 WoW 可以理解的内容。魔兽世界里这样的require Some.Module的equivalent/replacement是什么?

WoW 是如何处理 modules/libraries 低级的?

WoW 环境根本没有 dofile 或任何其他读取外部文件的方法。您需要明确提及必须加载到 .toc 文件或从 .toc.

引用的 .xml 中的所有文件

然后您可以编写自己的 require 实现以保持与您的库的兼容性,这将非常简单,因为它只需要解析模块名称并从 modules.loaded table,但您仍然需要更改原始源以使文件在 table 中注册,并且您需要手动将所有文件排列为正确的加载顺序。

或者,您可以将文件重新排列到单独的 WoW 插件中,并使用它自己的内置 Dependencies/OptionalDeps 工具或流行的 LibStub 框架来自动处理加载顺序。

您可以使用各种合并脚本之一将所有文件合并为一个文件,例如amalg。然后您可以使用通常的 WoW 方式加载此文件和实现 require 函数的存根:

<Ui xsi:schemaLocation="http://www.blizzard.com/wow/ui/">
    <Script file="RequireStub.lua"/>
    <Script file="AllModules.lua"/><!-- amalgamated Lua modules -->
    <Script file="YourCode.lua"/>
</Ui>

文件 RequireStub.lua 可能如下所示:

package = {}
local preload, loaded = {}, {
  string = string,
  debug = debug,
  package = package,
  _G = _G,
  io = io,
  os = os,
  table = table,
  math = math,
  coroutine = coroutine,
}
package.preload, package.loaded = preload, loaded


function require( mod )
  if not loaded[ mod ] then
    local f = preload[ mod ]
    if f == nil then
      error( "module '"..mod..[[' not found:
       no field package.preload[']]..mod.."']", 1 )
    end
    local v = f( mod )
    if v ~= nil then
      loaded[ mod ] = v
    elseif loaded[ mod ] == nil then
      loaded[ mod ] = true
    end
  end
  return loaded[ mod ]
end

这应该模拟足够多的 package 库来让你工作 require 加载合并文件中的模块。不过,不同的合并脚本可能需要来自 package 的不同位,因此您可能需要查看生成的 Lua 源代码。

Coat 的特定情况下,您可能还需要为其他 Lua 函数实现存根。例如。我已经看到 Coat 使用 debug 库 ...