3.5 KiB
Docker クイックスタート
このプロジェクトは、プライマリオペレーティングシステムに大きな変更を加えることなくキーボードの新しいファームウェアを非常に簡単に構築することができる Docker ワークフローを含みます。これは、あなたがプロジェクトをクローンしビルドを実行した時に、他の人とまったく同じ環境と QMK ビルド基盤を持つことも保証します。これにより、人々はあなたが遭遇した問題の解決をより簡単に行えるようになります。
必要事項
主な前提条件は動作する docker または podman がインストールされていることです。
使い方
(サブモジュールを含む) QMK のレポジトリのローカルコピーを取得する:
git clone --recurse-submodules https://github.com/qmk/qmk_firmware.git
cd qmk_firmware
キーマップをビルドするために以下のコマンドを実行します:
util/docker_build.sh <keyboard>:<keymap>
# 例えば: util/docker_build.sh planck/rev6:default
これは目的のキーボード/キーマップをコンパイルし、結果として書き込み用に .hex あるいは .bin ファイルを QMK ディレクトリの中に残します。:keymap が省略された場合は全てのキーマップが使われます。パラメータの形式は、make を使ってビルドする時と同じであることに注意してください。
target を指定して Docker から直接キーボードをビルドし、かつ 書き込むためのサポートもあります。
util/docker_build.sh keyboard:keymap:target
# 例えば: util/docker_build.sh planck/rev6:default:flash
スクリプトをパラメータ無しで開始することもできます。この場合、1つずつビルドパラメータを入力するように求められます。これが使いやすいと思うかもしれません:
util/docker_build.sh
# パラメータを入力として読み込みます (空白にすると全てのキーボード/キーマップ)
RUNTIME 環境変数にコンテナランタイム名やパスを設定することで、使用したいコンテナランタイムを手動で設定できます。
デフォルトでは docker や podman は自動的に検出され、podman より docker が優先されます。
RUNTIME="podman" util/docker_build.sh keyboard:keymap:target
FAQ
なぜ Windows/macOS 上で書き込めないのですか？
Windows と macOS では、実行するために Docker Machine が必要です。これはセットアップが面倒なので、お勧めではありません: 代わりに QMK Toolbox を使ってください。
!> Docker for Windows は Hyper-V を有効にする必要があります。これは、Windows 7、Windows 8 および Windows 10 Home のような Hyper-V を搭載していない Windows のバージョンでは機能しないことを意味します。