如何將Python腳本打包成可執行文件

Python是一個腳本語言,被解釋器解釋執行。它的發佈方式:

  • .py文件:對於開源項目或者源碼沒那麼重要的,直接提供源碼,需要使用者自行安裝Python並且安裝依賴的各種庫。(Python官方的各種安裝包就是這樣做的)

  • .pyc文件:有些公司或個人因爲機密或者各種原因,不願意源碼被運行者看到,可以使用pyc文件發佈,pyc文件是Python解釋器可以識別的二進制碼,故發佈後也是跨平臺的,需要使用者安裝相應版本的Python和依賴庫。

  • 可執行文件:對於非碼農用戶或者一些小白用戶,你讓他裝個Python同時還要折騰一堆依賴庫,那簡直是個災難。對於此類用戶,最簡單的方式就是提供一個可執行文件,只需要把用法告訴Ta即可。比較麻煩的是需要針對不同平臺需要打包不同的可執行文件(Windows,Linux,Mac,...)。

本文主要就是介紹最後一種方式,.py和.pyc都比較簡單,Python本身就可以搞定。將Python腳本打包成可執行文件有多種方式,本文重點介紹PyInstaller,其它僅作比較和參考。

Freezing Your Code

各種打包工具的對比如下:

 

PS.其中pyInstaller和cx_Freeze都是不錯的,stackoverflow上也有人建議用cx_Freeze,說是更便捷些。pkg_resources新版的pyInstaller貌似是支持的。

小編整理了一些Python學習內容,我把它推薦給你!Python資料+Qun  69286 - 7294 就能獲得全部資料!免費學習視頻+項目源碼,並且在學習的過程中,還可以參與我們的訓練營學習!

安裝PyInstaller

對於那些網絡比較穩定,能夠流暢使用pip源地址的用戶,直接下面的命令就可以搞定:

pip install pyinstaller

通常我們會下載源碼包,然後進入包目錄,執行下面的命令(需要安裝setuptools):

python setup.py install

安裝完後,檢查安裝成功與否:

pyinstaller --version

安裝成功後,就可以使用下面的命令了:

  • pyinstaller : 打包可執行文件的主要命令,詳細用法下面會介紹。

  • pyi-archive_viewer : 查看可執行包裏面的文件列表。

  • pyi-bindepend : 查看可執行文件依賴的動態庫(.so或.dll文件)

  • pyi-... : 等等。

使用PyInstaller

pyinstaller的語法:

pyinstaller [options] script [script ...] | specfile

最簡單的用法,在和myscript.py同目錄下執行命令:

pyinstaller mycript.py

然後會看到新增加了兩個目錄build和dist,dist下面的文件就是可以發佈的可執行文件,對於上面的命令你會發現dist目錄下面有一堆文件,各種都動態庫文件和myscrip可執行文件。有時這樣感覺比較麻煩,需要打包dist下面的所有東西才能發佈,萬一丟掉一個動態庫就無法運行了,好在pyInstaller支持單文件模式,只需要執行:

pyinstaller -F mycript.py

你會發現dist下面只有一個可執行文件,這個單文件就可以發佈了,可以運行在你正在使用的操作系統類似的系統的下面。

當然,pyinstaller還有各種選項,有通用選項,如-d選項用於debug,瞭解pyInstaller執行的過程;

在執行pyInstaller命令的時候,會在和腳本相同目錄下,生成一個.spec文件,該文件會告訴pyinstaller如何處理你的所有腳本,同時包含了命令選項。一般我們不用去理會這個文件,若需要打包數據文件,或者給打包的二進制增加一些Python的運行時選項時...一些高級打包選項時,需要手動編輯.spec文件。可以使用:

pyi-makespec options script [script ...]

創建一個.spec文件,對於手動編輯的.spec文件,我們可以使用下面任意一條命令:

pyinstaller specfile
pyi-build specfile

PyInstaller的原理簡介

PyInstaller其實就是把python解析器和你自己的腳本打包成一個可執行的文件,和編譯成真正的機器碼完全是兩回事,所以千萬不要指望成打包成一個可執行文件會提高運行效率,相反可能會降低運行效率,好處就是在運行者的機器上不用安裝python和你的腳本依賴的庫。在Linux操作系統下,它主要用的binutil工具包裏面的ldd和objdump命令。

PyInstaller輸入你指定的的腳本,首先分析腳本所依賴的其他腳本,然後去查找,複製,把所有相關的腳本收集起來,包括Python解析器,然後把這些文件放在一個目錄下,或者打包進一個可執行文件裏面。

可以直接發佈輸出的整個文件夾裏面的文件,或者生成的可執行文件。你只需要告訴用戶,你的應用App是自我包含的,不需要安裝其他包,或某個版本的Python,就可以直接運行了。

需要注意的是,PyInstaller打包的執行文件,只能在和打包機器系統同樣的環境下。也就是說,不具備可移植性,若需要在不同系統上運行,就必須針對該平臺進行打包。