miqt/cmd/miqt-docker/README.md

miqt-docker

This is a helper program to quickly run a dockerized MIQT build environment.

It also has some built-in commands that can be run either dockerized or natively.

• Supports all available MIQT docker containers
• Use glob matches to automatically pick the highest version container for target
• Automatically build new docker containers or reuse existing, based on content hash of the Dockerfile
• Automatically bind source code volume from current go.mod / go.work / git repository and preserve relative working directory
• Handles bind-mounting the GOCACHE and GOMODCACHE directories
• Handles using the proper uid+gid on Linux
• Automatically detect sudo requirement on Linux

Usage

Run miqt-docker with no arguments to see full usage instructions and all available embedded dockerfiles:

Usage: miqt-docker ENVIRONMENT COMMAND...

COMMAND may be any shell command (e.g. go build); or /bin/bash to get an
interactive terminal; or one of the following special tasks:

  -build           Run 'go build' with usual MIQT flags
  -minify-build    Run 'go build' with special minification flags
  -windows-build   Run 'go build' with special Windows support
  -android-build   Build an Android APK (using the android-qt5 or android-qt6
                    container environments)

Environment variables:
  DOCKER           Override the path to docker
	
Available container environments: (use - as wildcard character)
[...]

Example build commands:

miqt-docker macos go build -ldflags '-s -w'
miqt-docker win64-qt6-dynamic go build -ldflags '-s -w -H windowsgui'
miqt-docker android-qt6 -android-build