qmk_firmware/docs/ja/newbs_getting_started.md

9.8 KiB

QMK 環境の構築

キーマップをビルドする前に、いくつかのソフトウェアをインストールしてビルド環境を構築する必要があります。 ファームウェアをコンパイルするキーボードの数に関わらず、この作業を一度だけ実行する必要があります。

1. ソフトウェアのダウンロード

始めるために必要なソフトウェアがいくつかあります。

テキストエディタ

プレーンテキスト ファイルを編集して保存できるプログラムが必要です。 Windows の場合、メモ帳が使えます。Linux の場合、gedit が使えます。どちらもシンプルですが機能的なテキストエディタです。 macOS では、デフォルトのテキストエディットアプリに注意してください。フォーマット メニューから 標準テキストにする を選択しない限り、プレーンテキストとして保存されません。

Sublime TextVS Code のような専用のテキストエディタをダウンロードしてインストールすることもできます。これらのプログラムはコードを編集するために特別に作成されているため、これはプラットフォームに関係なくベストな方法です。

?> どのエディタを使えば良いか分からない場合、Laurence Bradford が書いたこの記事 a great introduction を読んでください。

QMK Toolbox

QMK Toolbox は、Windows と macOS で使える GUI を備えたプログラムで、カスタムキーボードのプログラミングとデバッグの両方ができます。 このプログラムは、キーボードに簡単にファームウェアを書き込んだり、出力されるデバッグメッセージを確認する際に、かけがえのないものであることがわかるでしょう。

QMK Toolbox の最新版

  • Windows 版: qmk_toolbox.exe (portable) または qmk_toolbox_install.exe (installer)
  • macOS 版: QMK.Toolbox.app.zip (portable) または QMK.Toolbox.pkg (installer)

Unix ライクな環境

Linux や macOS には既に実行可能な unix シェルが付属しています。ビルド環境を構築するだけで済みます。

Windows では、MSYS2 や WSL をインストールして、これらの環境を使う必要があります。MSYS2 の構築手順を以下に示します。

2. ビルド環境を準備する :id=set-up-your-environment

私たちは、QMK を可能な限り簡単に構築できるように努力しています。 Linux か Unix 環境を用意するだけで、QMK に残りをインストールさせることができます。

?> もし、Linux か Unix のコマンドを使ったことがない場合、こちらで基本的な概念や各種コマンドを学んでください。これらの教材で QMK を使うのに必要なことを学ぶことができます:
Must Know Linux Commands
Some Basic Unix Commands

Windows

MSYS2 と Git と QMK CLI のインストールが必要です。

MSYS2 homepage のインストール手順に従ってください。開いている MSYS2 の全ターミナル画面を閉じて、新しい MinGW 64-bit ターミナル画面を開きます。注意: これはインストールが完了した時に開く MSYS ターミナルと同じ ではありません

それから、次のように実行します:

pacman --needed --noconfirm --disable-download-timeout -S git mingw-w64-x86_64-toolchain mingw-w64-x86_64-python3-pip
python3 -m pip install qmk

macOS

Homebrew のインストールが必要です。Homebrew homepage の手順に従ってください。

Homebrew をインストールした後で、以下のコマンドを実行します:

brew install qmk/qmk/qmk

Linux

Git と Python をインストールする必要があります。両方とも既にインストールされている可能性は高いですが、そうでない場合、次のコマンドのいずれかでそれらをインストールできます:

  • Debian / Ubuntu / Devuan: sudo apt install git python3 python3-pip
  • Fedora / Red Hat / CentOS: sudo yum install git python3 python3-pip
  • Arch / Manjaro: sudo pacman -S git python python-pip python-setuptools libffi

グローバル CLI をインストールして、システムをブートストラップします:

python3 -m pip install --user qmk (Arch ベースのディストリビューションでは AUR から qmk パッケージを試すこともできます(メモ: コミュニティメンバーによって保守されています): yay -S qmk)

FreeBSD

Git と Python をインストールする必要があります。両方とも既にインストールされている可能性は高いですが、そうでない場合、次のコマンドを実行してそれらをインストールします:

pkg install git python3

ローカルにインストールした Python パッケージが利用できるように、$HOME/.local/bin$PATH に追加されていることを確認してください。

インストール完了後、QMK CLI をインストールできます:

python3 -m pip install --user qmk

3. QMK の設定を行う :id=set-up-qmk

QMK のインストール後に、このコマンドで設定できます:

qmk setup

ほとんどの場合、全てのプロンプトに Yes と答えます。

?>Debian、Ubuntu、それらの派生に関する注意: 次のようなエラーが表示される可能性があります: bash: qmk: command not found. これは Debian の Bash 4.4 リリースで導入された バグ で、$HOME/.local/bin が PATH から削除されました。このバグは後に Debian や Ubuntu で修正されました。 残念なことに、Ubuntu はこのバグを再導入し、まだ修正していません。 幸い、修正は簡単です。これをあなたのユーザで実行します: echo 'PATH="$HOME/.local/bin:$PATH"' >> $HOME/.bashrc && source $HOME/.bashrc

?>FreeBSD に関する注意: まず、root 以外のユーザで qmk setup を実行することをお勧めしますが、これはおそらく pkg を使って基本システムにインストールする必要があるパッケージを識別します。 しかし、特権のないユーザで実行すると、インストールはおそらく失敗します。 基本的な依存関係を手動でインストールするには、./util/qmk_install.shroot として実行するか、sudo をつけて実行します。 それが完了したら、qmk setup を再実行して設定と確認を完了させます。

?> 既に GitHub の使いかたを知っているなら、fork を作成し、qmk setup <github_username>/qmk_firmware を使って個人用の fork から clone することをお勧めします。この一文の意味が分からない場合、このメッセージは無視してかまいません。

4. ビルド環境の確認

これで QMK のビルド環境が用意できたので、キーボードのファームウェアをビルドできます。 キーボードのデフォルトキーマップをビルドすることから始めます。次の形式のコマンドでビルドできるはずです。

qmk compile -kb <keyboard> -km default

例えば、Clueboard 66% のファームウェアをビルドする場合:

qmk compile -kb clueboard/66/rev3 -km default

大量の出力の最後に次のように出力されると完了です:

Linking: .build/clueboard_66_rev3_default.elf                                                       [OK]
Creating load file for flashing: .build/clueboard_66_rev3_default.hex                               [OK]
Copying clueboard_66_rev3_default.hex to qmk_firmware folder                                        [OK]
Checking file size of clueboard_66_rev3_default.hex                                                 [OK]
 * The firmware size is fine - 26356/28672 (2316 bytes free)

5. ビルド環境の設定(オプション)

ビルド環境を設定してデフォルトを設定することで、QMK での作業をあまり面倒くさくないようにすることができます。今からやりましょう!

QMK を初めて使うほとんどの人は、キーボードを1つしか持っていません。qmk config コマンドでこのキーボードをデフォルトとして設定できます。例えば、デフォルトのキーボードを clueboard/66/rev4 に設定するには:

qmk config user.keyboard=clueboard/66/rev4

デフォルトキーマップ名を設定することもできます。ほとんどの人はここで GitHub ユーザ名を使いますが、そうすることをお勧めします。

qmk config user.keymap=<github_username>

この後、これらの引数をオフにして、次のようにキーボードをコンパイルできます:

qmk compile

キーマップの作成

これであなた専用のキーマップを作成する準備ができました! 次は 初めてのファームウェアの構築 で専用のキーマップを作成します。