0 Fork 0

Files

T

QwejayHuang 448dbdbbf3 v2.8.0: Add project directory support, improve dependency resolution, and fix syntax injection

- Added direct project directory drag-and-drop support with automatic root workspace and requirements.txt detection
- Added smart entry script prioritization and interactive selection dialog for multi-script projects
- Expanded AST dependency analysis across the entire project workspace to capture sub-package imports
- Implemented local module and resource whitelisting to prevent unintended pip installations of local packages
- Expanded PyPI mappings and Auto-Hooks rules for C extensions and dynamic libraries (PyCryptodome, NaCl, pynput, etc.)
- Added automatic search path injection (`--paths` for PyInstaller and `PYTHONPATH` for Nuitka) for sub-directory entries
- Improved `requirements.txt` parser to safely handle inline comments and environment markers
- Added cross-hierarchy import detection and workspace configuration tips for standalone scripts
- Fixed SyntaxError caused by console pause code injection preceding `from __future__` statements
- Fixed TypeError crash caused by `os.walk` iteration variable shadowing the global translation function
Update QUICKSTART.md、README.MD...

2026-08-31 19:57:05 +08:00

14 KiB

Raw Blame History

QPyPack

Современный кроссплатформенный GUI-инструмент для упаковки Python-приложений
_{На базе PyInstaller и Nuitka, с визуальной конфигурацией, статическим анализом зависимостей и автоматизацией сборки.}

📌 Обзор проекта (Overview)

QPyPack — это графический кроссплатформенный инструмент для упаковки Python-приложений. Благодаря глубокой интеграции двух компиляторов — PyInstaller (бандлинг байт-кода) и Nuitka (нативная компиляция в C/C++) — сложные параметры командной строки, отслеживание неявных зависимостей, изоляция сред и сбор ресурсов объединены в удобном интерфейсе.

От простых скриптов автоматизации до сложных приложений (с PySide6/PyQt, Playwright, CustomTkinter, FastAPI и др.) — QPyPack гарантирует стабильную сборку с высоким процентом успеха на Windows, macOS и Linux.

📸 Скриншоты (Screenshots)

🛠️ Архитектура и ключевые возможности

1. Двойной движок сборки и оптимизация бинарных файлов

Плавное переключение движков:
- PyInstaller: Высокая скорость сборки, отсутствие потребности в C-компиляторе, отличная совместимость.
- Nuitka: Транслирует Python-код напрямую в C/C++ бинарники, обеспечивая высокую скорость выполнения, стойкость к декомпиляции и компактный размер.
LTO-оптимизация и обрезка модулей: Поддержка оптимизации на этапе компоновки (--lto=yes) в режиме Lite. Автоматическое исключение неиспользуемых тяжелых субмодулей Qt (WebEngine, 3D, Quick и др.).
Гибкие форматы сборки: Поддержка режимов одного файла (--onefile) и директории (--onedir), а также настройка внутреннего каталога зависимостей (--contents-directory).

2. Статический анализ и защита зависимостей

Рекурсивный AST-анализ: Встроенный анализатор абстрактного синтаксического дерева (AST) на чистом Python, определяющий явные и неявные импорты без запуска кода.
Интеллектуальное сопоставление пакетов: Встроенная таблица соответствия имён импорта и пакетов PyPI (например, cv2 \to opencv-python, PIL \to pillow, win32com \to pywin32) с возможностью расширения.
Динамическая изоляция устаревших бэкпортов: Автоматически блокирует устаревшие backport-модули, конфликтующие со стандартной библиотекой (например, изоляция pathlib или typing в Python 3.10+).

3. Автоматизация окружения и отказоустойчивость

Автоматическое управление компиляторами C/C++: Определяет установленные MSVC, Clang (LLVM) и GCC. При отсутствии компилятора Nuitka автоматически загружает MinGW-w64.
Управление виртуальными окружениями: Поддержка изолированных и общих виртуальных сред, а также встроенная утилита очистки старых сред.
Адаптивный контроль ресурсов и самовосстановление:
- Оценивает ОЗУ и диск перед сборкой, автоматически снижая параллелизм потоков при нехватке памяти.
- Перехватывает ошибки нехватки памяти (ZstdError / OOM) и автоматически перезапускает сборку в однопоточном режиме.
- Обходит временные блокировки файлов антивирусами и облачными дисками.

