Konwertuj PY na EXE

Użytkownik systemu Windows może potrzebować uruchomić program Python bez instalowania Python ani jego pakietów. Spakowanie programu jako EXE tworzy dystrybuowalną aplikację Windows, ale nie sprawia, że program staje się przenośny na inne systemy operacyjne.

Czym jest format PY

.py to rozszerzenie pliku źródłowego programów Python. Deweloperzy tworzą pliki PY w edytorach i środowiskach IDE, takich jak Visual Studio Code, PyCharm, IDLE lub Notepad++, a następnie uruchamiają je za pomocą interpretera Python albo importują jako moduły.

Plik PY zawiera czytelny kod źródłowy Python, a nie plik wykonywalny Windows. Jego uruchomienie zwykle wymaga zgodnej wersji Python oraz wszystkich zależności używanych przez program, takich jak requests, PyQt6 lub pandas. Z tego formatu powszechnie korzystają deweloperzy Python, analitycy danych, autorzy automatyzacji oraz deweloperzy aplikacji desktopowych.

Czym jest format EXE

.exe to standardowe rozszerzenie nazwy pliku wykonywalnego Windows, zwykle korzystającego z formatu Windows Portable Executable. Windows może uruchomić plik EXE bezpośrednio, dlatego odbiorcy zazwyczaj nie potrzebują osobnej instalacji Python, gdy interpreter, biblioteki i pliki aplikacji zostały dołączone podczas pakowania.

Pakowanie do EXE sprawdza się w przypadku narzędzi desktopowych, aplikacji graficznych, narzędzi wewnętrznych i instalatorów. EXE jest zwykle przeznaczony wyłącznie dla Windows; jego utworzenie nie tworzy aplikacji dla macOS, Linux, Android ani aplikacji webowej.

Jak utworzyć EXE za pomocą PyInstaller

1. Użyj komputera deweloperskiego z systemem Windows oraz wersją Python i architekturą wymaganymi przez aplikację. Jeśli to możliwe, utwórz i aktywuj środowisko wirtualne, a następnie zainstaluj zależności aplikacji i PyInstaller:

python -m pip install -r requirements.txt
python -m pip install pyinstaller

2. Otwórz terminal w katalogu projektu zawierającym skrypt wejściowy:

cd C:\path\to\project

3. Utwórz aplikację konsolową jako jeden plik:

pyinstaller --onefile app.py

Plik wykonywalny jest zwykle tworzony jako dist\app.exe. Bez --onefile PyInstaller tworzy dystrybucję katalogową zawierającą EXE i jego zależności. Forma katalogowa zwykle uruchamia się szybciej i jest łatwiejsza do diagnozowania; forma jednoplikowa jest prostsza do skopiowania, ale podczas uruchamiania rozpakowuje dołączone komponenty do katalogu tymczasowego.

4. W przypadku aplikacji graficznej, która nie powinna otwierać okna konsoli, ustaw nazwę i opcjonalną ikonę:

pyinstaller --onefile --windowed --name MyProgram --icon app.ico app.py

Podczas diagnozowania błędów używaj kompilacji konsolowej. --windowed ukrywa konsolę, więc komunikaty wyświetlane przez program nie są już widoczne w terminalu.

5. Przetestuj dist\MyProgram.exe na czystym komputerze z systemem Windows lub maszynie wirtualnej. Komputer deweloperski może ukrywać brakujące pliki, ponieważ ma już zainstalowane pakiety Python, zmienne środowiskowe lub katalogi projektu.

Dołączanie plików i importy dynamiczne

PyInstaller wykrywa wiele standardowych importów, ale dynamicznie ładowane moduły, szablony, obrazy, pliki konfiguracyjne, wtyczki i inne zasoby mogą wymagać jawnego określenia opcji. W systemie Windows dodaj katalog zasobów za pomocą:

pyinstaller --onefile --add-data "assets;assets" app.py

Średnik oddziela ścieżkę źródłową od ścieżki docelowej w systemie Windows; podczas kompilacji na macOS lub Linux użyj dwukropka. Dodaj moduł pominięty podczas automatycznej analizy za pomocą --hidden-import package_name. Aby zapewnić powtarzalność kompilacji, przeanalizuj wygenerowany plik app.spec, edytuj jego ustawienia danych i ukrytych importów, a następnie skompiluj go za pomocą pyinstaller app.spec.

Narzędzia graficzne i alternatywne

auto-py-to-exe to graficzny interfejs dla PyInstaller. Zainstaluj go i uruchom za pomocą:

python -m pip install auto-py-to-exe
auto-py-to-exe

Wybierz skrypt, wybierz Onefile lub One Directory, wybierz Console Based lub Window Based, dodaj pliki danych i ikonę, a następnie użyj Convert .py to .exe. Interfejs wygeneruje polecenie PyInstaller, które można zachować w skrypcie kompilacji.

cx_Freeze to kolejna lokalna opcja pakowania. Zainstaluj ją za pomocą python -m pip install cx-Freeze i skonfiguruj skrypt wejściowy, dołączone pakiety, pliki oraz typ bazowy w udokumentowanej konfiguracji kompilacji. Zwykle tworzy ona dystrybucję katalogową zamiast takiego samego przepływu pracy z jednym plikiem, jaki jest powszechnie używany w PyInstaller.

Konwertery działające w przeglądarce są nieodpowiednie dla większości plików PY: wymagają przesłania kodu źródłowego, nie potrafią niezawodnie odtworzyć środowiska wirtualnego projektu ani natywnych zależności i mogą ujawnić dane uwierzytelniające lub zastrzeżoną logikę. W przypadku prywatnych projektów lub projektów z dużą liczbą zależności używaj lokalnie PyInstaller, auto-py-to-exe lub cx_Freeze zamiast niezweryfikowanej usługi internetowej.

Ograniczenia zgodności i bezpieczeństwa

Pakowanie nie jest konwersją kodu źródłowego ani kompilacją do uniwersalnie przenośnego kodu natywnego. PyInstaller dołącza kod bajtowy Python, interpreter, biblioteki natywne i pliki aplikacji do pliku EXE lub sąsiedniego katalogu dystrybucyjnego. Dołączony kod bajtowy można często wyodrębnić lub przeanalizować, dlatego EXE nie zapewnia niezawodnej ochrony kodu źródłowego.

Twórz osobną kompilację dla każdego docelowego systemu operacyjnego: EXE dla Windows nie działa natywnie na macOS ani Linux. Kompiluj dla zgodnej architektury Windows i przed pakowaniem zainstaluj skompilowane zależności dla tej samej wersji Python i tej samej architektury. Kompilacja 64-bitowa zwykle nie może działać w 32-bitowym systemie Windows.

Aplikacje jednoplikowe mogą uruchamiać się wolniej, ponieważ rozpakowują się podczas uruchamiania, i mogą powodować fałszywe ostrzeżenia programów antywirusowych. Podpisywanie kodu zaufanym certyfikatem może ograniczyć ostrzeżenia bezpieczeństwa systemu Windows, ale nie gwarantuje akceptacji przez programy antywirusowe. Jeśli wymagają tego pakiety dołączone do aplikacji, dołącz licencję i informacje o zależnościach.