Převod souboru PY do EXE

Uživatel systému Windows může potřebovat spustit program v Pythonu bez instalace Pythonu nebo jeho balíčků. Zabalení programu jako EXE vytvoří distribuovatelnou aplikaci pro Windows, neumožní však její přenositelnost do jiných operačních systémů.

Co je formát PY

.py je přípona zdrojových souborů programů v Pythonu. Vývojáři píší soubory PY v editorech a IDE, jako jsou Visual Studio Code, PyCharm, IDLE nebo Notepad++, a poté je spouštějí pomocí interpretu Pythonu nebo je importují jako moduly.

Soubor PY obsahuje čitelný zdrojový kód Pythonu, nikoli spustitelný soubor Windows. Jeho běžné spuštění obvykle vyžaduje kompatibilní verzi Pythonu a všechny závislosti používané programem, například requests, PyQt6 nebo pandas. Tento formát běžně používají vývojáři Pythonu, datoví analytici, autoři automatizace a vývojáři desktopových aplikací.

Co je formát EXE

.exe je obvyklá přípona názvu souboru spustitelného souboru Windows, který obecně používá formát Windows Portable Executable. Windows může EXE spustit přímo, takže příjemci obvykle nepotřebují samostatnou instalaci Pythonu, pokud jsou s ním zabaleny také interpreter, knihovny a soubory aplikace.

Balení do EXE je vhodné pro desktopové nástroje, grafické aplikace, interní nástroje a instalátory. EXE je obvykle specifický pro Windows; jeho vytvořením nevznikne aplikace pro macOS, Linux, Android ani web.

Jak vytvořit EXE pomocí PyInstaller

1. Použijte vývojový počítač s Windows a verzí a architekturou Pythonu požadovanou aplikací. Pokud je to možné, vytvořte a aktivujte virtuální prostředí a poté nainstalujte závislosti aplikace a PyInstaller:

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

2. Otevřete terminál v adresáři projektu obsahujícím vstupní skript:

cd C:\path\to\project

3. Vytvořte konzolovou aplikaci jako jeden soubor:

pyinstaller --onefile app.py

Spustitelný soubor se obvykle vytvoří jako dist\app.exe. Bez --onefile vytvoří PyInstaller distribuční adresář obsahující EXE a jeho závislosti. Adresářová forma se obvykle spouští rychleji a snáze se diagnostikuje; forma s jedním souborem se snadněji kopíruje, ale při spuštění rozbalí zabalené komponenty do dočasného adresáře.

4. U grafické aplikace, která nemá otevírat okno konzoly, nastavte název a volitelnou ikonu:

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

Při diagnostice chyb používejte sestavení s konzolou. --windowed konzolu skryje, takže zprávy vytištěné programem již nebudou v terminálu viditelné.

5. Otestujte dist\MyProgram.exe na čistém počítači s Windows nebo ve virtuálním počítači. Vývojový počítač může chybějící soubory skrývat, protože na něm již jsou nainstalovány balíčky Pythonu, proměnné prostředí nebo adresáře projektu.

Vložení souborů a dynamické importy

PyInstaller rozpozná mnoho běžných importů, ale dynamicky načítané moduly, šablony, obrázky, konfigurační soubory, pluginy a další prostředky mohou vyžadovat explicitní volby. V systému Windows přidejte adresář s prostředky pomocí:

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

Středník v systému Windows odděluje zdrojovou cestu od cílové cesty; při sestavování v systému macOS nebo Linux použijte dvojtečku. Modul, který automatická analýza přehlédla, přidejte pomocí --hidden-import package_name. Pro opakovatelná sestavení prohlédněte vygenerovaný soubor app.spec, upravte jeho nastavení dat a skrytých importů a sestavte jej pomocí pyinstaller app.spec.

Grafické a alternativní nástroje

auto-py-to-exe je grafické rozhraní pro PyInstaller. Nainstalujte a spusťte jej pomocí:

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

Vyberte skript, zvolte Onefile nebo One Directory, vyberte Console Based nebo Window Based, přidejte datové soubory a ikonu a poté použijte Convert .py to .exe. Rozhraní vygeneruje příkaz PyInstalleru, který lze zachovat v sestavovacím skriptu.

cx_Freeze je další možnost místního balení. Nainstalujte jej pomocí python -m pip install cx-Freeze a v jeho zdokumentované konfiguraci sestavení nastavte vstupní skript, zahrnuté balíčky, soubory a typ základny. Obvykle vytváří distribuční adresář namísto stejného pracovního postupu s jedním souborem, který se běžně používá s PyInstallerem.

Převodníky fungující v prohlížeči nejsou pro většinu souborů PY vhodné: vyžadují nahrání zdrojového kódu, nedokážou spolehlivě reprodukovat virtuální prostředí projektu ani nativní závislosti a mohou odhalit přihlašovací údaje nebo proprietární logiku. U soukromých projektů nebo projektů s mnoha závislostmi používejte místní PyInstaller, auto-py-to-exe nebo cx_Freeze namísto neověřené online služby.

Omezení kompatibility a zabezpečení

Balení není převod zdrojového kódu ani kompilace do univerzálně přenositelného nativního kódu. PyInstaller zabalí bytecode Pythonu, interpreter, nativní knihovny a soubory aplikace do EXE nebo do přilehlého distribučního adresáře. Zabalený bytecode lze často extrahovat nebo prohlížet, takže EXE nepředstavuje spolehlivou ochranu zdrojového kódu.

Pro každý cílový operační systém sestavujte samostatně: EXE systému Windows nativně neběží v systému macOS ani Linux. Sestavujte pro kompatibilní architekturu Windows a před balením nainstalujte zkompilované závislosti pro stejnou verzi a architekturu Pythonu. 64bitové sestavení obecně nelze spustit v 32bitovém systému Windows.

Aplikace s jedním souborem se mohou spouštět pomaleji, protože se při spuštění rozbalují, a mohou vyvolávat falešně pozitivní upozornění antiviru. Podepsání kódu důvěryhodným certifikátem může omezit bezpečnostní upozornění Windows, nemůže však zaručit přijetí antivirem. Pokud to balíčky zahrnuté v aplikaci vyžadují, připojte licenci a oznámení o závislostech.