4. Подпись кода и пресеты проектов

Умная цифровая подпись: Автоматически подписывает исполняемые файлы Windows через Authenticode (Signtool/PowerShell с меткой времени RFC 3161) и выполняет codesign в macOS.
Генератор сертификатов: Встроенный инструмент создания самоподписанных сертификатов (.pfx) и поддержка коммерческих ключей.
Импорт/экспорт пресетов: Сохраняет все параметры сборки и списки ресурсов в файлы .qpypack.

5. Кроссплатформенный интерфейс и локализация

Удобный Drag & Drop: При перетаскивании скрипта автоматически извлекаются метаданные (__version__, __author__), определяется точка входа и подбирается иконка.
Векторная графика и поддержка HiDPI: Построен на векторных иконках Google Material SVG, отлично масштабируется на экранах 4K. Переведён на 17 языков (русский, английский, китайский, японский, корейский, немецкий, французский, испанский и др.).

📊 Сравнение движков (PyInstaller vs. Nuitka)

Критерий	PyInstaller	Nuitka
Принцип работы	Упаковывает интерпретатор Python + байт-код (`.pyc`)	Компилирует Python в нативные C/C++ бинарники
Скорость сборки	Очень высокая (10 – 60 сек)	Более медленная (генерация C++ и компиляция)
Компилятор C/C++	Не требуется	Требуется (MSVC / GCC / Clang / MinGW-w64)
Защита кода	Базовая (исходники можно извлечь декомпилятором)	Максимальная (машинный код, защита от реверс-инжиниринга)
Производительность	Стандартная скорость Python	Быстрый запуск, ускорение циклов и вычислений
Рекомендуется для	Быстрого тестирования, внутренних утилит, динамических скриптов	Коммерческого ПО, защиты интеллектуальной собственности, оптимизации

⚡ Быстрый старт (Quick Start)

💡 Впервые используете QPyPack? Ознакомьтесь с 📖 Руководством по быстрому старту (QUICKSTART.md).

Способ 1: Установка через pip / pipx (Рекомендуется)

Требуется Python >= 3.8:

# Установка через pip
pip install qpypack

# Запуск приложения
qpypack

С современными пакетными менеджерами:

# Изолированный запуск через pipx
pipx run qpypack

# Быстрый запуск через uv
uvx qpypack

Способ 2: Готовые скомпилированные версии

Без предварительной настройки Python скачайте готовые исполняемые файлы со страницы релизов:

👉 Скачать релизы (GitHub Releases)

📋 Разрешение путей к ресурсам (`sys._MEIPASS`)

В режиме одного файла (--onefile) статические ресурсы (изображения, конфигурации, модели) распаковываются во временный каталог. Используйте следующий шаблон:

import sys
import os
from pathlib import Path

def get_asset_path(relative_path: str) -> Path:
    """Получение абсолютного пути к упакованным ресурсам."""
    if hasattr(sys, "_MEIPASS"):
        # Временная папка распаковки PyInstaller
        base_path = Path(sys._MEIPASS)
    elif "__compiled__" in globals():
        # Директория запуска бинарника Nuitka
        base_path = Path(sys.argv[0]).resolve().parent
    else:
        # Локальное окружение разработки
        base_path = Path(__file__).resolve().parent
    return base_path / relative_path

📅 История изменений (Changelog)

Подробный список изменений версий доступен в CHANGELOG.md.

💖 Участие и поддержка проекта

QPyPack — это проект с открытым исходным кодом. Если инструмент помог вам в разработке, вы можете поддержать автора:

🌟 Поставьте Star: Отметьте репозиторий звездой на GitHub.
🐛 Обратная связь: Создавайте тикеты на GitHub Issues.
⚡ Спонсорство: Поддержите автора через Afdian (爱发电) (WeChat Pay / Alipay).

📄 Лицензия (License)

Проект распространяется под лицензией GNU General Public License v3.0 (GPL-3.0).

Important

Авторские права на собранные приложения: Права интеллектуальной собственности и лицензия на созданные вами приложения полностью принадлежат вам. Лицензия GPL-3.0 проекта QPyPack не накладывает ограничений на созданные вами программы.

14 KiB Raw Blame History Unescape Escape