在 Windows 11 與 Ubuntu Linux 24.04 上，使用 PyInstaller 把 PySide2 圖形介面程式打包成單一檔案的執行檔。範例程式沿用 QT-PySide2 專案以 Qt Designer 設計的視窗——按下按鈕會在文字方塊寫入「Hello World!」——並加上打包步驟，產生 model/release/main（Windows 為 main.exe）。
重要：PySide2 只提供 Python 3.7 至 3.10 的安裝檔（wheel）。請先安裝這個範圍內的 Python 版本，再執行 01_venv_create；更新的 Python 版本必須把程式改寫成 PySide6。
[資料夾結構]
- CLAUDE.md / AGENT.md：程式規格書（內容相同）。
- CHANGELOG.md：變更紀錄。
- copyright.txt：版權聲明。
- model/release/：打包步驟產生的執行檔。
- src/UI.ui：Qt Designer 的版面設計檔，src/UI.py 由它產生。
- src/：主程式、release.py、啟動腳本與本說明文件。
- venv/：Python 虛擬環境，由步驟 1 建立。
[執行環境需求]
- 作業系統：Windows 11 或 Ubuntu Linux 24.04。
- Python 3.7 至 3.10——PySide2 沒有提供更新版本的安裝檔。
- Python 套件：PySide2 與 pyinstaller，由步驟 1 自動安裝。
- 需要桌面環境，因為範例會開啟視窗；不需要 GPU。
- Ubuntu 另需安裝 Qt Designer 的相依函式庫：sudo apt install libqt5designercomponents5。
[操作步驟及說明]
步驟 1：建立虛擬環境
建立虛擬環境，並安裝 src/requirements.txt 裡的套件（PySide2、pyinstaller）。請先確認目前使用的 Python 版本在 3.7 至 3.10 之間，否則 PySide2 會安裝失敗。
Windows 11：
src\01_venv_create.bat
Ubuntu Linux 24.04：
bash src/01_venv_create.sh
步驟 2：啟動虛擬環境
在目前的命令列視窗啟動虛擬環境。Linux 必須用 source 執行，啟動狀態才會在腳本結束後繼續保留。
Windows 11：
src\02_venv_activate.bat
Ubuntu Linux 24.04：
source src/02_venv_activate.sh
步驟 3：用 Qt Designer 開啟版面
用 Qt Designer 開啟 src/UI.ui，以視覺化的方式檢視或修改視窗版面。如果只想直接執行現成的範例，這一步可以略過。
Windows 11：
src\03_open_designer.bat
Ubuntu Linux 24.04：
bash src/03_open_designer.sh
步驟 4：把版面轉成 Python 程式
把 src/UI.ui 轉換成 src/UI.py。每次在 Designer 修改版面之後都要重新執行這一步——因為程式匯入的是產生出來的 .py 檔，不是 .ui 檔。
Windows 11：
src\04_ui_to_py.bat
Ubuntu Linux 24.04：
bash src/04_ui_to_py.sh
步驟 5：執行程式
用 Python 執行程式。畫面會開啟一個視窗，按下按鈕會在文字方塊寫入「Hello World!」。先在這裡確認程式正常，再進行打包。
Windows 11：
src\05_run.bat
Ubuntu Linux 24.04：
bash src/05_run.sh
步驟 6：打包成執行檔
用 PyInstaller 進行打包。完成後會在 model/release/main（Windows 為 model/release/main.exe）產生單一檔案的執行檔，可在沒有安裝 Python 的電腦上直接執行。
Windows 11：
src\06_release.bat
Ubuntu Linux 24.04：
bash src/06_release.sh
步驟 7：移除虛擬環境
使用完畢後，刪除 venv/ 資料夾以釋放磁碟空間。需要時再重新執行步驟 1 即可。
Windows 11：
src\99_venv_clear.bat
Ubuntu Linux 24.04：
bash src/99_venv_clear.sh
[使用說明]
- Linux 以 pip 安裝 PySide2 時：pyside2-designer 需要一個 wheel 沒有內含的系統 Qt 函式庫，執行 sudo apt install libqt5designercomponents5 即可解決 libQt5DesignerComponents.so.5 的錯誤；只執行程式本身則不需要它。
- PySide2 只提供 Python 3.7 至 3.10 的安裝檔，請先安裝這個範圍內的 Python 再執行 01_venv_create；更新的 Python 版本必須改寫成 PySide6。
- 執行檔與作業系統綁定，請在各個目標平台上分別打包。
- SDK 內附的 model/release/main.exe 是 2022 年的 Windows 舊版本；執行步驟 6 會重新打包並覆蓋它。
- 在 Designer 做的修改，要等步驟 4 重新產生 src/UI.py 之後才會生效。
這個 SDK 內建於 MYAI Studio 人工智慧開發工具。
單獨購買價格：5,000元，永久授權，單一 SDK 授權，單機授權，一次下載，無更新服務，一年電子郵件範例諮詢服務。如果是軟體客製化問題，請購買我們的客製化顧問服務點數。