Инсталиране на nitropy с pipx#
Това ръководство обяснява как да инсталирате nitropy с pipx. pipx създава виртуална среда за nitropy. Това означава, че nitropy и неговите зависимости не влизат в конфликт с други пакети, инсталирани във вашата система.
Note
За потребителите на Windows: Поддръжката на Windows все още е експериментална - моля, използвайте я с повишено внимание. Можете също така да използвате предварително компилирани двоични файлове или инсталатор MSI, вижте Инсталиране на nitropy в Windows.
Подготовка#
Python 3.9, 3.10 или 3.11#
Python вече е инсталиран на повечето системи MacOS и Linux или може да бъде изтеглен от python.org. За повече информация вижте Наръчник за изтегляне на Python.
pip#
Можете да инсталирате pip с помощта на системния си мениджър на пакети или с python3 -m ensurepip
. За повече информация вижте ръководството за инсталиране на pip.
pipx#
Преди да инсталирате nitropy, трябва да инсталирате и конфигурирате pipx:
python3 -m pip install --user pipx
python3 -m pipx ensurepath
За повече информация вижте ръководството за инсталиране на pipx.
Инсталиране на приложението Nitrokey#
Сега можете да инсталирате nitropy от пакета pynitrokey:
pipx install pynitrokey
nitropy вече е наличен във вашия път:
nitropy --help
Надграждане#
Можете да обновите пакета със следната команда:
pipx upgrade pynitrokey
Отстраняване на неизправности#
Ако срещнете проблеми, моля, уверете се, че използвате най-новата версия, като сравните изхода на nitropy version
със списъка на версиите в GitHub. Ако при обновяването не се инсталира най-новата версия, може би се сблъсквате с един от следните проблеми.
Грешна версия на Python#
nitropy изисква Python 3.9 или 3.10. Ако инсталацията на Python по подразбиране е по-стара или по-нова и не може да бъде актуализирана, трябва допълнително да инсталирате Python 3.9 и да посочите името на изпълнимия файл на Python при извикването на pipx, например:
$ pipx install --python python3.9 pynitrokey
Ръката не се поддържа#
Понастоящем последните версии на nitropy не могат да бъдат инсталирани на платформи Arm поради проблем със зависимостта (GitHub issue). Като заобиколен вариант можете да използвате инсталация на x86 Python в терминал Rosetta, както е описано в тази дискусия).
libusb-1.0.dylib не е намерен#
При стартиране на nitropy в macOS може да се появи съобщение за грешка, което показва, че липсва файл libusb-1.0.dylib. Това може да бъде поправено чрез ръчно инсталиране на libusb, например с Homebrew:
$ brew install libusb
Бележки за употреба#
Всички платформи#
Ако искате да използвате nitropy с устройство Nitrokey Pro или Nitrokey Storage, трябва също да инсталирате libnitrokey.
Windows 10#
Поддръжката на 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/
Вижте Създаване на правилата на udev за nitropy за повече информация.
Следващи стъпки#
Можете да намерите повече информация за използването на nitropy в тези ръководства:
За Linux: Актуализация на фърмуера
За Mac: Актуализация на фърмуера
За Windows: Актуализация на фърмуера