Este guia demonstra o processo de instalação usando o sistema Ubuntu 22.04.3 LTS como exemplo.
Método 1: via Snap
Instale o snap:
sudo apt install snapdConsulte o link para instalar o snap em outros sistemas Linux: Referência
Instale o aplicativo OneKey de duas maneiras:
Abra o link: https://snapcraft.io/onekey-wallet e instale diretamente pela loja snap.
Instale usando a linha de comando:
sudo snap install onekey-wallet
Baixe e instale o bridge (Link para download)
Após o download, mude para o diretório onde o bridge está localizado e execute o seguinte comando para instalar:
sudo dpkg -i onekey-bridge-2.2.0-amd64.deb
Acesse o endereço http://127.0.0.1:21320/status/ no seu navegador para garantir que a página abra e mostre "Connected devices: 1".
Complete a instalação. Abra o OneKey App e selecione "Conectar carteira de hardware".
Método 2: Baixar e executar diretamente o AppImage
Baixar o arquivo AppImage.
Instale as dependências necessárias com o comando:
sudo apt-get install fuse libfuse. (Consulte o link para mais informações sobre dependências e sua instalação em diferentes sistemas)Vá para o diretório onde o arquivo AppImage está localizado e dê permissão de execução ao arquivo:
chmod +x OneKey-Wallet-4.18.0-linux-x86_64.AppImageExecute usando o usuário atual (não root):
./OneKey-Wallet-4.18.0-linux-x86_64.AppImage
Se você encontrar o erro "Missing X Server or $DISPLAY" durante a execução, instale os componentes relacionados ao ambiente gráfico. Para sistemas Ubuntu ou Debian, você pode instalar o xorg.
Solução para quando o Linux Mint não consegue detectar dispositivos de hardware
Ao usar uma carteira de hardware OneKey em um sistema Linux Mint, você precisa instalar regras UDEV para que o aplicativo possa conectar-se ao dispositivo corretamente.
1. Acesse https://data.onekey.so/onekey.rules e copie as regras UDEV.
2. Crie um novo arquivo em /etc/udev/rules.d/99-onekey.rules e cole as regras acima, depois salve-o.
3. Após concluir o passo anterior, execute o seguinte no terminal:
sudo udevadm control --reload-rules
Não altere manualmente as permissões de arquivos de dispositivo em /dev, como usar chmod ou chown.
Tais alterações são temporárias e não persistirão após um reinício ou ao reconectar o dispositivo, e afrouxar as permissões pode introduzir riscos de segurança.