在 Linux 中使用 Wine 打包 Python Windows 可執行檔

前言

在Linux系統中，開發Python跨平台應用會面臨到一個問題：儘管PyInstaller是一個方便的工具來打包Python程式成為可執行檔（exe），但它無法直接在Linux環境下生成Windows的可執行檔。這是由於PyInstaller在打包過程中需要依賴系統相關的動態連結庫，而Linux與Windows的系統架構和函式庫明顯不同，導致無法跨平台進行編譯和打包。

為了解決這個問題，PyInstaller官方建議開發者在Linux中使用Wine來模擬Windows環境。Wine是一個開源的兼容層，可以讓Linux使用者執行Windows應用程式，藉此可以在模擬的Windows環境中進行打包作業。具體來說，使用者需要在Wine環境中安裝Windows版的Python，例如python-3.8.9-amd64，並在該環境下使用PyInstaller進行編譯，這樣才能成功生成適用於Windows的可執行檔。

接下來的部分將詳述如何在Linux中透過Wine安裝Windows版的Python，並使用PyInstaller打包Python程式為Windows的exe檔。

步驟一：安裝 Wine

Wine 是一個在 Linux 上執行 Windows 應用程式的開源工具。它不是一個虛擬機，而是允許直接在 Linux 上執行 Windows 應用程式。

sudo dpkg --add-architecture i386
sudo apt update
sudo apt install wine wine32 wine64

步驟二：安裝Xvfb模擬X server

在Linux環境中，Wine有時需要X server來啟動圖形介面。為了避免直接連接到實際顯示器，這裡使用Xvfb來模擬一個虛擬的X server。執行以下指令安裝Xvfb：

sudo apt install xvfb -y

安裝完成後即可啟動Xvfb，啟動一個虛擬X server，解析度設置為1024x768，並且色深設置為16位元：

Xvfb :0 -screen 0 1024x768x16 &
jid=$!

此命令將Xvfb以背景程序運行，jid=$!則會保存這個背景程序的進程ID，以便之後關閉。

步驟三：下載Windows版Python安裝程式

接下來，我們需要從Python官網下載對應的Windows版本安裝程式。這裡選擇python-3.8.9-amd64.exe：

wget https://www.python.org/ftp/python/3.8.9/python-3.8.9-amd64.exe

目前筆者測試過可以支援的版本：

3.7.6
3.8.9

步驟四：設定Wine環境

使用Wine來模擬一個Windows環境。在這步驟，我們透過以下指令啟動並設定Wine的基本配置：

WINEPREFIX=~/.wine WINARCH=win64 winecfg

或是也可以下載 winetricks，安裝必要的字型（如corefonts）並將系統版本設置為Windows 10(此步驟非必要)。

WINEPREFIX=~/.wine WINARCH=win64 winetricks corefonts win10

步驟五：安裝Windows版Python

透過以下指令，在Wine環境中安裝Windows版的Python（靜默安裝並將Python加入系統路徑）：

DISPLAY=:0.0 WINEPREFIX=~/.wine wine cmd /c python-3.8.9-amd64.exe /quiet PrependPath=1 && echo "Python Installation complete!"

安裝完成後，您應該會看到「Python Installation complete!」的訊息。

步驟六：安裝PyInstaller

接下來，使用Wine中的Python來安裝PyInstaller。執行以下指令：

wine pip install pyinstaller

步驟七：使用PyInstaller打包Python程式

現在可以使用PyInstaller將您的Python程式打包為Windows可執行檔（exe）。假設您的Python程式檔案名稱為main.py，可以執行以下指令進行打包：

wine pyinstaller --onefile main.py

這將會在dist資料夾中生成一個單一的exe檔案。

完整指令

以下是完整的操作指令。透過這一系列步驟，您可以在Linux環境中使用Wine來模擬Windows環境，並成功將Python程式打包為Windows可執行檔。

# 安裝 Wine
sudo dpkg --add-architecture i386
sudo apt update
sudo apt install wine wine32 wine64
# 安裝Xvfb
sudo apt install xvfb -y
Xvfb :0 -screen 0 1024x768x16 &
jid=$!
# 下載Windows版Python安裝程式
wget https://www.python.org/ftp/python/3.8.9/python-3.8.9-amd64.exe
# 設定Wine環境
WINEPREFIX=~/.wine WINARCH=win64 winecfg
# 安裝Windows版Python
DISPLAY=:0.0 WINEPREFIX=~/.wine wine cmd /c python-3.8.9-amd64.exe  /quiet  PrependPath=1  && echo "Python Installation complete!"
# 安裝PyInstaller並打包應用
wine pip install pyinstaller
wine pyinstaller --onefile main.py

Reference

鼓勵持續創作，支持化讚為賞！透過下方的 Like 拍手👏，讓創作者獲得額外收入~

版主10在2020年首次開設YouTube頻道，嘗試拍攝程式教學。想要了解更多的朋友歡迎關注我的頻道，您的訂閱就是最大的支持～如果想學其他什麼內容也歡迎許願XD

https://www.youtube.com/channel/UCSNPCGvMYEV-yIXAVt3FA5A

1010Code