Εγκαθιστώντας το nitropy με pipx#

Αυτός ο οδηγός εξηγεί πώς να εγκαταστήσετε το nitropy με pipx. pipx δημιουργεί ένα εικονικό περιβάλλον για το nitropy. Αυτό σημαίνει ότι το nitropy και οι εξαρτήσεις του δεν έρχονται σε σύγκρουση με άλλα πακέτα που είναι εγκατεστημένα στο σύστημά σας.

Σημείωση

Για τους χρήστες των 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 για περισσότερες πληροφορίες.

Σημείωση

Για χρήστες Linux - επί του παρόντος μια παροδική εξάρτηση (oscrypto) δημιουργεί προβλήματα σε ορισμένες διανομές Linux. Το αντίστοιχο θέμα GitHub τεκμηριώνει την επί του παρόντος αναγκαία λύση:

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

Εγκατάσταση#

Τώρα μπορείτε να εγκαταστήσετε το nitropy από το πακέτο pynitrokey:

pipx install pynitrokey

Το nitropy είναι τώρα διαθέσιμο στη διαδρομή σας:

nitropy --help

Αναβάθμιση#

Μπορείτε να αναβαθμίσετε το πακέτο με την ακόλουθη εντολή:

pipx upgrade pynitrokey

Αντιμετώπιση προβλημάτων#

Αν αντιμετωπίσετε προβλήματα, βεβαιωθείτε ότι χρησιμοποιείτε την τελευταία έκδοση, συγκρίνοντας την έξοδο του nitropy version με τη λίστα εκδόσεων ` <https://github.com/Nitrokey/pynitrokey/releases>`_ στο 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#

Η υποστήριξη των Windows είναι ακόμα πειραματική - παρακαλούμε χρησιμοποιήστε την με προσοχή.

Ίσως χρειαστεί να εκτελέσετε το nitropy με δικαιώματα διαχειριστή για να μπορέσετε να συνδεθείτε σε μια συσκευή.

Linux#

Στα συστήματα Linux, χρειάζεστε επίσης τους κανόνες udev του Nitrokey. Αυτοί παραδίδονται με το libnitrokey. Εναλλακτικά, μπορείτε να τους εγκαταστήσετε χειροκίνητα:

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

Δείτε το Ρύθμιση των κανόνων udev για περισσότερες πληροφορίες.

Επόμενα βήματα#

Μπορείτε να βρείτε περισσότερες πληροφορίες σχετικά με τη χρήση της νιτροπίας σε αυτούς τους οδηγούς: