GitHub Actions中Buildozer Docker镜像无法正常导入问题求助

修复步骤 #

1. 改用指定版本的Buildozer镜像 #

放弃latest标签，使用稳定版或具体版本号的镜像，避免标签更新引发的兼容性问题。修改build.yml中的Action配置：

- name: Build with Buildozer
  uses: ArtemSBulgakov/buildozer-action@v1
  with:
    image: kivy/buildozer:stable

2. 升级GitHub Runner的Docker版本 #

GitHub托管的Runner可能自带Docker版本过旧，不支持OCI格式的镜像层。在Job开头添加升级步骤：

- name: Update Docker
  run: |
    sudo apt-get update
    sudo apt-get install --only-upgrade docker-ce docker-ce-cli containerd.io

3. 手动拉取镜像后复用 #

先手动拉取兼容镜像，再让Action使用本地已有的镜像，跳过重复拉取步骤：

- name: Pull Buildozer image
  run: docker pull kivy/buildozer:stable

- name: Build with Buildozer
  uses: ArtemSBulgakov/buildozer-action@v1
  with:
    image: kivy/buildozer:stable
    pull_image: false

4. 切换到自托管Runner #

如果GitHub托管Runner的Docker环境始终有问题，试试用自己的机器搭建自托管Runner，确保Docker版本在20.10以上（该版本对OCI镜像支持更完善）。

5. 排查Buildozer配置 #

检查buildozer.spec文件：

• 确认android.ndk版本与所选镜像兼容
• 暂时注释掉自定义的镜像或依赖配置，排查是否是配置冲突导致的问题

手动安装Buildozer的注意点 #

如果选择手动安装，注意以下几点：

• 安装最新版Buildozer：pip install --upgrade buildozer
• 安装全系统依赖：sudo apt-get install python3-pip python3-dev git zip unzip openjdk-17-jdk
• 用buildozer init生成默认配置，避免手动修改出错

内容的提问来源于stack exchange，提问作者user23160500