Pyinstaller
pyinstaller是python的一個第三方模塊,使用它可以將python程序打包為可執行文件,實現打包后的程序在沒有python環境的機器上也可以運行。pyinstaller的安裝方式可通過:pip installer pyinstaller
通常我們打包程序時,會遇到兩種情況:
情況一,打包一個python腳本文件;
情況二,打包一個python項目程序(包含多個文件夾、py文件,以及相關資源文件)
打包環境
- win10,64位
- python3.7
- pyinstaller3.6
pyInstaller提供了兩種不同的打包操作方式,可以實現上述兩種情況下的打包需求。下面分別描述之。
打包一個py腳本程序
對於只有一個python腳本的簡單程序,打包操作很方便,直接使用命令行的方式,輸入相關指令即可。
對於一個攝氏溫度轉華氏溫度的小程序(temp.py),我們可以這樣做:
# 攝氏溫度轉華氏溫度
temp = input("請輸入攝氏溫度:")
new_temp = 9/5 * int(temp) + 32
print(f"華氏溫度為:{new_temp}F")
q = input("按任意鍵退出:")
首先,打開終端cmd, 進入temp.py文件所在的路徑,輸入指令:pyinstaller -F temp.py
打包結束后,將在當前目錄下生成兩個文件夾(bulid、dist)和一個文件temp.spec
,現在不需要理會文件夾bulid
和文件temp.spec
我們需要的打包后的可執行文件在文件夾dist
中,雙擊即可運行,實現打包。
補充:如果想修改可執行文件的圖標,使用指令:pyinstaller -i icon.ico -F temp.py
打包結束后,在dist文件夾下降出現temp.exe。你可能會發現它的圖標並不是你想要的,這沒有關系,你將它重命名或者拷貝到其他地方,你會發現它的圖標立刻變成你期待的樣子,祝你好運。
打包一個py項目程序
對於常用到的py項目程序,包含許多文件夾和py文件,以及配套的資源文件。這種情況下在終端中使用指令的方式打包程序本身也是可以實現的,但是此時打包操作就變得非常復雜,它需要你理解不同指令參數的確切意思,時不時你將入坑爬不起來,苦不堪言。
這段時間使用pygame寫了一個像素鳥的游戲,想分享給別人體驗,就使用了pyinstaller將程序打包成exe文件。這里分享給大家,希望對你能有所幫助。
這種情況下,一個簡單的打包方式,就是通過pyinstaller提供的spec文件
實現程序打包。
下面通過一個基於pygame
實現的FlappyBird
介紹該項目的打包流程。
該項目包含六個文件夾,其中:bin、conf、core
包含所有的python腳本文件,項目入口程序在bin\setup.py
,所有音頻文件在audios文件夾下,所有的字體文件在fonts文件夾下,所有的圖片文件在images文件夾下。
第一步:打開終端進入FlappyBird路徑下,輸入指令:pyinstaller -F bin\setup.py
,回車,程序結束后,發現當前目錄下生成兩個文件夾(bulid、dist)和一個文件setup.spec
,現在刪除兩個文件夾,只保留setup.spec
文件。
setup.spec
# -*- mode: python ; coding: utf-8 -*-
block_cipher = None
a = Analysis(['bin\\setup.py'], # 此列表存放項目設計的所有python腳本文件
pathex=['C:\\Users\\15057\\Desktop\\FlappyBird'], # 此列表為項目絕對路徑
binaries=[],
datas=[], # 此列表存放所有資源文件,每個文件是一個2元組元素
hiddenimports=[],
hookspath=[],
runtime_hooks=[],
excludes=[],
win_no_prefer_redirects=False,
win_private_assemblies=False,
cipher=block_cipher,
noarchive=False)
pyz = PYZ(a.pure, a.zipped_data,
cipher=block_cipher)
exe = EXE(pyz,
a.scripts,
a.binaries,
a.zipfiles,
a.datas,
[],
name='setup', # 打包程序的名字
debug=False,
bootloader_ignore_signals=False,
strip=False,
upx=True,
upx_exclude=[],
runtime_tmpdir=None,
console=True )
# 此處console=True表示,打包后的可執行文件雙擊運行時屏幕會出現一個cmd窗口,不影響原程序運行
# 如果想要修改程序圖標,使用在EXE()中加入 icon='xxxxx', 切記:絕對路徑
第二步:修改setup.spec
文件,修改后的文件如下:
修改位置:
- 添加py_files列表,包含項目需要的所有python腳本
- 添加add_files列表,包含涉及到的所有資源文件,每個文件是2元組的形式存放
- name='FlappBird', 制定可執行程序名字
- console=False, 制定可執行程序執行時不顯示控制台窗口
- icon='C:\Users\15057\Desktop\FlappyBird\images\flappy.ico', 設置程序圖標,ico格式文件(16*16)
# -*- mode: python ; coding: utf-8 -*-
block_cipher = None
py_files = [
'bin\\setup.py',
'conf\\settings.py',
'core\\main.py',
'core\\base.py',
'core\\bird.py',
'core\\pipe.py',
'core\\score.py',
]
add_files = [
('fonts\\font.ttf', 'fonts'),
('images\\*.png', 'images'),
('images\\flappy.ico', 'images'),
('audios\\*.wav', 'audios'),
]
a = Analysis(py_files,
pathex=['C:\\Users\\15057\\Desktop\\FlappyBird'],
binaries=[],
datas=add_files,
hiddenimports=[],
hookspath=[],
runtime_hooks=[],
excludes=[],
win_no_prefer_redirects=False,
win_private_assemblies=False,
cipher=block_cipher,
noarchive=False)
pyz = PYZ(a.pure, a.zipped_data,
cipher=block_cipher)
exe = EXE(pyz,
a.scripts,
a.binaries,
a.zipfiles,
a.datas,
[],
name='FlappBird',
debug=False,
bootloader_ignore_signals=False,
strip=False,
upx=True,
upx_exclude=[],
runtime_tmpdir=None,
console=False,
icon='C:\\Users\\15057\\Desktop\\FlappyBird\\images\\flappy.ico' )
第三步:執行setup.spec
文件。項目路徑下輸入指令:pyinstaller -F setup.spec
,
回車,程序結束后,新增dist
文件夾,且該文件夾下新增FlappyBird.exe
,最終,打包結束。
補充
打包,可以使用許多指令,指令都差不多,不同的是使用不用的參數,如 -F、-i
等,不同的參數有不同的意義。這些可以在網上找到相關解釋說明,這里就贅述了。
值得說明的一點是,使用spec
文件打包程序時,使用-F
或者使用-w
,生成的spec文件內容有一點點不同。
這里大家注意即可,因為使用-F
打包時默認只生成一個單獨的可執行文件,如這里的FlappyBird.exe
; 而使用-w
打包時會生成一個文件夾,該文件夾里面包含一些庫文件和FlappyBird.exe
,這里的exe需要依賴這些庫文件,即資源文件。在生成的spec文件中,會多一點內容。但是基本不影響打包流程和打包思路。