Установка nitropy с помощью pipx#

Это руководство объясняет, как установить nitropy с помощью pipx. pipx создает виртуальную среду для nitropy. Это означает, что nitropy и его зависимости не конфликтуют с другими пакетами, установленными в вашей системе.

Примечание

Для пользователей Windows: Поддержка Windows все еще является экспериментальной - пожалуйста, используйте ее с осторожностью. Вы также можете использовать предварительно скомпилированные двоичные файлы или программу установки MSI, смотрите …/windows/installation.

Подготовка#

Python 3.9 или новее#

Python уже установлен на большинстве систем macOS и Linux или может быть загружен с сайта python.org. Дополнительную информацию см. в Руководстве по загрузке Python.

pip#

Вы можете установить pip с помощью менеджера пакетов вашей системы или с помощью python3 -m ensurepip. Дополнительную информацию см. в pip Installation Guide.

pipx#

Перед установкой nitropy необходимо установить и настроить pipx:

python3 -m pip install --user pipx
python3 -m pipx ensurepath

Дополнительную информацию см. в pipx Installation Guide.

Установка#

Теперь вы можете установить nitropy из пакета pynitrokey:

pipx install pynitrokey

nitropy теперь доступен в вашем пути:

nitropy --help

Обновление#

Вы можете обновить пакет с помощью следующей команды:

pipx upgrade pynitrokey

Устранение неполадок#

Если у вас возникли проблемы, убедитесь, что вы используете последнюю версию, сравнив вывод nitropy version с списком релизов на GitHub. Если обновление не устанавливает последнюю версию, возможно, вы столкнулись с одной из следующих проблем.

Версия Python слишком старая#

nitropy требует Python 3.9 или более поздней версии. Если ваша стандартная установка Python старше этой версии и не может быть обновлена, вам необходимо дополнительно установить Python 3.9 и указать имя его исполняемого файла Python при вызове pipx, например:

$ pipx install --python python3.9 pynitrokey

Рука не поддерживается#

В настоящее время последние версии nitropy не могут быть установлены на платформы Arm из-за проблемы с зависимостями (` проблема на GitHub <https://github.com/Nitrokey/pynitrokey/issues/265>`_). В качестве обходного пути можно использовать установку x86 Python в терминале Rosetta, как описано в этом обсуждении).

Примечания по использованию#

Все платформы#

Если вы хотите использовать nitropy с устройством Nitrokey Pro или Nitrokey Storage, вам также необходимо установить 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/

Дополнительную информацию см. в …/linux/udev.

Следующие шаги#

Более подробную информацию об использовании нитропида можно найти в этих руководствах:

  • …/…/…/nitrokey3/firmware-update