跳转到内容

BlitzMax/用户指南/BMK

来自维基教科书,开放世界中的开放书籍

BMK 是一个命令行工具,它驱动 BlitzMax 编译器并提供其他一般的“管理”操作。

BMK 的一般语法是

bmk 操作 选项 参数

其中操作是 makeappmakemodszapmodunzampmod 之一。

Makeapp 从单个源文件构建应用程序。构建应用程序涉及编译源文件并将生成的对象文件链接在一起。

Makeapp 接受一个参数:要构建的根源文件。

BMK 会扫描根源文件以查找 ImportIncludeIncbin 语句,这些文件也会被自动构建。

除非使用 -a 选项,否则只有在上次 makeapp 操作后修改过的源文件才会被重新编译。这可以极大地提高编译时间。

makeapp 的有效选项是

选项 效果
-d 构建调试版本。这是默认设置。
-r 构建发布版本。默认情况下,构建调试版本。
-h 构建多线程版本。默认情况下,构建单线程版本。
-a 无论时间戳如何,都重新编译所有源文件。默认情况下,只重新编译自上次 makeapp 以来修改过的文件。
-o OutputFile 指定输出文件。默认情况下,输出文件将放置在与根源文件相同的目录中。
-t AppType 指定应用程序类型。应该是 'console' 或 'gui'(不带单引号!)。

一些 makeapp 实际操作的例子

bmk makeapp myapp.bmx
bmk makeapp -a -r -o myapp_release myapp.bmx

请注意,调试、发布、单线程和多线程选项允许创建 4 种“类型”的应用程序

  • 调试,单线程(这是默认设置)
  • 调试,多线程(使用 -h 选项)
  • 发布,单线程(使用 -r 选项)
  • 发布,多线程(使用 -r 和 -h 选项)

makemods 操作构建一组模块。

Makemods 接受一个可选参数:模块过滤器。这可以是模块范围名称(构建模块子集)或完全限定的模块名称(构建单个模块)。如果省略模块过滤器,则构建所有模块。

makemods 的有效选项是

选项 效果
-d 仅构建调试版本。默认情况下,构建调试和发布版本。
-r 仅构建发布版本。默认情况下,构建调试和发布版本。
-h 构建多线程版本。默认情况下,仅构建单线程版本。
-a 无论时间戳如何,都构建所有模块。默认情况下,只构建修改过的模块。

一些 makemods 实际操作的例子

bmk makemods mymods
bmk makemods -a mymods.testmod

Zapmod 操作将模块压缩成单个 '.zap' 文件。

Zapmod 接受 2 个参数 - 要压缩的模块和输出文件的名称。

例如

bmk zapmod mymods.testmod testmod.zap

Unzapmod 安装之前使用 'Zapmod' 压缩的模块。

Unzapmod 接受 1 个参数 - 要解压缩的模块压缩文件。请注意,此操作将覆盖任何匹配的现有模块。例如

bmk unzapmod testmod.zap
华夏公益教科书