PyInstaller
мощный инструмент для упаковки Python-приложений в исполняемые файлы. Параметры для создания исполняемого файла зависят от конкретного проекта, но есть несколько общих рекомендаций, которые помогут оптимизировать процесс сборки.
Основные параметры:
- --onefile: Собирает всё в один исполняемый файл.
- --noconsole: Отключает консольное окно (для GUI-приложений).
- --icon: Устанавливает иконку для исполняемого файла.
- --add-data: Добавляет дополнительные данные (например, файлы конфигурации).
- --hidden-import: Явно указывает на скрытые зависимости.
- --upx-dir: Указывает на директорию с UPX (инструментом для сжатия исполняемых файлов).
Пример команды с оптимальными параметрами:
pyinstaller --onefile --noconsole --icon=path/to/icon.ico --add-data="data_dir;data_dir" --hidden-import=hidden_module script.py
Объяснение параметров:
--onefile
: Собирает всё в один исполняемый файл.--noconsole
: Подходит для GUI-приложений, чтобы не показывалась консоль.--icon=path/to/icon.ico
: Устанавливает иконку для исполняемого файла.--add-data="data_dir;data_dir"
: Включает дополнительную директорию данных. В Windows используется;
, а в Linux:
.--hidden-import=hidden_module
: Явно добавляет зависимости, которые не удалось автоматически определить.
Некоторые дополнительные параметры, которые могут быть полезны:
--name=имя
: Задает имя исполняемого файла.--clean
: Удаляет временные файлы перед сборкой.--upx-dir=path/to/upx
: Указывает путь к UPX для сжатия исполняемых файлов, что помогает уменьшить их размер.
Пример полной команды:
pyinstaller --onefile --noconsole --icon=icon.ico --add-data="config.json;." --hidden-import=requests --clean --name=my_application --upx-dir=/path/to/upx script.py
Эти параметры помогут создать оптимальный исполняемый файл для вашего проекта.
Установка PyInstaller
Установка PyInstaller проста и выполняется с помощью pip
, стандартного пакетного менеджера для Python. Для установки PyInstaller выполните следующую команду:
pip install pyinstaller
Если у вас возникнут проблемы с правами доступа, используйте --user
для установки в локальную директорию пользователя:
pip install --user pyinstaller
После установки вы можете проверить, что PyInstaller установлен правильно, вызвав команду pyinstaller
в командной строке:
pyinstaller --version
Это должно вывести текущую версию PyInstaller, подтверждая, что установка прошла успешно.