Ledger Device App在模拟器及真机侧载时遇到的问题

Wed, 15 Apr 2026 10:54:59 +0800

ledger算是硬件钱包这个细分领域的No1了，但实际的使用中仍然遇到了很多问题，discord官方频道，推特，邮件，官方文档，具体交流等等。我踩了很多坑，这里总结下，给后续的开发者一些借鉴。

说明

我自己在实际使用中用到的机型Nano S Plus和Nano X，当然Nano X是不支持侧载的。
关于Ledger的完整介绍文章，可以查看Ledger Device App开发指南，这里不再赘述了。

真机侧载

侧载机型支持情况

Ledger Device App的真机侧载并非所有机型都支持，正如上面所提到的。具体支持机型如何查看呢。

查官网，有相关说明如下：

To load your app onto a Ledger device (also known as “sideloading”) and conduct real-world testing, select Load app on device. Bear in mind that sideloading is not possible on Nano X.
通过VSC下官方插件-Ledger Dev Tools，如果是选中了具体设备，侧载的按钮禁用还是启用其实就能看出来了.

侧载运行环境

官方VSC插件-Ledger Dev Tools
- ledger关键词插件很多，注意不要下载错误。
Docker，需要启动保持运行中
- Docker安装跟着官网指南即可，Mac下推荐走App安装方案。
点击插件，首次加载，会拉取ledger-app-dev-tools镜像并启动容易，该镜像大小大概为8.51GB

docker pull ghcr.io/ledgerhq/ledger-app-builder/ledger-app-dev-tools

中国大陆网络环境下如果拉取GitHub官方容器镜像比较慢，可以考虑使用国内的镜像源，比如ghcr.nju.edu.cn。如果本身电脑就是down不下来，可以考虑其它设备传输过去，不过目前看最终插件都会去下载最新版的也就是tag是latest的镜像。

侧载测试操作OS

Ubuntu等Linux发行版系统
MacOS
Windows,应该是最难的。

Ubuntu

Ubuntu下Docker不要使用snap安装的版本，直接从官网下载安装包安装即可，否则会遇到权限问题，导致侧载无法正常运行。

MacOS

如果仅仅只是为了检测联通性，执行如下脚本

pip install ledgerblue


from ledgerblue.comm import getDongle
from ledgerblue.commException import CommException

try:
 dongle = getDongle(debug=True)
 # GET VERSION APDU on the dashboard
 result = dongle.exchange(bytes.fromhex("e001000000"))
 print("Connected! Response:", result.hex())
 dongle.close()
except CommException as e:
 print(f"APDU error (SW=0x{e.sw:04X}): {e.message}")
except Exception as e:
 print(f"Unable to connect: {e}")

我自己实际去跑侧载，S Plus在Sequoia 15.5及以上版本的MacOS都不可以，都会出现不识别。结论

写在最后

总的来说，Ledger Device App的侧载虽然提供了一个很好的测试环境，但在实际使用中仍然存在一些问题和限制。希望通过这篇文章能够帮助开发者更好地理解和解决这些问题，提高开发效率和用户体验。

Sideloading | 进击之路 - Alan的个人博客

Ledger Device App在模拟器及真机侧载时遇到的问题