Aplicabilidade

Este artigo é aplicável a usuários que precisam instalar e executar o OneKey App em sistemas Linux.

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

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

Em sistemas Linux, as regras udev são usadas para permitir que o sistema identifique corretamente a carteira de hardware OneKey. Independentemente de você usar Snap ou AppImage, é recomendável concluir esta etapa primeiro.

Baixe e instale 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, você pode executar primeiro:

sudo apt update 
sudo apt install curl

Recarregue as regras udev:

sudo udevadm control --reload-rules sudo udevadm trigger

Desconecte e reconecte a carteira de hardware OneKey e, em seguida, abra o OneKey App.

Método 1: Instalação via Snap

Instale o Snap:
```
sudo apt update 
sudo apt install snapd
```
Se você estiver usando outra distribuição Linux, consulte a documentação oficial do Snap para instalar o snapd.
Instale o OneKey App:
```
sudo snap install onekey-wallet
```
Você também pode acessar a página da loja Snap para instalar: https://snapcraft.io/onekey-wallet
Permita que o OneKey App acesse dispositivos USB:
```
sudo snap connect onekey-wallet:raw-usb
```
Abra o OneKey App e selecione conectar carteira de hardware.

Se a versão Snap não iniciar

Se um erro semelhante ao seguinte aparecer durante a inicialização:

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

Isso geralmente indica que dependências de biblioteca gráfica estão faltando no pacote Snap atual.

Como o Snap usa um mecanismo de isolamento de sandbox, mesmo se você instalar o libgbm1 no sistema host, o aplicativo Snap pode não conseguir ler a biblioteca gráfica do host.

Se você encontrar esse problema, recomendamos usar temporariamente a versão AppImage ou aguardar a OneKey atualizar o pacote de instalação do Snap antes de usar a versão Snap.

Método 2: Baixar e executar o AppImage

Acesse o site oficial da OneKey para baixar o arquivo AppImage para Linux: https://onekey.so/download
Instale as dependências necessárias para o AppImage:
Para sistemas Ubuntu / Debian, você pode executar:
```
sudo apt update sudo apt install libfuse2
```
Se o seu sistema informar que o libfuse2 não foi encontrado, instale o pacote correspondente de acordo com as instruções de dependência AppImage / FUSE da sua distribuição atual.
Navegue até o diretório onde o arquivo AppImage está localizado, por exemplo:
```
cd ~/Downloads
```
Conceda permissão de execução ao AppImage:
```
chmod +x OneKey-Wallet-*.AppImage
```
Execute o 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 padrão restrições mais rígidas de namespace de usuário não privilegiado. Alguns aplicativos AppImage podem falhar ao iniciar devido a falhas na inicialização do sandbox do Electron / Chromium.

Se um erro semelhante ao seguinte aparecer ao executar o AppImage:

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

ou se houver um aviso de anomalia de permissão do chrome-sandbox, você pode tentar iniciar usando o seguinte comando:

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

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

Perguntas Frequentes

O AppImage indica falta de X Server ou DISPLAY

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

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

A carteira de hardware ainda não é reconhecida após a configuração das regras udev

Verifique os seguintes itens em ordem:

Se você já desconectou e reconectou a carteira de hardware
Se você já executou sudo udevadm control --reload-rules
Se você já executou sudo udevadm trigger
Se o OneKey App já obteve permissão de acesso USB

Se você estiver usando a versão Snap, confirme se já executou:

sudo snap connect onekey-wallet:raw-usb

Como instalar o OneKey App no Linux