Download the latest release build for your platform from the releases page and run it.
yarn && yarn electron-dev
Changes to the display process (the things in src/) will automatically trigger a reload. Changes
to the main process (the things in public/) will require a manual restart to be reflected.
There are three versions of the updater: Mac OS, Linux, and Windows. You must build on the host OS for the app you're packaging.
The macos build requires that the app be signed. As of 10.14.5, the app must also be notarized by Apple. The build process will do this automatically but you must configure the build machine with the following:
1. A Developer ID signing certificate must be added to the key store. This is typically done by signing into your developer account via the Xcode GUI.
2. You must set the following environment variables where XXXXX is the your developer ID and YYYYY is an app-specific password.
export APPLEID="XXXXX"
export APPLEIDPW= "YYYYY"
Build the app on a Windows machine.
Build the app on a Linux machine.
nvm use
rm -rf build dist node_modules
yarn install --frozen-lockfile
yarn electron-pack
This will create installer and app images for the host OS you're on in /dist.
The KeepKey Updater will automatically grab what's in the latest parameter block in releases.json. To release a new version of either of these:
-
Get hashes for the firmware and/or signed bootloader:
- Firmware: Use the SHA-256 hash of firmware.keepkey.bin
openssl dgst -sha256 -r firmware.keepkey.bin | cut -d ' ' -f 1
- Bootloader: Use the double-SHA-256 of bootloader.bin (*not* blupdater.bin).
openssl dgst -sha256 -binary bootloader.bin | openssl dgst -sha256 -r | cut -d ' ' -f 1
-
Drop a hash+version keypair in
releases.json, following the existing pattern. Updatelatestversion as appropriate. -
Commit changes to
releases.json, plus new binary image files in a subdirectory offirmware. -
Run
deploy_ipns.sh, providing the path to an IPNS keyfile and a web3.storage API key as parameters. -
Done.