PyOxidizer 教程：构建自包含的Python应用

PyOxidizer 教程：构建自包含的Python应用

项目地址:https://gitcode.com/gh_mirrors/py/PyOxidizer

1. 项目目录结构及介绍

PyOxidizer作为一个现代的Python应用打包和分发工具，其源代码托管在GitHub上。虽然具体的用户项目结构可能因应用场景而异，但PyOxidizer自身的仓库提供了以下关键目录和文件，用于指导开发和配置：

• root:
  • Cargo.toml: 是Rust项目的主要配置文件，定义了依赖项、版本及编译设置。
  • src: 包含PyOxidizer的核心代码，如主程序和各种功能模块。
  • docs: 文档目录，包括API说明或用户指南。
  • examples: 示例目录，提供给开发者如何使用PyOxidizer的示例项目。
  • pyoxidizer: 这里可能会有特定于PyOxidizer的Python脚本或配置。

对于用户创建的应用，PyOxidizer鼓励使用标准的Python项目布局，同时与PyOxidizer的配置文件一起，形成了构建过程的基础。

2. 项目的启动文件介绍

在传统意义上，PyOxidizer本身没有一个典型的“启动文件”作为应用程序运行的入口点。相反，它通过命令行工具pyoxidizer来被激活。当你安装PyOxidizer之后，主要通过这个命令来进行一系列操作，比如初始化新项目、配置和构建你的Python应用。尽管如此，对于开发者来说，他们的应用通常有一个main.py或类似命名的启动文件，该文件是应用逻辑的起点。

3. 项目的配置文件介绍

PyOxidizer的核心在于其灵活的配置机制，通常通过一个或多个.pyoxidizer.toml文件进行管理（或直接在pyproject.toml中指定PyOxidizer的相关部分）。这些配置文件定义了如何构建Python应用，包括但不限于：

• Python版本：指定要嵌入的Python解释器版本。
• 应用入口点：定义应用的主执行文件。
• 额外依赖：除了Python标准库外，可能需要的第三方包。
• 目标平台：指示构建的目标操作系统（如Windows、macOS或Linux）。
• 打包类型：支持生成可执行二进制、Windows的MSI安装包、macOS的应用程序包等。
• 环境变量和构建时选项，用来定制化构建流程。

例如，基础的.pyoxidizer.toml可能看起来像这样：

[python]
version = "3.x"

[[target]]
type = "standalone"
platform = "current"
entry_point = "myapp/main.py"

在实际应用中，开发者需根据项目需求调整上述配置参数，以确保PyOxidizer能够正确地编译和打包应用到所需的目标平台上。

请注意，具体配置细节可能随PyOxidizer版本更新而变化，建议总是参考最新的官方文档进行详细配置。

PyOxidizer A modern Python application packaging and distribution tool 项目地址: https://gitcode.com/gh_mirrors/py/PyOxidizer