pyinstaller簡潔教程
發布時間：2024-12-10 點擊：146
pyinstaller可以用來打包python應用程序，打包完的程序就可以在?有安裝python解釋器的機器上運行了。pyinstaller支持python 2.7和python 3.3 。可以在windows、mac os x和linux上使用，但是并不是跨平臺的，而是說你要是希望打包成.exe文件，需要在windows系統上運行pyinstaller進行打包工作；打包成mac app，需要在mac os上使用。
安裝
linux or mac
你可以從pypi上下載安裝，當然也可以使用pip或者easy_install來安裝。
1 2 3 pip install pyinstaller or easy_install pyinstaller 版本更新
1 2 3 pip install --upgrade pyinstaller or easy_install --upgrade pyinstaller windows
windows上運行pyinstaller還需要pywin32或者pypiwin32，其中pypiwin32在你安裝pyinstaller的時候會自動安裝。
使用pyinstaller
pyinstaller分析你的python程序，找到所有的依賴項。然后將依賴文件和python解釋器放到一個文件夾下或者一個可執行文件中。
打包成一個文件夾
當使用pyinstaller打包的時候，默認生成一個文件夾，文件夾中包含所有依賴項，以及可執行文件。打包成文件夾的好處就是debug的時候可以清楚的看到依賴項有沒有包含。另一個好處是更新的時候，只需要更新可執行文件就可以了。當然缺點也很明顯，不方便，不易管理。
1 pyinstaller script.py 那么它是如何工作的呢？pyinstaller的引導程序是一個二進制可執行程序。當用戶啟動你的程序的時候，pyinstaller的引導程序開始運行，首先創建一個臨時的python環境，然后通過python解釋器導入程序的依賴，當然他們都在同一個文件夾下。
打包成一個文件
我們可以用onefile參數將所有文件打包到一個可執行文件中。
1 pyinstaller --onefile script.py 打包成一個文件相對于文件夾更容易管理。壞處運行相對比較慢。這個文件中包含了壓縮的依賴文件拷貝（.so文件）。
當程序運行時，pyinstaller的引導程序會新建一個臨時文件夾。然后解壓程序的第三方依賴文件到臨時文件夾中。這也是為什么一個可執行文件比文件夾中執行的時間要長的原因。剩下的就和上面的一樣了。
spec 文件
當你執行下面命令
1 pyinstaller options..script.py pyinstaller首先建一個sepc(specification)文件：script.spec。這個文件的存放地址可以使用參數–specpath= 來定義，默認放在當前文件夾下。
spec文件的作用是什么呢？它會告訴pyinstaller如何處理你的py文件，它會將你的py文件名字和輸入的大部分參數進行編碼。pyinstaller通過執行spec文件中的內容來生成app，有點像makefile。正常使用中我們是不需要管spec文件的，但是下面幾種情況需要修改spec文件：
需要打包資源文件
需要include一些pyinstaller不知道的run-time庫
為可執行文件添加run-time 選項
多程序打包
可以通過下面命令生成spec文件
1 pyi-makespec options script.py [other scripts ...] 修改完spec文件，就可以通過下面命令來生成app文件了
1 pyinstaller options script.spec 當通過spec文件來生成app文件的時候只有下面幾個參數是有用的：
–upx-dir=
–distpath=
–noconfirm=
–ascii
spec 文件解析
下面是一個spec文件的例子。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 block_cipher = none a = analysis([\\\'minimal.py\\\'], pathex=[\\\'/developer/pitests/minimal\\\'], binaries=none, datas=none, hiddenimports=[], hookspath=none, runtime_hooks=none, excludes=none, ciper=block_cipher) pyz = pyz(a.pure, a.zipped_data, cipher=block_cipher) exe = exe(pyz, ...) coll = collect(...) spec文件中主要包含4個class: analysis, pyz, exe和collect.
analysis以py文件為輸入，它會分析py文件的依賴模塊，并生成相應的信息
pyz是一個.pyz的壓縮包，包含程序運行需要的所有依賴
exe根據上面兩項生成
collect生成其他部分的輸出文件夾，collect也可以沒有
修改spec文件
我們上面說過有時候pyinstaller自動生成的spec文件并不能滿足我們的需求，最常見的情況就是我們的程序依賴我們本地的一些數據文件，這個時候就需要我們自己去編輯spec文件來添加數據文件了。
上面的spec文件解析中analysis中的datas就是要添加到項目中的數據文件，我們可以編輯datas.
1 2 3 4 5 6 a = analysis( ... datas = [(\\\'you/source/file/path\\\',\\\'file_name_in_project\\\'), (\\\'source/file2\\\', \\\'file_name2\\\')] ... ) 可以認為datas是一個list,每個元素是一個二元組。元組的第一個元素是你本地文件索引，第二個元素是拷貝到項目中之后的文件名字。除了上面那種寫法，也可以將其提出來。
1 2 3 4 5 6 7 added_files = [...] a = analysis( ... datas = added_files, ... ) 其他的二進制文件添加方法類似。
總結
最后簡單來說，我們要通過pyinstaller生成可執行的文件主要下面兩步。
1 pyinstaller [option] mypython.py option為空生成文件夾，選擇onefile，生成一個文件。
如果項目有一些依賴的數據文件，上面生成的二進制文件是無法運行的，這個時候可以通過修改spec文件，讓后再用pyinstaller運行spec文件。
1 pyinstaller [option] mypython.spec 當然也按上文那樣先生成spec文件。
100g云服務器價格
騰訊云服務器關機收費
美國電商大促銷即將開始 不過銷量會比雙11差多了
選擇哪個教程里沒有第一次授權后就得馬上下載代碼包進行上傳提交
阿里和華為云服務器哪個便宜
電腦硬盤排行榜_電腦硬盤排名2020年5月
宏怎么取消_表格怎么取消宏功能圖文步驟
購買香港阿里云服務器需要什么
安裝
linux or mac
你可以從pypi上下載安裝，當然也可以使用pip或者easy_install來安裝。
1 2 3 pip install pyinstaller or easy_install pyinstaller 版本更新
1 2 3 pip install --upgrade pyinstaller or easy_install --upgrade pyinstaller windows
windows上運行pyinstaller還需要pywin32或者pypiwin32，其中pypiwin32在你安裝pyinstaller的時候會自動安裝。
使用pyinstaller
pyinstaller分析你的python程序，找到所有的依賴項。然后將依賴文件和python解釋器放到一個文件夾下或者一個可執行文件中。
打包成一個文件夾
當使用pyinstaller打包的時候，默認生成一個文件夾，文件夾中包含所有依賴項，以及可執行文件。打包成文件夾的好處就是debug的時候可以清楚的看到依賴項有沒有包含。另一個好處是更新的時候，只需要更新可執行文件就可以了。當然缺點也很明顯，不方便，不易管理。
1 pyinstaller script.py 那么它是如何工作的呢？pyinstaller的引導程序是一個二進制可執行程序。當用戶啟動你的程序的時候，pyinstaller的引導程序開始運行，首先創建一個臨時的python環境，然后通過python解釋器導入程序的依賴，當然他們都在同一個文件夾下。
打包成一個文件
我們可以用onefile參數將所有文件打包到一個可執行文件中。
1 pyinstaller --onefile script.py 打包成一個文件相對于文件夾更容易管理。壞處運行相對比較慢。這個文件中包含了壓縮的依賴文件拷貝（.so文件）。
當程序運行時，pyinstaller的引導程序會新建一個臨時文件夾。然后解壓程序的第三方依賴文件到臨時文件夾中。這也是為什么一個可執行文件比文件夾中執行的時間要長的原因。剩下的就和上面的一樣了。
spec 文件
當你執行下面命令
1 pyinstaller options..script.py pyinstaller首先建一個sepc(specification)文件：script.spec。這個文件的存放地址可以使用參數–specpath= 來定義，默認放在當前文件夾下。
spec文件的作用是什么呢？它會告訴pyinstaller如何處理你的py文件，它會將你的py文件名字和輸入的大部分參數進行編碼。pyinstaller通過執行spec文件中的內容來生成app，有點像makefile。正常使用中我們是不需要管spec文件的，但是下面幾種情況需要修改spec文件：
需要打包資源文件
需要include一些pyinstaller不知道的run-time庫
為可執行文件添加run-time 選項
多程序打包
可以通過下面命令生成spec文件
1 pyi-makespec options script.py [other scripts ...] 修改完spec文件，就可以通過下面命令來生成app文件了
1 pyinstaller options script.spec 當通過spec文件來生成app文件的時候只有下面幾個參數是有用的：
–upx-dir=
–distpath=
–noconfirm=
–ascii
spec 文件解析
下面是一個spec文件的例子。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 block_cipher = none a = analysis([\\\'minimal.py\\\'], pathex=[\\\'/developer/pitests/minimal\\\'], binaries=none, datas=none, hiddenimports=[], hookspath=none, runtime_hooks=none, excludes=none, ciper=block_cipher) pyz = pyz(a.pure, a.zipped_data, cipher=block_cipher) exe = exe(pyz, ...) coll = collect(...) spec文件中主要包含4個class: analysis, pyz, exe和collect.
analysis以py文件為輸入，它會分析py文件的依賴模塊，并生成相應的信息
pyz是一個.pyz的壓縮包，包含程序運行需要的所有依賴
exe根據上面兩項生成
collect生成其他部分的輸出文件夾，collect也可以沒有
修改spec文件
我們上面說過有時候pyinstaller自動生成的spec文件并不能滿足我們的需求，最常見的情況就是我們的程序依賴我們本地的一些數據文件，這個時候就需要我們自己去編輯spec文件來添加數據文件了。
上面的spec文件解析中analysis中的datas就是要添加到項目中的數據文件，我們可以編輯datas.
1 2 3 4 5 6 a = analysis( ... datas = [(\\\'you/source/file/path\\\',\\\'file_name_in_project\\\'), (\\\'source/file2\\\', \\\'file_name2\\\')] ... ) 可以認為datas是一個list,每個元素是一個二元組。元組的第一個元素是你本地文件索引，第二個元素是拷貝到項目中之后的文件名字。除了上面那種寫法，也可以將其提出來。
1 2 3 4 5 6 7 added_files = [...] a = analysis( ... datas = added_files, ... ) 其他的二進制文件添加方法類似。
總結
最后簡單來說，我們要通過pyinstaller生成可執行的文件主要下面兩步。
1 pyinstaller [option] mypython.py option為空生成文件夾，選擇onefile，生成一個文件。
如果項目有一些依賴的數據文件，上面生成的二進制文件是無法運行的，這個時候可以通過修改spec文件，讓后再用pyinstaller運行spec文件。
1 pyinstaller [option] mypython.spec 當然也按上文那樣先生成spec文件。
100g云服務器價格
騰訊云服務器關機收費
美國電商大促銷即將開始 不過銷量會比雙11差多了
選擇哪個教程里沒有第一次授權后就得馬上下載代碼包進行上傳提交
阿里和華為云服務器哪個便宜
電腦硬盤排行榜_電腦硬盤排名2020年5月
宏怎么取消_表格怎么取消宏功能圖文步驟
購買香港阿里云服務器需要什么