Die App bauen

Die App läuft auf deinem Computer, zeigt dein Guthaben an und bereitet Transaktionen vor. Du baust sie aus demselben Grund aus dem Quellcode wie die Firmware: damit du weißt, was du da ausführst.

Die Desktop-App ist hier die richtige Wahl. Sie bringt alles mit, was sie braucht, um mit deiner Wallet zu sprechen. Die Browser-Erweiterung und die Web-App laden diesen Teil erst beim Ausführen von den Servern von OneKey.

Die eine Änderung

Wenn sich ein Gerät verbindet, prüft die OneKey-App, ob OneKey es hergestellt hat. Dein Gerät fällt bei dieser Prüfung immer durch, weil nur die Fabrik von OneKey einem Gerät das verlangte Zertifikat geben kann. Deshalb wendest du vor dem Bauen eine einzeilige Änderung an, die die Prüfung überspringt. Du kannst die ganze Änderung lesen, bevor du sie anwendest: app-skip-genuine-check.patch.

Die Werkzeuge installieren

Du brauchst Git und Node.js in Version 22 oder 24, auf einem Mac oder einem Linux-Computer.

Installiere die Befehlszeilenwerkzeuge von Apple, zu denen Git gehört. Führ im Terminal xcode-select --install aus und folge den Anweisungen.
Installiere Node.js 22 LTS oder 24 LTS von nodejs.org.

Installiere Git und die üblichen Werkzeuge zum Bauen, zum Beispiel unter Debian oder Ubuntu: sudo apt install -y git rsync build-essential python3 pkg-config libudev-dev.
Installiere Node.js 22 LTS oder 24 LTS, von nodejs.org oder aus deiner Distribution.

Schließ das Terminal und öffne ein neues, damit es die neuen Werkzeuge findet.

Den Quellcode herunterladen und die Änderung anwenden

Auf deinem Computer

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

Der letzte Befehl sollte d510ab79e622ed042444940b8a848c1b1628ab68 ausgeben, den Commit, den OneKey als v6.6.3 veröffentlicht hat.

Auf deinem Computer

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 gibt nichts aus, wenn es funktioniert.

Bauen

Diese Befehle laden die Bibliotheken der App herunter und kompilieren sie. Rechne mit 30 Minuten bis einer Stunde und lass andere große Programme geschlossen: Das Bauen braucht viel Arbeitsspeicher.

Auf deinem Computer

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

Wenn corepack enable „permission denied“ meldet, führ es als sudo corepack enable aus und mach dann weiter.

ONEKEY_FONTS_FORCE_FALLBACK sorgt dafür, dass beim Bauen die Open-Source-Schrift Inter verwendet wird. Sonst würde versucht, die lizenzierte Markenschrift von OneKey herunterzuladen, auf die du keinen Zugriff hast.

Verpack sie jetzt als Programm, das du öffnen kannst:

Auf deinem Computer

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

Die App liegt in apps/desktop/build-electron, in einem Ordner, dessen Name mit mac beginnt. Öffne dort OneKey.app. Beim ersten Mal meldet macOS vielleicht, dass es den Entwickler nicht überprüfen kann: Klick mit der rechten Maustaste auf die App, wähle Öffnen und dann noch einmal Öffnen.

Auf deinem Computer

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

Die App ist apps/desktop/build-electron/linux-unpacked/onekey-wallet. Der zweite und der dritte Befehl sorgen dafür, dass sie die USB-Verbindung zur Wallet öffnen kann, ohne als root zu laufen.

Kontrollpunkt

Die App öffnet sich und zeigt ihren Begrüßungsbildschirm. Lass sie für den nächsten Schritt offen.