micropython/build-micropython-natmod-unix

MicroPython原生模块构建容器

镜像概述

该容器基于micropython/build-micropython-unix镜像构建，主要功能是添加构建MicroPython原生模块所需的Python库pyelftools，为x86架构下的MicroPython原生模块开发提供便捷的构建环境。

核心功能与特性

• 基础镜像：继承micropython/build-micropython-unix的全部功能，包含构建MicroPython的基础环境
• 依赖补充：通过apt安装python3-pip，并使用pip安装pyelftools库，满足原生模块构建的依赖需求
• 架构支持：专注于x86架构的MicroPython原生模块构建

使用场景

• 开发者在x86平台上开发、编译和测试MicroPython原生模块
• 需要统一构建环境以确保原生模块编译一致性的场景
• 作为CI/CD流程中的构建环节，自动化MicroPython原生模块的编译过程

使用方法

拉取镜像

bash
docker pull docker.xuanyuan.run/[镜像名称]  # 假设镜像已发布到容器仓库

运行容器

通过以下命令启动容器，进入交互式环境进行原生模块构建：

bash
docker run -it --rm [镜像名称] /bin/bash

在容器内可直接执行MicroPython原生模块的构建命令，例如：

bash
mpy-cross -march=x86 your_module.c

作为基础镜像构建自定义环境

可在Dockerfile中以该镜像为基础，添加更多项目特定依赖：

Dockerfile
FROM docker.xuanyuan.run/[镜像名称]

# 添加项目所需的其他依赖
RUN apt install -y [额外依赖包]
RUN pip install [额外Python库]

Dockerfile详情

该镜像的构建文件如下：

Dockerfile
FROM micropython/build-micropython-unix

RUN apt update
RUN apt install -y python3-pip
RUN pip install pyelftools