和做工厂系统的印尼老哥,复刻了一套属于 MicroPython 的包管理系统

0 阅读5分钟

当 MicroPython 开发者还在反复切换网页、复制mpremote mip install命令安装包时,一场跨越国界的技术协作,正在悄悄改变这一繁琐现状。我们团队深耕 MicroPython 生态,维护的 uPyPi 仓库已收录 173 个各类驱动包,却始终被 “命令行安装” 这一痛点困扰 —— 而这,也恰好触动了远在东南亚的印尼开发者 Ali。

67d72c3f3b00abf685613ed1a2e25a58.png

从 Linux 系统管理起步,深耕全栈开发,再到专注 ESP32 嵌入式开发、自研东南亚小型工厂操作系统,Ali 的技术之路,始终围绕 “实用、高效” 展开。长期关注 uPyPi 生态的他,深知开发者手动复制命令、排查依赖的无奈,于是主动携手我们,共同打造了thonny-upypi-manager插件,将 uPyPi 的包管理功能直接集成到 Thonny IDE 中,彻底告别命令行的繁琐,让 MicroPython 包管理变得简单、高效,也让这场跨越国界的技术共鸣,落地成实实在在的开发工具。

零、前言

在 MicroPython 的开发过程中,第三方驱动库是实现传感器交互、通信协议、界面控制等功能的核心依赖。为了给开发者提供一个集中、规范的包分享平台,我们团队维护了​uPyPi 仓库​—— 目前这里已经收录了 173 个各类 MicroPython 包,覆盖传感器驱动、通信模块、人机交互等多个场景,解决了大家 “找包难、找包乱” 的问题。 image.png

不过目前,大多数开发者使用 uPyPi 包的方式,还是需要从仓库页面复制 mpremote mip install 命令,再手动粘贴到终端执行安装。这个过程不仅要处理串口连接、命令格式,还得自己排查依赖问题,对新手非常不友好,也拉低了开发效率。 image.png

为了彻底解决这个痛点,我们开发了 thonny-upypi-manager 这个 Thonny IDE 插件 —— 它把 uPyPi 仓库的包管理功能直接集成到了 Thonny 里,不用再打开网页复制命令,也不用手动处理依赖,在 IDE 内就能完成从搜索、查看、缓存到一键安装的全流程。

一、插件介绍

thonny-upypi-manager 是我们专为 Thonny IDE 打造的第三方插件,核心作用是对接我们团队维护的​**uPyPi(MicroPython 风格包仓库)**​,实现 MicroPython 包的全流程可视化管理,适配 Thonny 4.1.7 及以上版本。 image.png

简单来说,它就是 uPyPi 仓库的 “Thonny 客户端”,让你不用再切换网页、复制终端命令,在 IDE 里就能搞定所有包管理操作。 image.png

Github 源代码地址:github.com/FreakStudio…

它的功能覆盖了包管理的全流程,能解决开发中的多个痛点:

  • ✅ ​包搜索与元数据查看​:直接在 Thonny 内搜索 uPyPi 上的所有包,还能查看每个包的 package.json 信息(版本、作者、依赖项),不用再切换到网页端查询。
  • ✅ ​本地缓存管理​:支持多文件包的本地缓存,下载过的包会自动存到本地,重复使用时无需重新下载。
  • ✅ ​一键安装到开发板​:通过 mpremote 工具,直接把包安装到连接的 MicroPython 开发板的 /lib 目录,省去手动复制文件的步骤。
  • ✅ ​自动依赖处理​:会读取包的 package.jsondeps 字段,在安装主包前自动安装所有依赖项,不用再手动挨个找依赖。
  • ✅ ​错误友好提示​:遇到网络不通、mpremote 未配置、开发板未连接等问题时,会给出清晰的提示,帮你快速定位和解决问题。

image.png

PyPI 地址:pypi.org/project/tho…

这个插件的源码由 Freak 嵌入式工作室维护,托管在 GitHub 仓库中,目前是 Thonny 端最便捷的 MicroPython 包管理工具之一,后续也会持续更新维护,优化功能和兼容性。

二、插件安装

插件提供了两种安装方式:​从 PyPI 在线安装​(适合网络环境正常的情况,简单快捷)和​从本地文件安装​(适合网络受限的情况,提前下载好安装包),你可以根据自己的情况选择其中一种。

image.png

首先启动 Thonny IDE,点击顶部菜单栏的【工具】,选择【管理插件...】(部分版本翻译为 “管理软件包”),即可打开插件管理窗口。

image.png

2.1 从 PyPI 安装

这是最推荐的安装方式,全程仅需几步操作,无需手动处理文件:

image.png

在插件管理窗口的搜索框中,输入插件名 thonny-upypi-manager,点击右侧的【在 PyPI 上搜索】按钮,稍等片刻就能看到搜索结果。

注意,有时候由于网络问题,会导致搜索不到,隔几分钟以后再次搜索就可以,如果还是不行,本地安装!

image.png

在搜索结果列表中找到 thonny-upypi-manager,点击后会显示插件的详细信息(版本、作者、依赖要求等),此时点击窗口下方的【安装】按钮,即可自动完成下载和安装。

image.png

安装完成后,插件管理窗口的左侧列表会出现 thonny_upypi_manager,此时​必须关闭并重新打开 Thonny​,插件才能正常生效。

image.png

image.png

重启后,你会在 Thonny 的工具栏看到插件的专属图标,说明安装成功。

image.png

image.png

后续内容包括插件的本地安装和使用以及注意事项,可以查看链接:f1829ryac0m.feishu.cn/wiki/EteGwu…

image.png

eb6b459ccb3f99726a2fd06d98170352.png

e56a916b375ed771aab3187baee81773.png