bmk is used to build BlitzMax applications and modules. It scans source
files for imports and build options !TODO!
Command line syntax
bmk <operation> [options] source
(Note that you will need
./bmk on *nix platforms, if you want to run bmk from the
Builds an application from a single root source file.
Builds a set of modules.
On Win32, builds a dynamic linked library (DLL) from the source file.
Recompiles all source/modules regardless of timestamp. By default, only those modified since the last build are recompiled.
-b <custom appstub module>
Builds an app using a custom appstub (The default is brl.appstub).
This can be useful when you want more control over low-level application state and the debugger.
Builds a debug version. (This is the default for makeapp)
Compiles to the specified architecture. (the default is the native for the current binary - For example, it will be x86 for an x86-built bmk)
Options vary depending on the current OS/architecture/installed toolchain and version of
- MacOS :
- Win32 :
- Linux :
- iOS :
- Android :
- RaspberryPi :
- NX :
Generates line mappings suitable for GDB debugging.
Backtrace (etc.) will show .bmx relative source lines rather than that of the generated code.
Builds multithreaded version. (By default, the single threaded version is built.)
Creates a Universal build for supported platforms. !TODO!
-l <target platform>
Cross-compiles to the specific target platform.
Valid targets are
Enables musl libc compatibility. (Linux NG only)
Don't upgrade strict method void return types, if required. (NG only)
If a Strict sub type overrides the method of a SuperStrict type and the return type is void, don't upgrade the return type to void (i.e. none), and default it to Int.
-o <output file>
Specifies the output file. (makeapp only)
By default, the output file is placed into the same directory as the root source file.
Does not scan modules for changes. May result in quicker build times on some systems.
The default behaviour is to scan and build all requirements for the application, including modules.
Builds a release version.
Generate but do not compile into binary form.
Useful for creating ready-to-build source for a different platform/architecture.
Statically link binary. (Linux NG only)
-t <app type>
Specifies the application type. (makeapp only)
Should be either
The default is
Verbose (noisy) build.
Warns about function argument casting issues rather than error. (NG only)
With this warning enabled you may have problems using method overloading.
Executes built application. (makeapp only)