Compilar la app

Compila en tu computadora la app de escritorio de OneKey a partir de su código fuente.

La app funciona en tu computadora, muestra tus saldos y prepara las transacciones. La compilas desde el código fuente por la misma razón que compilaste el firmware: para saber qué estás ejecutando.

Aquí lo adecuado es la app de escritorio. Incluye todo lo que necesita para comunicarse con tu billetera. La extensión del navegador y la app web cargan esa parte desde los servidores de OneKey cuando se ejecutan.

El único cambio

Cuando se conecta un dispositivo, la app de OneKey comprueba que lo haya fabricado OneKey. Tu dispositivo nunca pasará esa comprobación, porque solo la fábrica de OneKey puede darle a un dispositivo el certificado que pide. Por eso, antes de compilar, aplicas un cambio de una línea que se salta la comprobación. Puedes leer el cambio completo antes de aplicarlo: app-skip-genuine-check.patch.

Instalar las herramientas

Necesitas Git y Node.js versión 22 o 24, en una computadora Mac o Linux.

Instala las herramientas de línea de comandos de Apple, que incluyen Git. En Terminal, ejecuta xcode-select --install y sigue las instrucciones.
Instala Node.js 22 LTS o 24 LTS desde nodejs.org.

Instala Git y las herramientas de compilación habituales, por ejemplo en Debian o Ubuntu: sudo apt install -y git rsync build-essential python3 pkg-config libudev-dev.
Instala Node.js 22 LTS o 24 LTS, desde nodejs.org o desde tu distribución.

Cierra la ventana de terminal y abre otra, para que reconozca las herramientas nuevas.

Descargar el código fuente y aplicar el cambio

En tu computadora

git clone --depth 1 --branch v6.6.3 https://github.com/OneKeyHQ/app-monorepo.git
cd app-monorepo
git log -1 --format=%H

El último comando debería mostrar d510ab79e622ed042444940b8a848c1b1628ab68, el commit que OneKey publicó como v6.6.3.

En tu computadora

curl -fLO https://raw.githubusercontent.com/rayston92/firmware-classic1s/diy/diy/app-skip-genuine-check.patch
git apply app-skip-genuine-check.patch

git apply no muestra nada cuando funciona.

Compilar

Estos comandos descargan las bibliotecas de la app y la compilan. Cuenta con entre 30 minutos y una hora, y mantén cerrados otros programas pesados: la compilación usa mucha memoria.

En tu computadora

corepack enable
export ONEKEY_FONTS_FORCE_FALLBACK=1
yarn
cd apps/desktop
yarn build:renderer
yarn build:main
yarn install-app-deps

Si corepack enable responde permission denied (permiso denegado), ejecútalo como sudo corepack enable y continúa.

ONEKEY_FONTS_FORCE_FALLBACK le indica a la compilación que use la fuente de código abierto Inter, en lugar de intentar descargar la fuente de marca de OneKey, que tiene licencia y a la que no tienes acceso.

Ahora empaquétala como un programa que puedas abrir:

En tu computadora

npx electron-builder build --mac --dir --config electron-builder.config.js -c.mac.identity=null --publish never

La app está en apps/desktop/build-electron, en una carpeta cuyo nombre empieza por mac. Abre OneKey.app desde ahí. La primera vez, macOS puede decir que no puede verificar al desarrollador: haz clic derecho en la app, elige Abrir y luego otra vez Abrir.

En tu computadora

npx electron-builder build --linux --dir --config electron-builder.config.js --publish never
sudo cp public/static/udev/99-onekey.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules

La app es apps/desktop/build-electron/linux-unpacked/onekey-wallet. El segundo y el tercer comando le permiten abrir la conexión USB de la billetera sin ejecutarse como root.

Comprobación

La app se abre y muestra su pantalla de bienvenida. Déjala abierta para el siguiente paso.