pipxでnitropyをインストールする#
このガイドは、pipx を使って nitropy をインストールする方法を説明します。 pipx は nitropy のために仮想環境を作成します。これは、nitropyとその依存関係が、あなたのシステムにインストールされている他のパッケージと衝突しないことを意味します。
注釈
Windowsユーザーの方へ: Windowsのサポートはまだ実験的なものです -- 慎重に使用してください。プリコンパイルされたバイナリやMSIインストーラを使用することもできます。
準備#
Python 3.9または3.10#
Python はほとんどの macOS と Linux システムに既にインストールされているか、python.org からダウンロードすることが可能です。詳しくは Downloading Python Guide を参照してください。
ピップ#
pipはシステムのパッケージマネージャ、または``python3 -m ensurepip``でインストールすることができます。詳しくは pip インストールガイド を参照してください。
ピップス#
nitropyをインストールする前に、pipx:をインストールし、設定する必要があります。
python3 -m pip install --user pipx
python3 -m pipx ensurepath
詳しくは、pipx インストールガイド をご覧ください。
インストール#
これで、pynitrokeyパッケージからnitropyをインストールすることができます:
pipx install pynitrokey
nitropyがpath:で使用できるようになりました。
nitropy --help
アップグレード#
以下のコマンドで、パッケージをアップグレードできます。
pipx upgrade pynitrokey
トラブルシューティング#
問題が発生した場合は、nitropy version
の出力と GitHub のリリースリスト <https://github.com/Nitrokey/pynitrokey/releases>`_ を比較して最新版を使用しているかどうか確認して下さい。 アップグレードで最新版がインストールされない場合、以下のような問題が発生している可能性があります。
Pythonのバージョンが違う#
nitropyはPython 3.9または3.10を必要とします。 もし、デフォルトでインストールされているPythonがそれより古いか新しく、アップデートできない場合は、追加でPython 3.9をインストールし、pipxを呼ぶときにそのPython実行ファイルの名前を指定する必要があります、例えば:
$ pipx install --python python3.9 pynitrokey
アーム非対応#
現在、最近の nitropy のバージョンは依存関係の問題により Arm プラットフォームにインストールできません (GitHub issue). 回避策として、this discussion にあるように、x86 Python インストールを Rosetta ターミナルで使用することができます)。
libusb-1.0.dylib が見つかりません。#
macOS で nitropy を実行すると、libusb-1.0.dylib ファイルがないことを示すエラーメッセージが表示されることがあります。 これは、homebrew:.NET を使って手動で libusb をインストールすれば直ります。
$ brew install libusb
使用上の注意#
すべてのプラットフォーム#
Nitrokey Pro や Nitrokey Storage デバイスで nitropy を使用する場合は、libnitrokey もインストールしておく必要があります。
Windows#
Windowsへの対応はまだ実験的なものであり、使用には注意が必要です。
デバイスに接続するために、管理者権限でnitropyを実行する必要がある場合があります。
Linux#
Linux システムでは、Nitrokey の udev ルールも必要です。これらは libnitrokey と一緒に出荷されています。あるいは、手動でインストールすることもできます:
wget https://raw.githubusercontent.com/Nitrokey/libnitrokey/master/data/41-nitrokey.rules
sudo mv 41-nitrokey.rules /etc/udev/rules.d/
詳しくは nitropy の udev ルールのセットアップ を参照してください。
次のステップ#
nitropyの使用方法については、これらのガイドで詳しく説明しています。
Linuxの場合: ファームウェアの更新.
Macの場合: ../../.../nitrokey3/mac/firmware-update.
Windowsの場合: ファームウェアの更新.