Sections in this article
This article explains how to run a Ledger Live dev app for iOS on macOS.
Connecting to Nano S / X
In this part, we’ll connect a Ledger Nano S to the application, using the ledger-live-common proxy feature.
You need nvm to install and use node version 12. Installation details are here.
Once installed, open a new terminal and type:
nvm install 12 (if not already done) nvm use 12
Then clone the ledger-live-common repo:
git clone https://github.com/LedgerHQ/ledger-live-common cd ledger-live-common/cli yarn
Now, launch the ledger-live-common proxy command:
node bin/index.js proxy
The expected output is:
- Open the LL [DEV] application on the simulator
- Choose “Ledger Nano X” as the device (even if you’re going to use a Nano S)
- “Use initialized device” […] → Settings
- On the Ledger logo, click very rapidly until the “Debug” menu appears (a mouse is recommended, as it’s virtually impossible with a trackpad).
- Go to “Debug http transport” and copy-paste the IP address given previously by ledger-live-common
Once that is done, an onboarding page pops up.
- Connect your Nano, and choose the Ledger Nano X device once again
- Go through the setup
Congratulations! You have successfully connected your device
Testing on the Nano
- On your ledger-live-mobile directory, double-click on the ledgerlivemobile.xcworkspace file.
It opens XCode. Switch back to the Xcode toolchain (Xcode → Toolchains → Xcode xx.x)
You may want to change the default scheme to either build a debug or a release version (Product → Scheme → Edit Scheme…):
- Connect your device to your mac
- Select it as the target
You can try to launch a build. If it fails because of a problem with a certificate, then:
- Under the ledgerlivemobile menu, go to “Signing & Capabilities”
- Click “Revoke Certificate”, XCode will automatically create a new one
- Try to build it a second time. It works!
If you need to export the .ipa file, click on Product → Archive After the build is complete you should have this window displayed:
- Click on Distribute App → Development → Next → Automatically manage signing
- Export it to the folder you want to save it in.
You can then do without Xcode or a developer account to install the iOS app by using “Apple Configurator 2”. Download it from the Apple store.