Lua 编译辅助工具 1.0 for lua 5.1.4 说明文档.docVIP

Lua 编译辅助工具 1.0 for lua 5.1.4 说明文档 1.0 本程序为各位lua开发、学习者，对lua代码编译为二进制码提供了一个便利的解决方案。 理论对于其它版本的lua编译程序luac.exe都支持。只用到了-o命令参数，只要支持-o命令行参数的luac.exe都可用于本程序来辅助编译。 本程序只在Win XP上测试通过。使用本程序时推荐对lua源文件进行备份，虽然程序会停止覆盖源文件的操作，但不保证会出现其它异常情况，使用本程序造成源文件丢失的作者概不负责。 若发现本程序有任何错误或者对本程序的建议，请联系作者，本文档授权在不私自修改的情况下自由复制传播。程序的最新版本可到我的百度空间查找。 百度ID：关签 Email：frimin@ QQ：172385231 程序界面： 1.1 基本编译 下面来编译一个单独lua的文件。 假设在C:\lua目录下有一个code.lua，且代码没有任何错误。单击“添加文件”按钮将其添加到“源文件”的编辑框中。也可以将其拖拽至窗口中，程序将会自动添加。 现在程序显示如下： 单击右下角的“编译按钮”。弹出如下的信息框： 点击“取消”忽略。此时会有窗口闪过（如果你的luac编译器需要手动关闭，请修改其源代码使其自动关闭）。 程序下方的信息编辑框会变成如下： code.lua已经被编译为二进制。 如果要编译多个文件只要按照如上的操作多添加源文件即可。 勾选“检查是否正确编译”选项后，若发现编译器没有正常输出文件后会停止输出。 1.2 多文件编译 打开源文件编辑框下方的“编辑”按钮，会载入如下窗口。 该编辑窗口是为了更方便于源文件列表内容的编辑。Lua是可以由多个源代码文件编译为一个二进制码的文件的。这里将会告诉你如何用本辅助工具编译多个文件到一个文件中。 点击右上方的“插入PAK”按钮，会插入如下一段字符串。结果如下图： PAK|C:\Documents and Settings\Administrator\桌面\luac\out\package.lua 中的 PAK标识了该行是多文件编译的起始行。 C:\Documents and Settings\Administrator\桌面\luac\out\package.lua 是一个伪路径，这个文件并不一定存在，在这里暂时可以理解为该为多文件编译的导出路径。 再添加一个lua文件： 到此为止现在还不能进行多文件编译，如果你已经点击了编译按钮的话会出现类似如下的信息: “Error:003 编译被终止 异常的多文件编译列表(文件数量过少) C:\Documents and Settings\Administrator\桌面\luac\out\package.lua” 这里已经很明确的告诉你了，多文件编译列表的文件数量过少，也就是以PAK开头的这一行没有参数。那怎样给PAK行添加参数呢？很简单，只要在下面的文件路径前添加“*”符号就可以了。添加完成后如下： “*”符号指定了下面紧跟的所有路径将编译到一个文件中。也就是code.lua和x.lua会被编译到一起。 点击编辑窗口右下角的“应用”按钮将修改应用到主窗口中。点击编译。到程序目录下的out中会看到编译完成的package.lua文件。 2.1 输出路径 为了更好的输出到理想的路径，程序可以指定输出的路径，先勾选“修改输出路径”选项，在如图设置输出路径为C:\mycode.lua 点击“编译”，在C:\下可得到code.lua和x.lua的多文件编译结果。 注意，程序不会自动创建文件夹，使用者必须保证文件夹的存在。 2.2 宏与预置宏 但是只输出固定的路径不能体现本程序的便捷之处，所以本程序使用了宏的功能。关于宏的详细解释可以到网上找到，这里不作解释。宏在这里代替的是一个变动的字符串，基本的宏如下： Lua版本号 $[LuaVersion] 本程序的版本号 $[ToolVersion] 当前时间 $[Time] 默认输出路径 $[DefaultPath] 源文件路径 $[SourceFilePath] 源文件所在的目录名 $[SourceFileFolder] 源文件名 $[SourceFileName] 源文件扩展名 $[SourceFileExt] 源文件所在驱动器名 $[SourceFileDriveName] 只有获得lua版本号、本程序版本号的内容是恒定的，内容为 5.1.4 和 1.0。其它的宏会根据所提供的路径来动态获得。单文件编译会用源文件的路径来获得这些宏，多文件编译会使用伪路径（也就是PAK|后面的内容）获得。 假设源文