組態檔
組態檔可自定義安裝程式的用戶界面和行為,該檔案通常稱為config.xml,位于config檔案夾中,
最小組態檔由一個<Installer>根元素組成,<Name>和<Version>元素是其子元素,所有其他元素都是可選的,并且可以任意順序出現,
以下示例顯示了一個典型的組態檔:
<?xml version="1.0"?>
<Installer>
<Name>Some Application</Name>
<Version>1.0.0</Version>
<Title>Some Application Setup</Title>
<Publisher>Your Company</Publisher>
<ProductUrl>http://www.your-fantastic-company.com</ProductUrl>
<InstallerWindowIcon>installericon</InstallerWindowIcon>
<InstallerApplicationIcon>installericon</InstallerApplicationIcon>
<Logo>logo.png</Logo>
<Watermark>watermark.png</Watermark>
<RunProgram>@TargetDir@/YourAppToRun</RunProgram>
<RunProgramArguments>
<Argument>Argument 1</Argument>
<Argument>Argument 2</Argument>
</RunProgramArguments>
<RunProgramDescription>My nice application</RunProgramDescription>
<StartMenuDir>Some Application Entry Dir</StartMenuDir>
<MaintenanceToolName>SDKMaintenanceTool</MaintenanceToolName>
<AllowNonAsciiCharacters>true</AllowNonAsciiCharacters>
<Background>background.png</Background>
<TargetDir>@HomeDir@/testinstall</TargetDir>
<AdminTargetDir>@RootDir@/testinstall</AdminTargetDir>
<RemoteRepositories>
<Repository>
<Url>http://www.your-repo-location/packages/</Url>
</Repository>
</RemoteRepositories>
</Installer>
組態檔元素總結
下表總結了組態檔中的元素,
注意:我們建議您將的組態檔中參考的所有檔案放在config目錄下,但是,您也可以使用相對路徑,工具決議這些路徑時,是相對于config.xml檔案的位置,
您可以使用預定義變數(嵌入@字符)作為元素的值,有關更多資訊,請參見預定義變數章節,
| 元素 | 描述 |
|---|---|
| Name | 要安裝的產品的名稱,這是強制性的, |
| Version | 要安裝的產品版本的格式: [0-9]+((\.|-)[0-9]+)*例如1-1; 1.2-2; 3.4.7.這是強制性的, |
| Title | 在標題欄顯示的安裝程式的名稱, |
| Publisher | 軟體的發布者(如Windows控制面板中所示), |
| ProductUrl | 指向包含產品資訊的網站頁面的URL, |
| Icon | 自定義安裝程式圖示的檔案名,通過附加的'.icns'(macOS),'.ico'(Windows)或'.png'(Unix)后綴,查找檔案,不推薦使用,請使用 |
| InstallerApplicationIcon | 自定義安裝程式圖示的檔案名,通過附加的'.icns'(macOS),'.ico'(Windows)后綴,查找檔案,Unix中無該功能, |
| InstallerWindowIcon | PNG格式的自定義視窗圖示的檔案名,用于Installer應用程式, |
| Logo | logo檔案名,用作QWizard::LogoPixmap, |
| Watermark | 水印檔案名,用作QWizard::WatermarkPixmap, |
| Banner | 橫幅檔案名,用作QWizard::BannerPixmap(僅用于ModernStyle模式) |
| Background | 影像檔案名,用作QWizard::BackgroundPixmap(僅用于MacStyle模式) |
| WizardStyle | 設定向導樣式("Modern", "Mac", "Aero" or "Classic"), |
| StyleSheet | 設定樣式表檔案, |
| WizardDefaultWidth | 設定向導的默認像素寬度,設定橫幅影像將覆寫此設定,您可以將em或ex后綴添加到指定的值,以使用em或ex單位,就像CSS檔案一樣, |
| WizardDefaultHeight | 設定向導的默認像素高度,設定水印影像將覆寫此設定,您可以將em或ex后綴添加到指定的值,以使用em或ex單位,就像CSS檔案一樣, |
| TitleColor | 設定標題和子標題的顏色(采用HTML顏色代碼,例如“#88FF33”), |
| RunProgram | 安裝程式完成后被執行的命令,如果用戶接受該操作,請給應用程式提供完整的路徑, |
| RunProgramArguments | 引數,傳遞給 |
| RunProgramDescription | 文本,在安裝程式執行完后,顯示與運行程式復選框旁,如果設定了 |
| StartMenuDir | Windows“開始”選單中產品的默認程式組的名稱, |
| TargetDir | 默認安裝目標檔案夾,在Linux上,通常是用戶的主目錄, |
| AdminTargetDir | 具有管理員權限的默認安裝目標檔案夾,僅在Linux上可用,您通常不想將其安裝在管理員用戶的主目錄中, |
| RemoteRepositories | 遠程存盤庫串列,該元素可以包含多個 |
| RepositoryCategories | 類別的名稱,可以包含一系列 |
| MaintenanceToolName | 生成的維護工具的檔案名,默認為maintenancetool,附加了平臺特定的可執行檔案擴展名, |
| MaintenanceToolIniFile | 生成的維護工具的組態檔名,默認為MaintenanceToolName.ini, |
| RemoveTargetDir | 如果在卸載時不應洗掉目標檔案夾,則設定為false, |
| AllowNonAsciiCharacters | 如果安裝路徑可以包含非ASCII字符,則設定為true, |
| DisableAuthorizationFallback | 如果在授權錯誤的情況下,不要求用戶運行授權應急,則將其設定為true,并會立即中止安裝, |
| RepositorySettingsPageVisible | 設定為false,可在設定對話框中隱藏存盤庫設定頁面, |
| AllowSpaceInPath | 如果安裝路徑不能包含空格字符,則設定為false, |
| DependsOnLocalInstallerBinary | 如果要禁止從外部資源進行安裝,例如網路驅動器,請設定為true,這可能對非常大的安裝程式有意義,該選項僅在Windows上使用, |
| TargetConfigurationFile | 目標物件上的組態檔名,默認為components.xml, |
| Translations | 用于翻譯用戶界面的語言代碼串列,要添加幾種語言變體,請指定多個 |
| UrlQueryString | 該字串必須采用“鍵=值”的形式,并將添加到存檔下載請求中,這可用于傳輸資訊到托管資源庫的Web服務器, |
| ControlScript | 自定義安裝程式控制腳本的檔案名,請參閱控制腳本章節, |
| CreateLocalRepository | 如果要在安裝目錄中創建本地存盤庫,請設定為true,此選項對在線安裝程式無效,該存盤庫將被自動添加到默認存盤庫串列中, |
| InstallActionColumnVisible | 如果要在顯示安裝操作的組件樹中添加額外的列,請設定為true,此額外的列指示組件是要進行安裝還是要進行卸載,或保持已安裝或已卸載, |
| SupportsModify | 如果產品不支持修改現有安裝,則設定為false, |
| SaveDefaultRepositories | 如果默認存盤庫 |
| AllowUnstableComponents | 設定為true,如果允許安裝其他組件,雖然其中可能存在不穩定的,一個組件是不穩定的,如果組件缺少依賴項,腳本中有錯誤等則,不穩定的組件在組件樹中顯示為灰色,因此無法被選擇,默認情況下,該值為false,這意味著如果找到不穩定的組件,安裝將中止, |
原創造福大家,共享改變世界
獻出一片愛心,溫暖作者心靈
轉載請註明出處,本文鏈接:https://www.uj5u.com/qita/5175.html
標籤:其他
