AINovelLab项目打包指南：从源码到可执行文件的完整流程-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00202/article/details/148731565

AINovelLab项目打包指南：从源码到可执行文件的完整流程

AINovelLab 基于AI的小说处理工具，支持小说智能缩写/脱水、EPUB转换与分割等功能，让阅读更高效。项目地址: https://gitcode.com/gh_mirrors/ai/AINovelLab

项目概述

AINovelLab是一个基于Python开发的AI小说创作工具，它集成了多种自然语言处理技术，为小说创作者提供智能写作辅助功能。本文将详细介绍如何将AINovelLab项目从源代码打包成可执行文件的全过程，帮助开发者或技术爱好者完成项目部署。

环境准备

在开始打包前，需要确保开发环境满足以下要求：

Python环境：推荐使用Python 3.8或更高版本，这是项目开发和运行的基础环境
PyInstaller：版本5.13.0以上，这是我们将Python脚本转换为可执行文件的核心工具
项目依赖：通过requirements.txt文件安装所有必要的第三方库

安装命令如下：

pip install -r requirements.txt
pip install pyinstaller==5.13.2

打包流程详解

1. 使用预配置spec文件打包

AINovelLab项目已经提供了优化过的AINovelLab.spec配置文件，这是打包过程的核心文件。执行以下命令即可开始打包：

pyinstaller AINovelLab.spec

打包完成后，会在项目目录下生成两个新文件夹：

dist/AINovelLab：包含最终的可执行文件及所有依赖资源
build：临时构建文件，可安全删除

2. 打包结果处理

为方便分发，建议将生成的可执行文件目录压缩为ZIP包：

Windows系统：

Compress-Archive -Path dist/AINovelLab -DestinationPath dist/AINovelLab.zip

Linux/Mac系统：

cd dist && zip -r AINovelLab.zip AINovelLab

spec文件深度解析

AINovelLab.spec文件是PyInstaller打包的配置文件，它定义了如何将Python项目转换为独立可执行程序。以下是关键配置项的详细说明：

核心配置部分

a = Analysis(
    ['run.py'],  # 指定程序入口文件
    pathex=[],   # 额外Python路径
    binaries=[], # 需要包含的二进制文件
    datas=[      # 非Python资源文件
        ('resources', 'resources'),  # 格式：(源路径, 目标路径)
        ('data', 'data'),
        ('config', 'config'),
        ('api_keys.json', '.'),
        ('src', 'src'),
        ('src/gui', 'gui')
    ],
    hiddenimports=[  # 需要显式声明的隐式依赖
        'PyQt5', 'PyQt5.QtWidgets', 'PyQt5.QtCore', 'PyQt5.QtGui',
        'ebooklib', 'ebooklib.epub', 'bs4', 'bs4.builder',
        'tqdm', 'requests', 'lxml'
    ],
    # 其他配置项保持默认即可
)

可执行文件配置

exe = EXE(
    a.scripts,  # 继承Analysis的脚本配置
    a.binaries,
    a.zipfiles,
    a.datas,
    name='AINovelLab',  # 输出文件名
    debug=False,        # 是否包含调试信息
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,           # 是否使用UPX压缩
    console=False,      # 是否显示控制台窗口
    icon='resources/icon.ico'  # 程序图标
)

高级配置技巧

1. 添加新资源文件

当项目新增资源文件时，需要更新spec文件的datas列表：

datas=[
    ('new_resources/images', 'images'),  # 目录
    ('config/settings.ini', 'config'),   # 单个文件
]

2. 处理动态导入

对于使用importlib等动态导入的模块，必须显式声明：

hiddenimports=[
    'module.dynamically.imported',
    'another.hidden.module'
]

3. 平台特定配置

macOS注意事项：

需要指定目标架构
可能需要处理签名问题

exe = EXE(
    target_arch='x86_64',  # 或'arm64'用于Apple Silicon
    codesign_identity=''   # 开发者证书ID
)

Linux注意事项：

可能需要处理动态库依赖
注意文件权限设置

版本管理与发布

建议在打包前更新版本信息文件src/version.py：

VERSION = "1.2.3"              # 语义化版本号
VERSION_INFO = (1, 2, 3)       # 版本元组
BUILD_DATE = "2023-11-15"      # 构建日期
BUILD_TYPE = "release"         # 构建类型：release/beta/alpha/dev