Instalação de nitropia Com pipx#

Este guia explica como instalar a nitropia com pipx. pipx cria um ambiente virtual para a nitropia. Isto significa que a nitropia e as suas dependências não entram em conflito com outros pacotes instalados no seu sistema.

Nota

Para utilizadores de Windows: O suporte de Windows ainda é experimental – por favor use com cautela. Também pode utilizar binários pré-compilados ou um instalador MSI, ver :doc:`…/windows/installation”.

Preparação#

Python 3.9, 3.10 or 3.11#

Python já está instalado na maioria dos sistemas MacOS e Linux ou pode ser descarregado de python.org. Ver o Downloading Python Guide para mais informações.

pip#

Pode instalar pip com o seu gestor de pacotes do sistema ou com python3 -m ensurepip`. Ver o guia de instalação de pip para mais informações.

pipx#

Antes de instalar a nitropia, é necessário instalar e configurar o pipx:

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

Ver o guia de instalação pipx para mais informações.

Nota

For Linux Users - currently a transient dependency (oscrypto) is generating issues on some Linux distrubutions. The respective GitHub issue documents the currently needed workaround:

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

Instalação#

Agora pode instalar nitropia a partir do pacote pynitrokey:

pipx install pynitrokey

a nitropia está agora disponível no seu caminho:

nitropy --help

Actualização#

Pode actualizar o pacote com o seguinte comando:

pipx upgrade pynitrokey

Resolução de problemas#

Se encontrar problemas, certifique-se de que utiliza a versão mais recente comparando a saída de >>x id=»105»></x>>x id=»120»></x> com a release list no GitHub. Se uma actualização não instalar a versão mais recente, pode estar a deparar-se com um dos seguintes problemas.

Wrong Python Version#

nitropy requires Python 3.9 or 3.10. If your default Python installation is older or newer than that and cannot be updated, you have to additionally install Python 3.9 and specify the name of its Python executable when calling pipx, for example:

$ pipx install --python python3.9 pynitrokey

Braço Não Suportado#

Currently, recent nitropy versions cannot be installed on Arm platforms due to a dependency issue (GitHub issue). As a workaround, you can use an x86 Python installation in a Rosetta terminal as described in this discussion).

libusb-1.0.dylib not found#

When running nitropy on macOS, you might see an error message indicating a missing libusb-1.0.dylib file. This can be fixed by manually installing libusb, e. g. with homebrew:

$ brew install libusb

Notas de utilização#

Todas as Plataformas#

Se quiser usar nitropia com um dispositivo Nitrokey Pro ou Nitrokey Storage, também tem de instalar libnitrokey.

Windows#

O suporte do Windows ainda é experimental – por favor use com cuidado.

Poderá ter de executar nitropia com direitos de administrador para se poder ligar a um dispositivo.

Linux#

Nos sistemas Linux, também precisa das regras da Nitrokey udev. Estas são enviadas com libnitrokey. Em alternativa, pode instalá-las manualmente:

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

Ver …/linux/udev para mais informações.

Próximos Passos#

Pode encontrar mais informações sobre a utilização da nitropia nestes guias: