Nitroopia paigaldamine pipxiga#

Selles juhendis selgitatakse, kuidas paigaldada nitropy koos pipx. pipx loob nitropy jaoks virtuaalse keskkonna. See tähendab, et nitropy ja selle sõltuvused ei lähe vastuollu teiste teie süsteemi paigaldatud pakettidega.

Märkus

Windowsi kasutajatele: Windowsi tugi on veel eksperimentaalne – palun kasutage seda ettevaatlikult. Võite kasutada ka eelkompileeritud binaarsüsteeme või MSI paigaldusprogrammi, vt Nitropy installimine Windowsis.

Ettevalmistus#

Python 3.9, 3.10 või 3.11#

Python on enamikus macOS- ja Linux-süsteemides juba installeeritud või seda saab alla laadida aadressilt python.org. Lisateavet leiate Pythoni allalaadimise juhendist.

pip#

Pipi saab paigaldada oma süsteemi paketihalduriga või python3 -m ensurepip. Lisateavet leiate pip-i paigaldusjuhendist.

pipx#

Enne nitropy installimist tuleb paigaldada ja konfigureerida pipx:

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

Lisateavet leiate veebilehelt pipx Installation Guide.

Märkus

Linuxi kasutajatele - praegu tekitab ajutine sõltuvus (oscrypto) probleeme mõnes Linuxi distributsioonis. Vastav GitHub issue dokumenteerib hetkel vajaliku lahenduse:

pipx inject --pip-args="--upgrade --force" pynitrokey "oscrypto @ git+https://github.com/wbond/oscrypto.git@1547f535001ba568b239b8797465536759c742a3"

Paigaldamine#

Nüüd saate paigaldada nitropy pynitrokey paketist:

pipx install pynitrokey

nitropy on nüüd saadaval teie tee:

nitropy --help

Uuendamine#

Paketti saab uuendada järgmise käsuga:

pipx upgrade pynitrokey

Veaotsing#

Kui teil tekib probleeme, veenduge, et kasutate uusimat versiooni, võrreldes nitropy version väljundit väljalaske nimekirjaga GitHubis. Kui uuendus ei paigalda uusimat versiooni, võib teil olla üks järgmistest probleemidest.

Vale Python versioon#

nitropy nõuab Python 3.9 või 3.10. Kui teie Pythoni vaikimisi installatsioon on sellest vanem või uuem ja seda ei saa uuendada, peate te lisaks installima Python 3.9 ja täpsustama selle Pythoni käivitatava faili nime, kui te kutsute pipx-i, näiteks:

$ pipx install --python python3.9 pynitrokey

Käsi ei ole toetatud#

Praegu ei saa hiljutisi nitropy versioone Arm platvormidele paigaldada sõltuvusprobleemi tõttu (GitHub issue). Ümbersõidu lahendusena saab kasutada x86 Pythoni installimist Rosetta terminalis, nagu on kirjeldatud selles arutelus).

libusb-1.0.dylib ei leitud#

Kui käivitate nitropy’t macOS-i peal, võite näha veateadet, et puudub libusb-1.0.dylib fail. Seda saab parandada libusb-i käsitsi paigaldamisega, nt homebrew:

$ brew install libusb

Kasutamise märkused#

Kõik platvormid#

Kui soovite kasutada nitrokey’t koos Nitrokey Pro või Nitrokey Storage seadmega, peate paigaldama ka libnitrokey.

Windows#

Windowsi tugi on veel eksperimentaalne - palun kasutage seda ettevaatlikult.

Seadmega ühenduse loomiseks võib olla vajalik nitropy käivitamine administraatori õigustega.

Linux#

Linuxi süsteemides on vaja ka Nitrokey udev-reegleid. Need tarnitakse koos libnitrokey. Alternatiivselt võite neid käsitsi paigaldada:

wget https://raw.githubusercontent.com/Nitrokey/libnitrokey/master/data/41-nitrokey.rules
sudo mv 41-nitrokey.rules /etc/udev/rules.d/

Vaata udev reeglite seadistamine lisateavet.

Järgmised sammud#

Lisateavet nitroopia kasutamise kohta leiate nendest juhenditest: