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 版本中新增。
是元件在樹狀結構中的優先順序。
PRIORITY自 3.8 版本起已棄用：
SORTING_PRIORITY的舊名稱。DEPENDS、DEPENDENCIES在 3.8 版本中新增。
QtIFW 風格的相依元件或元件群組識別碼清單。
在 3.21 版本中新增。
作為相依性列出的元件或群組名稱可能包含連字號。這需要 QtIFW 3.1 或更高版本。
AUTO_DEPEND_ON在 3.8 版本中新增。
此元件具有自動相依性的 QtIFW 風格元件或元件群組的識別碼清單。
LICENSES此元件的授權文字的 <display_name> 和 <file_path> 配對。您可以指定多個授權。
DEFAULT在 3.8 版本中新增。
可能的值為：TRUE、FALSE 和 SCRIPT。設定為 FALSE 以在安裝程式中停用元件，或設定為 SCRIPT 以在執行期間解析（不要忘記將指令碼的檔案新增為
SCRIPT選項的值）。USER_INTERFACES在 3.7 版本中新增。
是代表要載入頁面的 <file_path>（'.ui' 檔案）清單。
TRANSLATIONS在 3.8 版本中新增。
是代表要載入的翻譯的 <file_path>（'.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是元件群組在樹狀結構中的優先順序。
PRIORITY自 3.8 版本起已棄用：
SORTING_PRIORITY的舊名稱。DEPENDS、DEPENDENCIES在 3.8 版本中新增。
QtIFW 風格的相依元件或元件群組識別碼清單。
在 3.21 版本中新增。
作為相依性列出的元件或群組名稱可能包含連字號。這需要 QtIFW 3.1 或更高版本。
AUTO_DEPEND_ON在 3.8 版本中新增。
此元件群組具有自動相依性的 QtIFW 風格元件或元件群組的識別碼清單。
LICENSES此元件群組的授權文字的 <display_name> 和 <file_path> 配對。您可以指定多個授權。
DEFAULT在 3.8 版本中新增。
可能的值為：TRUE、FALSE 和 SCRIPT。設定為 TRUE 以在安裝程式中預先選取群組（這僅對沒有可見子元件的群組生效），或設定為 SCRIPT 以在執行期間解析（不要忘記將指令碼的檔案新增為
SCRIPT選項的值）。USER_INTERFACES在 3.7 版本中新增。
是代表要載入頁面的 <file_path>（'.ui' 檔案）清單。
TRANSLATIONS在 3.8 版本中新增。
是代表要載入的翻譯的 <file_path>（'.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。