Âmbito de aplicação

Este artigo aplica-se a utilizadores que necessitam de instalar e executar a OneKey App em sistemas Linux.

As dependências e as políticas de permissões podem variar entre as diferentes distribuições Linux. Este artigo utiliza os sistemas Ubuntu / Debian como exemplo principal, fornecendo também um método de configuração geral para as regras udev.

Preparação antes da instalação: Configurar as regras udev

Nos sistemas Linux, as regras udev são utilizadas para permitir que o sistema identifique corretamente a carteira de hardware OneKey. Quer utilize o Snap ou o AppImage, recomenda-se que conclua este passo primeiro.

Descarregar e instalar as regras udev da OneKey:

sudo curl -fsSL https://data.onekey.so/onekey.rules -o /etc/udev/rules.d/99-onekey.rules

Se o sistema não tiver o curl instalado, pode executar primeiro:

sudo apt update 
sudo apt install curl

Recarregar as regras udev:

sudo udevadm control --reload-rules sudo udevadm trigger

Desligue e volte a ligar a carteira de hardware OneKey e, em seguida, abra a OneKey App.

Método 1: Instalar via Snap

Instalar o Snap:
```
sudo apt update 
sudo apt install snapd
```
Se estiver a utilizar outra distribuição Linux, pode consultar a documentação oficial do Snap para instalar o snapd.
Instalar a OneKey App:
```
sudo snap install onekey-wallet
```
Também pode aceder à página da loja Snap para instalar: https://snapcraft.io/onekey-wallet
Permitir que a OneKey App aceda a dispositivos USB:
```
sudo snap connect onekey-wallet:raw-usb
```
Abra a OneKey App e selecione ligar a carteira de hardware.

Se a versão Snap não iniciar

Se ocorrer um erro semelhante ao iniciar:

error while loading shared libraries: libgbm.so.1: cannot open shared object file

Isto geralmente indica que faltam dependências de bibliotecas gráficas no pacote Snap atual.

Como o Snap utiliza um mecanismo de isolamento em sandbox, mesmo que instale o libgbm1 no sistema anfitrião, a aplicação Snap poderá não conseguir ler as bibliotecas gráficas do anfitrião.

Se encontrar este problema, recomenda-se que mude temporariamente para a versão AppImage ou aguarde que a OneKey atualize o pacote de instalação do Snap antes de o utilizar.

Método 2: Descarregar e executar o AppImage

Aceda ao site oficial da OneKey para descarregar o ficheiro AppImage para Linux: https://onekey.so/download
Instalar as dependências necessárias para o AppImage:
Nos sistemas Ubuntu / Debian, pode executar:
```
sudo apt update sudo apt install libfuse2
```
Se o seu sistema indicar que não consegue encontrar o libfuse2, instale o pacote correspondente de acordo com as instruções de dependência AppImage / FUSE da sua distribuição atual.
Navegue até ao diretório onde o ficheiro AppImage está localizado, por exemplo:
```
cd ~/Downloads
```
Atribuir permissões de execução ao AppImage:
```
chmod +x OneKey-Wallet-*.AppImage
```
Executar a OneKey App:
```
./OneKey-Wallet-*.AppImage
```

O que fazer se não iniciar no Ubuntu 24.04 ou superior

No Ubuntu 24.04 e versões superiores, o sistema ativa por predefinição restrições mais rigorosas para namespaces de utilizadores não privilegiados. Algumas aplicações AppImage podem falhar ao iniciar devido a falhas na inicialização da sandbox do Electron / Chromium.

Se ocorrer um erro semelhante ao executar o AppImage:

The SUID sandbox helper binary was found, but is not configured correctly

ou se for indicado um erro de permissão do chrome-sandbox, pode tentar iniciar com o seguinte comando:

./OneKey-Wallet-*.AppImage --no-sandbox

Certifique-se de que o comando é executado no diretório onde o ficheiro AppImage está localizado.

Perguntas Frequentes

O AppImage indica falta de X Server ou DISPLAY

Se encontrar um erro de falta de X Server ou de $DISPLAY ao executar, isso geralmente significa que o sistema atual carece de um ambiente de trabalho gráfico ou de componentes relacionados.

Para sistemas Ubuntu / Debian, pode instalar os componentes relacionados com o ambiente gráfico antes de tentar executar novamente.

A carteira de hardware continua sem ser reconhecida após configurar as regras udev

Por favor, verifique o seguinte por ordem:

Se já desligou e voltou a ligar a carteira de hardware
Se já executou sudo udevadm control --reload-rules
Se já executou sudo udevadm trigger
Se a OneKey App já tem permissão de acesso USB

Se estiver a utilizar a versão Snap, confirme se já executou:

sudo snap connect onekey-wallet:raw-usb

Como instalar a OneKey App no Linux