CPackIFW¶
在版本 3.1 中新增。
此模組尋找 Qt Installer Framework (QtIFW) 提供的命令列工具的位置。
此模組也定義了數個命令來控制 CPack IFW 產生器 的行為。
命令¶
此模組定義了以下命令
- cpack_ifw_configure_component¶
設定 CPack IFW 產生器特定的參數。
cpack_ifw_configure_component(<compname> [COMMON] [ESSENTIAL] [VIRTUAL] [FORCED_INSTALLATION] [REQUIRES_ADMIN_RIGHTS] [NAME <name>] [DISPLAY_NAME <display_name>] # Note: Internationalization supported [DESCRIPTION <description>] # Note: Internationalization supported [UPDATE_TEXT <update_text>] [VERSION <version>] [RELEASE_DATE <release_date>] [SCRIPT <script>] [PRIORITY|SORTING_PRIORITY <sorting_priority>] # Note: PRIORITY is deprecated [DEPENDS|DEPENDENCIES <com_id> ...] [AUTO_DEPEND_ON <comp_id> ...] [LICENSES <display_name> <file_path> ...] [DEFAULT <value>] [USER_INTERFACES <file_path> <file_path> ...] [TRANSLATIONS <file_path> <file_path> ...] [REPLACES <comp_id> ...] [CHECKABLE <value>])
此命令應在
cpack_add_component()命令之後呼叫。COMMON若設定，則組件將會被封裝並安裝為其所屬群組的一部分。
ESSENTIAL在版本 3.6 中新增。
若設定，則套件管理器將保持停用狀態，直到該組件更新為止。
VIRTUAL在版本 3.8 中新增。
若設定，則組件將會從安裝程式中隱藏。這等同於
cpack_add_component()命令中的HIDDEN選項。FORCED_INSTALLATION在版本 3.8 中新增。
若設定，則組件必須始終安裝。這等同於
cpack_add_component()命令中的REQUIRED選項。REQUIRES_ADMIN_RIGHTS在版本 3.8 中新增。
若組件需要以提升的權限安裝，請設定此項。
NAME用於為此組件建立類似網域的識別。預設使用原始組件名稱。
DISPLAY_NAME在版本 3.8 中新增。
設定以覆寫由
cpack_add_component()命令配置的原始名稱。DESCRIPTION在版本 3.8 中新增。
設定以覆寫由
cpack_add_component()命令配置的原始描述。UPDATE_TEXT在版本 3.8 中新增。
如果這是組件的更新，將會新增至組件描述。
VERSION是組件的版本。預設使用
CPACK_PACKAGE_VERSION。RELEASE_DATE在版本 3.8 中新增。
保持空白以自動產生。
SCRIPT是此組件的操作腳本的相對或絕對路徑。
SORTING_PRIORITY在版本 3.8 中新增。
是組件在樹狀結構中的優先順序。
PRIORITYDeprecated since version 3.8:
SORTING_PRIORITY的舊名稱。DEPENDS,DEPENDENCIES在版本 3.8 中新增。
QtIFW 樣式中相依組件或組件群組識別符的清單。
在版本 3.21 中新增。
列為相依性的組件或群組名稱可以包含連字號。這需要 QtIFW 3.1 或更高版本。
AUTO_DEPEND_ON在版本 3.8 中新增。
此組件自動相依的 QtIFW 樣式組件或組件群組識別符的清單。
LICENSES此組件的授權條款文字的 <顯示名稱> 和 <檔案路徑> 配對。您可以指定多個授權條款。
DEFAULT在版本 3.8 中新增。
可能的值為：TRUE、FALSE 和 SCRIPT。設定為 FALSE 以在安裝程式中停用組件，或設定為 SCRIPT 以在執行期間解析（不要忘記將腳本檔案新增為
SCRIPT選項的值）。USER_INTERFACES在版本 3.7 中新增。
是代表要載入的頁面的 <檔案路徑> ('.ui' 檔案) 清單。
TRANSLATIONS在版本 3.8 中新增。
是代表要載入的翻譯的 <檔案路徑> ('.qm' 檔案) 清單。
REPLACES在版本 3.10 中新增。
要取代的組件或組件群組識別符的清單。
CHECKABLE在版本 3.10 中新增。
可能的值為：TRUE、FALSE。如果您想要隱藏項目的核取方塊，請設定為 FALSE。當只需要選取少數子組件而不是全部時，這很有用。
- cpack_ifw_configure_component_group¶
設定 CPack IFW 產生器特定的參數。
cpack_ifw_configure_component_group(<groupname> [VIRTUAL] [FORCED_INSTALLATION] [REQUIRES_ADMIN_RIGHTS] [NAME <name>] [DISPLAY_NAME <display_name>] # Note: Internationalization supported [DESCRIPTION <description>] # Note: Internationalization supported [UPDATE_TEXT <update_text>] [VERSION <version>] [RELEASE_DATE <release_date>] [SCRIPT <script>] [PRIORITY|SORTING_PRIORITY <sorting_priority>] # Note: PRIORITY is deprecated [DEPENDS|DEPENDENCIES <com_id> ...] [AUTO_DEPEND_ON <comp_id> ...] [LICENSES <display_name> <file_path> ...] [DEFAULT <value>] [USER_INTERFACES <file_path> <file_path> ...] [TRANSLATIONS <file_path> <file_path> ...] [REPLACES <comp_id> ...] [CHECKABLE <value>])
此命令應在
cpack_add_component_group()命令之後呼叫。VIRTUAL在版本 3.8 中新增。
若設定，則群組將會從安裝程式中隱藏。請注意，在根組件上設定此項無效。
FORCED_INSTALLATION在版本 3.8 中新增。
若設定，則群組必須始終安裝。
REQUIRES_ADMIN_RIGHTS在版本 3.8 中新增。
若組件群組需要以提升的權限安裝，請設定此項。
NAME用於為此組件群組建立類似網域的識別。預設使用原始組件群組名稱。
DISPLAY_NAME在版本 3.8 中新增。
設定以覆寫由
cpack_add_component_group()命令配置的原始名稱。DESCRIPTION在版本 3.8 中新增。
設定以覆寫由
cpack_add_component_group()命令配置的原始描述。UPDATE_TEXT在版本 3.8 中新增。
如果這是組件群組的更新，將會新增至組件群組描述。
VERSION是組件群組的版本。預設使用
CPACK_PACKAGE_VERSION。RELEASE_DATE在版本 3.8 中新增。
保持空白以自動產生。
SCRIPT是此組件群組的操作腳本的相對或絕對路徑。
SORTING_PRIORITY是組件群組在樹狀結構中的優先順序。
PRIORITYDeprecated since version 3.8:
SORTING_PRIORITY的舊名稱。DEPENDS,DEPENDENCIES在版本 3.8 中新增。
QtIFW 樣式中相依組件或組件群組識別符的清單。
在版本 3.21 中新增。
列為相依性的組件或群組名稱可以包含連字號。這需要 QtIFW 3.1 或更高版本。
AUTO_DEPEND_ON在版本 3.8 中新增。
此組件群組自動相依的 QtIFW 樣式組件或組件群組識別符的清單。
LICENSES此組件群組的授權條款文字的 <顯示名稱> 和 <檔案路徑> 配對。您可以指定多個授權條款。
DEFAULT在版本 3.8 中新增。
可能的值為：TRUE、FALSE 和 SCRIPT。設定為 TRUE 以在安裝程式中預先選取群組（這僅對沒有可見子組件的群組生效），或設定為 SCRIPT 以在執行期間解析（不要忘記將腳本檔案新增為
SCRIPT選項的值）。USER_INTERFACES在版本 3.7 中新增。
是代表要載入的頁面的 <檔案路徑> ('.ui' 檔案) 清單。
TRANSLATIONS在版本 3.8 中新增。
是代表要載入的翻譯的 <檔案路徑> ('.qm' 檔案) 清單。
REPLACES在版本 3.10 中新增。
要取代的組件或組件群組識別符的清單。
CHECKABLE在版本 3.10 中新增。
可能的值為：TRUE、FALSE。如果您想要隱藏項目的核取方塊，請設定為 FALSE。當只需要選取少數子組件而不是全部時，這很有用。
- cpack_ifw_add_repository¶
將 QtIFW 特定遠端儲存庫新增至二進位安裝程式。
cpack_ifw_add_repository(<reponame> [DISABLED] URL <url> [USERNAME <username>] [PASSWORD <password>] [DISPLAY_NAME <display_name>])
此命令也會將 <reponame> 儲存庫新增至變數
CPACK_IFW_REPOSITORIES_ALL。DISABLED若設定，則預設會停用儲存庫。
URL指向可用組件的清單。
USERNAME在受保護的儲存庫上用作使用者。
PASSWORD在受保護的儲存庫上使用的密碼。
DISPLAY_NAME要顯示來取代 URL 的字串。
- cpack_ifw_update_repository¶
在版本 3.6 中新增。
從遠端儲存庫更新 QtIFW 特定儲存庫。
cpack_ifw_update_repository(<reponame> [[ADD|REMOVE] URL <url>]| [REPLACE OLD_URL <old_url> NEW_URL <new_url>]] [USERNAME <username>] [PASSWORD <password>] [DISPLAY_NAME <display_name>])
此命令也會將 <reponame> 儲存庫新增至變數
CPACK_IFW_REPOSITORIES_ALL。URL指向可用組件的清單。
OLD_URL指向將被取代的清單。
NEW_URL指向將取代為的清單。
USERNAME在受保護的儲存庫上用作使用者。
PASSWORD在受保護的儲存庫上使用的密碼。
DISPLAY_NAME要顯示來取代 URL 的字串。
- cpack_ifw_add_package_resources¶
在版本 3.7 中新增。
在安裝程式二進位檔案中新增其他資源。
cpack_ifw_add_package_resources(<file_path> <file_path> ...)
此命令也會將指定的檔案新增至變數
CPACK_IFW_PACKAGE_RESOURCES。