Python 程序打包成 exe 可執行文件

 Python 程序打包工具

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

.py 文件：對於開源項目或者源碼沒那麼重要的，直接提供源碼，須要使用者自行安裝 Python 而且安裝依賴的各類庫。（Python 官方的各類安裝包就是這樣作的）。
.pyc 文件：有些公司或我的由於機密或者各類緣由，不肯意源碼被運行者看到，可使用 pyc 文件發佈，pyc 文件是 Python 解釋器能夠識別的二進制碼，故發佈後也是跨平臺的，須要使用者安裝相應版本的 Python 和依賴庫。
可執行文件：對於非碼農用戶或者一些小白用戶，你讓他裝個 Python 同時還要折騰一堆依賴庫，那簡直是個災難。對於此類用戶，最簡單的方式就是提供一個可執行文件，只須要把用法告訴他便可。比較麻煩的是須要針對不一樣平臺須要打包不一樣的可執行文件（Windows, Linux, Mac,…）。
.py 和.pyc 都比較簡單，Python 自己就能夠搞定。將 Python 腳本打包成可執行文件有多種方式。

PyInstaller

安裝 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 命令的時候，會在和腳本相同目錄下，生成一個.spec 文件，該文件會告訴 pyinstaller 如何處理你的全部腳本，同時包含了命令選項。通常咱們不用去理會這個文件，若須要打包數據文件，或者給打包的二進制增長一些 Python 的運行時選項時…一些高級打包選項時，須要手動編輯.spec 文件。可使用：

        pyi-makespec optionsscript [script …]

        建立一個.spec 文件，對於手動編輯的.spec 文件，咱們可使用下面任意一條命令：

        pyinstaller specfile

        pyi-build specfile

PyInstaller 原理簡介

        PyInstaller 其實就是把 python 解析器和你本身的腳本打包成一個可執行的文件，和編譯成真正的機器碼徹底是兩回事，因此千萬不要期望成打包成一個可執行文件會提升運行效率，相反可能會下降運行效率，好處就是在運行者的機器上不用安裝 python 和你的腳本依賴的庫。在 Linux 操做系統下，它主要用的 binutil 工具包裏面的 ldd 和 objdump 命令。

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

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

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

實踐問題

        pyinstaller 打包後的 exe 運行怎麼去掉彈出的命令行提示窗口？

        1. 若是使用.spec 文件的話, 在該文件中找到 console=True 修改成 console=False

        2. 若是是直接指定 python 文件進行 pyinstaller 打包的話，須要添加—noconsole

        pyinstaller path\mycode.py–noconsole

        若是想只打包成一個 exe：

        pyinstaller -F path\mycode.py –noconsole（注意：noconsole前面必須是兩個  -  -，一個 - 不起做用）

       或：

        pyinstaller -F -wpath\mycode.py

        更換最終 exe 生成路徑

        在 cmd 中，一開始就要 cd D:\PythonEXE\ 切換到輸出文件夾，而後在用上面的代碼，說明：各個參數的做用，

        例子：pyinstaller -F -w -pD:\tmp\core-python\libs -i d:\tmp\main.ico main.py

        -F 表示生成單個可執行文件；

        -D  –onedir 建立一個目錄，包含 exe 文件，但會依賴不少文件（默認選項）。

        -w 表示去掉控制檯窗口，這在 GUI 界面時很是有用。不過若是是命令行程序的話那就把這個選項刪除吧！；

        -c  –console, –nowindowed 使用控制檯，無界面 (默認)；

        -p 表示你本身自定義須要加載的類路徑，通常狀況下用不到；

        -i 表示可執行文件的圖標。

py2exe

         （py2exe 彷佛只能支持 python3.3 和 pyhton3.4）

         py2exe 是一個將 python 腳本轉換成 windows 上的可獨立執行的可執行程序 (*.exe) 的工具，這樣，你就能夠不用裝 python 而在 windows 系統上運行這個可執行程序。 

        py2exe 已經被用於建立 wxPython, Tkinter, Pmw, PyGTK, pygame,win32com client 和 server, 和其它的獨立程序。py2exe 是發佈在開源許可證下的。

py2exe 的用法 

        若是你有一個名爲 myscript.py 的 python 腳本，你想把它轉換爲運行在 windows 上的可執行程序，並運行在沒有安裝 python 的 windows 系統上，那麼首先你應寫一個用於發佈程序的設置腳本例如 mysetup.py，在其中的 setup 函數前插入語句 import py2exe 。 

mysetup.py 示例以下: 

# mysetup.py 

from distutils.core import setup 

import py2exe 

setup(console=["myscript.py"]) 

 

而後按下面的方法運行 mysetup.py: 

python mysetup.py py2exe 

        上面的命令執行後將產生一個名爲 dist 的子目錄，其中包含了 myscript.exe,python24.dll,library.zip 這些文件。

        若是你的 myscript.py 腳本中用了已編譯的 C 擴展模塊，那麼這些模塊也會被拷貝在個子目錄中，一樣，全部的 dll 文件在運行時都是須要的，除了系統的 dll 文件。dist 子目錄中的文件包含了你的程序所必須的東西，你應將這個子目錄中的全部內容一塊兒發佈。

        默認狀況下，py2exe 在目錄 dist 下建立如下這些必須的文件： 

        一、一個或多個 exe 文件。

        二、python##.dll。

        三、幾個.pyd 文件，它們是已編譯的擴展名，它們是 exe 文件所須要的；加上其它的.dll 文件，這些.dll 是.pyd 所須要的。 

        四、一個 library.zip 文件，它包含了已編譯的純的 python 模塊如.pyc 或.pyo 上面的 mysetup.py 建立了一個控制檯的 myscript.exe 程序，若是你要建立一個圖形用戶界的程序，那麼你只須要將 mysetup.py 中的 console=[「myscript.py」] 替換爲 windows=[「myscript.py」] 既可。 

        py2exe 一次可以建立多個 exe 文件，你須要將這些腳本文件的列表傳遞給 console 或 windows 的關鍵字參數。若是你有幾個相關聯的腳本，那麼這是頗有用的。 

        運行下面個命令，將顯示 py2exe 命令的全部命令行標記。 

        python mysetup.py py2exe–help 

指定額外的文件 
       一些應用程序在運行時須要額外的文件，諸如配置文件、字體、位圖。 若是在安裝腳本中用 data_files 可選項指定了那些額外的文件，那麼 py2exe 能將這些文件拷貝到 dist 子目錄中。data_files 應包含一個元組 (target-dir, files) 列表，其中的 files 是這些額外的文件的列表。 

示例以下： 

# mysetup.py

from distutils.core import setup

import glob

import py2exe 

 

setup(console=["myscript.py"], 

data_files=[("bitmaps", ["bm/large.gif","bm/small.gif"]), ("fonts", glob.glob("fonts\\*.fnt"))], ) 

 

說明：data_files 選項將建立一個子目錄 dist\bitmaps，其中包含兩個.gif 文件；一個子目錄 dist\fonts，其中包含了全部的.fnt 文件。

 

Windows NTservices 
        你能夠經過傳遞一個 service 關鍵字參數給 setup 函數來建造 Windows NT services , 這個 service 參數的值必須是一個 Python 模塊名 (包含一 service 類) 的列表。 

示例以下： 

# mysetup.py

from distutils.core import setup

import py2exe

setup(service=["MyService"]) 

 

所建造的可執行的 service 是能夠經過在其後跟必定的命令行參數標記來自行安裝和卸載的。

附——pyinstaller打包參數說明：