manylinux 开源项目教程

1. 项目目录结构及介绍

在manylinux项目中，主要的目录结构如下：

• docs: 包含项目的文档资料。
• docker: 存放构建Docker镜像所需的脚本和配置。
• scripts: 提供用于构建Python wheel包的脚本工具。
• .github: GitHub操作相关的设置，如工作流（workflows）配置。
• .travis.yml: Travis CI的配置文件，用于自动化测试和构建。

此项目提供了一系列基于旧版CentOS的Docker镜像，这些镜像是为了使Python扩展能够在多种Linux发行版上兼容而设计的。通过Docker环境，开发者可以在一个标准化的环境中编译C或C++扩展，确保生成的轮子文件能在大多数现代Linux系统上运行。

2. 项目启动文件介绍

虽然manylinux不是一个传统的可执行项目，但其核心在于使用Docker镜像进行编译工作。启动这些镜像通常涉及以下步骤：

1. 拉取Docker镜像：例如，获取manylinux2014_x86_64镜像，可以通过运行：

   docker pull quay.io/pypa/manylinux2014_x86_64
   

2. 启动Docker容器：然后在一个交互式会话中运行这个镜像：

   docker run --rm -it quay.io/pypa/manylinux2014_x86_64 /bin/bash
   

   这将打开一个命令行提示符，你可以在这个环境中构建你的Python扩展。

3. 构建Python扩展：使用scripts目录下的工具，比如build-wheel.sh，来创建兼容的wheel包。

3. 项目的配置文件介绍

项目的主要配置文件是docker/Dockerfile系列文件，它们定义了如何构建各个版本的Docker镜像。每个Dockerfile包含了安装依赖、配置环境以及添加构建脚本等指令。

• DockerfileTEMPLATE: 一个模板文件，其它Dockerfile通常基于这个模板进行定制。
• Dockerfile_x86_64, Dockerfile_i686, ...: 对应不同架构的Dockerfile，如x86_64（64位）、i686（32位）等。

此外，.travis.yml文件用于Travis CI的持续集成设置，它定义了构建流程，包括下载源代码、构建Docker镜像和运行测试等步骤。

为了自定义构建过程，你需要修改的是Dockerfile中的软件包列表和安装步骤，以及脚本文件（如scripts/build-wheel.sh）中的编译选项。如果你需要为特定项目调整许多Linux环境，你应该根据需求调整这些配置文件。