PyInstaller позволяет превращать скрипты Python в автономные исполняемые файлы, но стандартная установка через pip может быть недоступна на системах с ограниченным доступом к интернету или без прав администратора. В таких случаях требуется загрузка исходного кода и ручная сборка.
Для работы PyInstaller без pip необходимо скачать архив с исходным кодом с официального репозитория на GitHub. Архив содержит все файлы, включая скрипты сборки и манифест зависимостей, что позволяет собрать инструмент локально. Обязательным условием является наличие установленного Python версии 3.6 и выше.
Перед сборкой важно проверить и установить вручную необходимые пакеты, такие как altgraph, pefile и pywin32-ctypes на Windows. На Linux потребуется убедиться, что доступны библиотеки для работы с ELF и совместимые версии libc. Пропуск этой стадии может привести к ошибкам при компиляции исполняемых файлов.
Скачивание исходного кода PyInstaller с официального репозитория
Исходный код PyInstaller доступен на GitHub по адресу https://github.com/pyinstaller/pyinstaller. Для загрузки используйте команду git clone https://github.com/pyinstaller/pyinstaller.git, что создаст локальную копию репозитория с последней стабильной версией. Если Git недоступен, можно скачать архив ZIP с раздела Releases.
После загрузки архива его необходимо распаковать в удобное для работы место на диске. Рекомендуется избегать путей с пробелами и кириллицей, чтобы не возникли ошибки при сборке и последующем создании исполняемых файлов.
Для работы с исходным кодом важно проверить версию Python на системе. PyInstaller поддерживает Python 3.6 и выше. Использование команд python —version или python3 —version позволяет убедиться в соответствии версии требованиям сборки.
Репозиторий содержит скрипты сборки, документацию и папку PyInstaller, в которой находятся ключевые модули. В дальнейшем все команды по созданию исполняемых файлов будут запускаться из корневой директории репозитория.
Установка зависимостей вручную для работы PyInstaller
PyInstaller требует нескольких сторонних библиотек для корректного функционирования. При отсутствии pip их необходимо установить вручную, скачав исходные архивы с официальных репозиториев или сайтов проектов.
Основные зависимости включают:
- altgraph – библиотека для работы с графами объектов Python, скачивается с https://pypi.org/project/altgraph/#files.
- pefile – инструмент для анализа и модификации PE-файлов на Windows, доступен на https://pypi.org/project/pefile/#files.
- pywin32-ctypes – упрощает взаимодействие с Windows API через ctypes, архивы находятся на https://pypi.org/project/pywin32-ctypes/#files.
На Linux дополнительно проверяются системные библиотеки:
- glibc и компиляторы для сборки ELF-файлов;
- libz, libssl и другие зависимости для упаковки и работы с архивами;
- установка через apt-get или yum выполняется по необходимости.
После скачивания архивы распаковываются в отдельную директорию. Для установки используется команда python setup.py install в каждой папке с библиотекой. Этот метод позволяет подготовить среду PyInstaller без использования pip.
Сборка PyInstaller из исходников с помощью Python
После загрузки исходного кода и установки зависимостей необходимо собрать PyInstaller локально. Перейдите в корневую директорию репозитория, где находится файл setup.py.
Для сборки используйте команду python setup.py install. Этот процесс компилирует все модули и создаёт исполняемые скрипты в папке dist. При ошибках проверьте, что все зависимости установлены и Python имеет доступ к системным библиотекам.
На Windows рекомендуется запускать команду из командной строки с правами администратора, чтобы обеспечить корректное создание pyi-archive_viewer.exe и других утилит. На Linux и macOS достаточно обычного пользователя, если доступ к каталогам Python не ограничен.
После завершения сборки в директории PyInstaller появятся все необходимые файлы для упаковки скриптов Python в исполняемые файлы без использования pip. Проверка работы выполняется командой python pyinstaller.py —version, которая должна вернуть номер текущей сборки.
Проверка корректности установки PyInstaller
Настройка окружения для запуска PyInstaller без pip
После сборки PyInstaller необходимо указать системе путь к исполнительным файлам, чтобы обращаться к инструменту из любой директории. Требуется добавить папку сборки в переменную PATH. Местоположение зависит от версии ОС.
| ОС | Путь к исполняемым файлам | Способ добавления |
|---|---|---|
| Windows | …\PyInstaller\dist\ | Через «Свойства системы» → «Переменные среды» |
| Linux | /usr/local/bin или каталог сборки | Редактирование ~/.bashrc или ~/.profile |
| macOS | /usr/local/bin или локальная директория | Изменение ~/.zshrc или ~/.bash_profile |
После добавления пути требуется перезапустить терминал. Проверка выполняется командой pyinstaller —help. Запуск команды без указания полного пути подтверждает успешную настройку окружения и доступность инструмента вне каталога исходников.
Создание первого исполняемого файла с помощью локальной сборки
Для проверки локально собранного PyInstaller создаётся простой файл demo.py с содержимым print(«PyInstaller работает»). Файл размещается в отдельной папке без пробелов в названии, чтобы исключить сбои при генерации путей.
Запуск упаковки выполняется командой pyinstaller demo.py или через прямой вызов файла pyinstaller.py из каталога исходников. В процессе формирования проекта появятся папки build и dist, а также файл спецификации demo.spec, который можно использовать для дальнейшей настройки сборки.
Вопрос-ответ:
Можно ли скачать PyInstaller без менеджера pip и чем это отличается от обычной установки?
Да, исходники PyInstaller доступны на GitHub. Отличие в том, что вместо автоматической загрузки зависимостей через pip их надо устанавливать вручную. Затем выполняется сборка через setup.py, и только после этого инструмент можно использовать.
Какие файлы должны появиться после успешной сборки PyInstaller?
После выполнения команды установки через setup.py формируются ключевые библиотеки и скрипты. В каталоге PyInstaller появляется исполняемый файл pyinstaller.py, а дополнительно формируются служебные утилиты. Если система обнаруживает все зависимости, ошибок сборки не будет.
Что сделать, если при сборке PyInstaller появляется ошибка об отсутствующей библиотеке?
Необходимо скачать архив нужной библиотеки с сайта проекта или из репозитория PyPI, распаковать и запустить установку через python setup.py install. После установки зависимость распознаётся системой, и сборку можно повторить. Так часто решается проблема с altgraph, pefile или pywin32-ctypes.
Можно ли запускать pyinstaller как обычную команду после локальной сборки?
Да, достаточно добавить путь к каталогу сборки в переменную PATH. Тогда pyinstaller можно вызывать из любой папки, а не только через прямое обращение к файлу pyinstaller.py. После изменения PATH терминал требуется перезапустить.
Загрузка...
