PyQtdeploy 用戶指南

目錄

• 介紹
  • 與V1.0+的差異
  • 作者
  • 證書
  • 安裝
• 部署過程概覽
• PyQt的演示
  • 構建演示
  • Android
  • IOS
  • Linux
  • MacOS
  • Windos
• 構建系統根目錄
  • 標準組建插件
  • 創建Sysroot規範文件
  • PyQt演示的Sysroot
  • 命令行
  • 編寫組建插件
• 創建PyQtdeploy項目
  • 定義應用程式源
  • 定義qmake配置
  • 添加標準庫包
  • 添加其他包
  • 添加其他擴展模塊
  • 定義文件和目錄位置
• 構建應用程式
  • 命令行
• Windows和動態載入擴展模塊
• 使用pyrcc的應用程式
  • 支持PEP 302可選導入掛鉤
• pdytools模塊

部署過程概覽

PyQtdeploy的母的是將Python應用程式、Python解釋器、Python標準庫、Python C擴展模塊、第三方Python包和第三方擴展模塊轉換為對於特定目標的單個可執行文件。根據目標，可執行文件可能需要通過某種方式打包才能真正部署。例如：Android應用程式需要簽名並打包為.apk文件。任何此類打包都不在PyQtdeploy的範圍內。

雖然PyQtdeploy允許你創建單個可執行文件，但你能根據需要將組建保留在可執行文件外部。

PyQtdeploy支持一下目標體繫結構：

• Android -32
• Android -64
• IOS -64
• Linux -64
• MacOS -64
• Win -32
• Win -64

完整的結構命名由平臺和一個用於區分的-組成。請註意，並非所有的平臺和操作位的組合都支持。

PyQtdeploy使用Qt的以下部分：

• qmake是支持交叉編譯到多個目標的QT系統。
• rcc是一個將任意文件轉換為嵌入式文件結構的C++數據結構，該文件系統可作為應用程式的一部分進行連接。
• QtCore庫實現了訪問識別引用rcc創建的嵌入式文件系統內容的文件和目錄名稱的APIs。PyQtdeploy實現了使用QtCore的導入掛鉤，以便可以像從普通文件系統導入Python模塊一樣從嵌入式文件系統導入靜態的Python模塊。

註意：PyQtdeploy生成的代碼本身並不適用PyQt。PyQtdeploy可用於部署非pyqt應用程式，包括簡單的命令行腳本。但是，由於每個已部署的應用程式都鏈接到QtCore庫，所以您應該確保您的應用程式的許可與您正在使用的Qt版本的許可相容。

當一個應用程式由許多第三方組件(Python包和擴展模塊)組成時，有必要將這些組建安裝在已定義的位置，以便在應用程式的構建過程中可以找到它們。雖然在某些情況下可以使用現有的Python安裝，但它有許多缺點：

• 不同的應用程式可能對第三方軟體包的不同版本有要求，因此難以共用相同的Python安裝。
• 您的應用程式可能需要以不同方式配置組件（包括Python解釋器本身）。
• 標準Python安裝將包含動態鏈接的擴展模塊，但您可能希望使用靜態鏈接的版本。
• 在部署非本機平臺時無法使用它。

經驗表明，將所有這些組件與任何標準Python安裝分開都更容易。特定於目標的系統根目錄（sysroot）可用於包含所有必需組件的適當配置和版本構建。如果您正在開發許多應用程式，那麼很可能您將對這些應用程式使用的組件版本進行標準化。因此，您可以創建一個用於構建所有應用程式的sysroot。雖然使用sysroot是完全可選的，但強烈建議使用。

開發可部署應用程式所需的步驟如下：

1. 使用包含所需第三方組件的本機Python安裝，正常開發和測試應用程式。
2. 確定所需的第三方組件並構建特定於目標的sysroot。請參閱構建系統根目錄以瞭解如何使用pyqtdeploy-sysroot執行此操作。
3. 為應用程式創建項目文件，以標識應用程式的源代碼以及應用程式使用的所有組件及其位置。請參閱創建pyqtdeploy項目以瞭解如何使用 pyqtdeploy執行此操作。
4. 凍結Python模塊併在特定於目標的構建目錄中生成qmake .pro文件。該.pro文件將引用相關sysroot中的所有必需組件。運行qmake然後 make以創建應用程式可執行文件。請參閱 構建應用程式以瞭解如何使用 pyqtdeploy-build執行此操作。

返回目錄