包管理¶
安装带有 mip
的软件包¶
网络功能板包括 mip
模块,它可以安装来自:term: micropython-lib
和第三方网站(包括GitHub)的软件包。
mip
(“mip安装包”)在概念上类似于Python的 pip
工具,但它不使用PyPI索引,而是默认使用:term: micropython-lib
作为其索引。 mip
将自动获取编译过的 .mpy file 从micropython-lib下载时。
使用 mip
的最常见方法来自REPL:
>>> import mip
>>> mip.install("pkgname") # Installs the latest version of "pkgname" (and dependencies)
>>> mip.install("pkgname", version="x.y") # Installs version x.y of "pkgname"
>>> mip.install("pkgname", mpy=False) # Installs the source version (i.e. .py rather than .mpy files)
mip
将通过搜索 sys.path
来检测文件系统上的适当位置,查找以 /lib
结尾的第一个条目。您可以使用 target
覆盖目标,但请注意,此路径必须在 sys.path
中才能随后导入。:
>>> mip.install("pkgname", target="third-party")
>>> sys.path.append("third-party")
除了从micropython-lib索引下载包外, mip
也可以安装第三方库。最简单的方法是直接下载文件:
>>> mip.install("http://example.com/x/y/foo.py")
>>> mip.install("http://example.com/x/y/foo.mpy")
当直接安装文件时,仍然支持 target
参数来设置目标路径,但 mpy
和 version
将被忽略。
URL也可以以 github:
开头,作为指向托管在github上的内容的简单方式:
>>> mip.install("github:org/repo/path/foo.py") # Uses default branch
>>> mip.install("github:org/repo/path/foo.py", version="branch-or-tag") # Optionally specify the branch or tag
更复杂的包(即包含多个文件或依赖项的包)可以通过指定其 package.json
的路径来下载。
>>> mip.install("http://example.com/x/package.json")
>>> mip.install("github:org/user/path/package.json")
如果没有指定json文件,则 “package.json” 被隐式添加:
>>> mip.install("http://example.com/x/")
>>> mip.install("github:org/repo") # Uses default branch of that repo
>>> mip.install("github:org/repo", version="branch-or-tag")
在Unix移植版本上使用 mip
¶
在Unix移植版本上,mip
可以如上所述在REPL中使用,也可以使用 -m
:
$ ./micropython -m mip install pkgname-or-url
$ ./micropython -m mip install pkgname-or-url@version
参数 --target=path
、--no-mpy
和 --index
被设置:
$ ./micropython -m mip install --target=third-party pkgname
$ ./micropython -m mip install --no-mpy pkgname
$ ./micropython -m mip install --index https://host/pi pkgname
使用 mpremote
安装软件包¶
mpremote 工具还包括与 mip
相同的功能,可以从主机PC安装软件包到本地连接的设备(例如通过USB或UART):
$ mpremote mip install pkgname
$ mpremote mip install pkgname@x.y
$ mpremote mip install http://example.com/x/y/foo.py
$ mpremote mip install github:org/repo
$ mpremote mip install github:org/repo@branch-or-tag
参数 --target=path
、--no-mpy
和 --index
被设置:
$ mpremote mip install --target=/flash/third-party pkgname
$ mpremote mip install --no-mpy pkgname
$ mpremote mip install --index https://host/pi pkgname
手动安装软件包¶
软件包也可以通过手动将文件复制到设备中来安装(以.py或.mpy形式)。根据主板的不同,这可能是通过USB大容量存储, mpremote 工具(例如 :mpremote fs cp path/to/package.py:package.py
), webrepl 等。
编写和发布软件包¶
发布到 micropython-lib 是让MicroPython用户广泛访问您的包的最简单方法,并且可以通过 mip
和 mpremote
自动获得并编译为字节码。更多信息请参见https://github.com/micropython/micropython-lib。
要编写可以通过 mip
或 mpremote
下载的“自托管”包,您需要一个静态web服务器(或GitHub)来托管单个.py文件或与.py文件一起的 package.json
文件。
一个典型的 package.json
文件,例如用于 mlx90640
库的示例,可能如下所示:
{
"urls": [
["mlx90640/__init__.py", "github:org/micropython-mlx90640/mlx90640/__init__.py"],
["mlx90640/utils.py", "github:org/micropython-mlx90640/mlx90640/utils.py"]
],
"deps": [
["collections-defaultdict", "latest"],
["os-path", "latest"],
["github:org/micropython-additions", "main"]
],
"version": "0.2"
}
这包括两个文件,托管在名为 org/micropython-mlx90640
的GitHub repo中,它们安装到设备上的 mlx90640
目录中。它依赖于 collections-defaultdict
和 os-path
,它们将从:term:micropython-lib
自动安装。第三个依赖项根据GitHub repo org/micropython-additions
的 main
分支中的 package.json
文件定义的内容进行安装。
冷冻包¶
当从设备文件系统导入一个Python模块或包时,它会在RAM中编译成 字节码,准备由虚拟机执行。对于 .mpy 文件,这个转换已经完成,但字节码仍然会在RAM中。
对于低内存设备或大型应用程序,将字节码从ROM(即闪存)运行可能更有利。这可以通过将字节码“冻结”到MicroPython固件中来完成,然后将其闪存到设备中。运行时性能是相同的(尽管导入更快),但它可以释放大量RAM供你的程序使用。
这种方法的缺点是开发速度会慢得多,因为每次都必须闪存固件,但它仍然可以用于冻结不经常更改的依赖项。
冻结通过编写清单文件并在构建中使用它来完成,通常作为自定义板定义的一部分。有关更多信息,请参阅 MicroPython清单文件 指南。