MageUI.exe (圖形用戶端、資訊清單產生和編輯工具)
MageUI.exe 與命令列工具 Mage.exe 支援相同的功能，不過前者會採用 Windows 使用者介面 (UI)。 您可以利用此工具建立、編輯和簽章部署與應用程式資訊清單。 使用 MageUI.exe 建立的新資訊清單會以 .NET Framework 4 用戶端設定檔為目標。 若要以舊版 .NET Framework 為目標，則應該使用舊版 MageUI.exe。 從資訊清單新增或移除元件或重新簽署現有的資訊清單時，MageUI.exe不會將資訊清單更新為目標.NET Framework 4 用戶端設定檔。 如需詳細資訊，請參閱 Mage.exe (資訊清單產生和編輯工具)。
此工具會自動與 Visual Studio 一起安裝。 若要執行此工具，請使用 Visual Studio 開發人員命令提示字元或 Visual Studio Developer PowerShell。
Visual Studio 有兩個版本的 Mage.exe 和 MageUI.exe 作為隨附元件。 若要查看版本資訊，請執行 MageUI.exe，並依序選取 [ 說明] 和 [ 關於]。 本文件說明 4.0.x.x 版本的 Mage.exe 和 MageUI.exe。
注意
如果 MageUI.exe 要儲存的應用程式資訊清單已使用 MageUI.exe 透過憑證簽署，則不支援 compatibleFrameworks 項目。 您必須改用 Mage.exe。
UIElement 清單
下表列出可用的功能表和工具列項目。
| Command | 功能表 | 快速鍵 | Description |
|---|---|---|---|
| 應用程式資訊清單 | 檔案、新增 | 建立新的應用程式資訊清單。 | |
| 部署資訊清單 | 檔案、新增 | 建立新的部署資訊清單。 | |
| 開啟 | 檔案 | CTRL+O | 開啟現有的部署資訊清單、應用程式資訊清單或信任授權以進行編輯。 |
| 關閉 | 檔案 | CTRL+F4 | 關閉開啟的檔案。 如果您在檔案關閉之前進行修改，MageUI.exe 會提示您使用公開金鑰、金鑰組或預存憑證重新簽章此檔案。 |
| 儲存 | 檔案 | CTRL+S | 將目前使用者輸入焦點所在的文件儲存至磁碟中。 |
| 另存新檔 | 檔案 | 將檔案儲存至磁碟，並且讓您提供新的檔案名稱和 (或) 位置。 | |
| 全部儲存 | 檔案 | 儲存對 MageUI.exe 中目前開啟的所有檔案所進行的變更。 | |
| 喜好設定 | 檔案 | 開啟 [偏好設定] 對話方塊。 如需詳細資訊，請參閱下一節。 | |
| 結束 | 檔案 | ALT+F4 | 結束 MageUI.exe。 |
| 剪下 | 編輯 | CTRL+X | 從應用程式中移除目前選取的文字，然後移至系統 [剪貼簿]。 |
| 複製 | 編輯 | CTRL+C | 將目前選取的文字複製到系統 [剪貼簿]。 |
| 貼上 | 編輯 | CTRL+V | 將文字從系統 [剪貼簿] 貼到目前現用的文字項目上。 |
| 刪除 | 編輯 | 刪除清單中目前選取的項目，例如 [部署資訊清單] 索引標籤上的信任授權。 | |
| 全部關閉 | Window | 關閉 MageUI.exe 中目前開啟的所有檔案。 如果其中一個或多個檔案需要儲存，MageUI.exe 會提示您將它們儲存。 MageUI.exe 也會提示您為每個未簽署或變更過的檔案選取簽署金鑰。 | |
| 關於 | 說明 | 顯示有關 MageUI.exe 的版本和著作權資訊。 |
偏好設定對話方塊
[偏好設定] 對話方塊包含下列項目。
| UI 元素 | 描述 |
|---|---|
| 於儲存時簽署 | 每當您儲存修改內容時，提示您簽署檔案。 |
| 使用預設簽署憑證 | 使用 [憑證檔] 文字方塊中輸入的金鑰簽署所有檔案。 這樣一來就不會顯示通常在您儲存檔案而且已選取 [於儲存時簽署] 的情況下會出現的簽署提示。 請使用 [憑證檔] 文字方塊旁的省略符號 (…) 按鈕選取金鑰檔。 |
| 摘要演算法 | 指定產生相依性摘要的演算法。 值必須是 "sha256RSA" 或 "sha1RSA"。 預設為使用 SHA1。 兩種都會在應用程式和部署資訊清單中使用。 如果使用者在儲存資訊清單時提供憑證，請使用憑證中的演算法產生相依性摘要。 |
簽署選項對話方塊
當您初次儲存資訊清單或信任授權，或是變更資訊清單或信任授權時，[簽署選項] 對話方塊就會出現。 只有在 [偏好設定] 對話方塊中的 [於儲存時簽署] 選項為選取狀態時，它才會出現。 若您簽署的資訊清單會在 [時間戳記 URI] 文字方塊中指定值，則必須連線到網際網路。
這個對話方塊包含下列項目。
| UI 元素 | 描述 |
|---|---|
| 用憑證檔簽署 | 使用儲存於檔案系統上的數位憑證簽署資訊清單。 |
| 檔案 | 提供一個區域，以便輸入代表憑證的 .pfx 檔路徑。 |
| ... | 開啟 [選擇檔案] 對話方塊，選取現有的 .pfx 檔。 |
| 新增 | 產生新的 .pfx，這個檔案無法透過憑證授權單位 (CA) 進行驗證。 如需用於簽署 ClickOnce 部署的憑證類型詳細資訊，請參閱信任的應用程式部署概觀。 |
| 密碼 | 提供輸入密碼的區域，此密碼會在使用此憑證簽署時使用。 如果不適用，可以保持空白。 |
| 用儲存的憑證簽署 | 以可選取清單的形式，顯示儲存在電腦憑證存放區內的數位憑證。 |
| 時間戳記 URI | 顯示數位時間戳記服務的統一資源定位器 (URI)。 在資訊清單加上時間戳記之後，若數位憑證在您部署應用程式的下一個版本之前到期，就無須重新簽署資訊清單。 如需詳細資訊，請參閱 Windows 根憑證計劃成員和 ClickOnce 和 Authenticode。 |
| 不簽署 | 可讓您儲存資訊清單，而不需要從數位憑證加入簽章。 |
索引標籤和面板描述
當您使用 MageUI.exe 開啟文件時，文件會出現在自己的索引標籤頁內。 每個索引標籤都包含一組屬性面板。 面板中包含一組文件資料的子集。
應用程式資訊清單索引標籤
[應用程式資訊清單] 索引標籤會顯示應用程式資訊清單的內容。 應用程式資訊清單描述使用部署時，所包含的所有檔案和用戶端上執行應用程式所需的權限。
[應用程式資訊清單] 索引標籤包含下列索引標籤。
| UI 元素 | 描述 |
|---|---|
| 名稱 | 指定此部署相關的識別資訊。 |
| 說明 | 指定發行者、 產品和支援資訊。 |
| 應用程式選項 | 指定這是否為瀏覽器應用程式，及此資訊清單是否為信任資訊的來源。 |
| 檔案 | 指定所有構成這個部署的檔案。 |
| 必要的使用權限 | 指定要在用戶端上執行的應用程式所需的最低權限集合。 |
名稱索引標籤
當您第一次建立或開啟應用程式資訊清單時，[名稱] 索引標籤會顯示。 它會唯一識別部署，並選擇性地指定有效的目標平台。
| UI 元素 | 描述 |
|---|---|
| 名稱 | 必要。 應用程式資訊清單的名稱。 通常與檔案名稱相同。 |
| 版本 | 必要。 部署的版本號碼，格式為 N.N.N.N。只需要第一個主要組建編號。 例如，應用程式版本 1.0，有效的值會包含 1、1.0、1.0.0 和 1.0.0.0。 |
| 處理器 | 選擇性。 可以執行此部署的電腦架構。 預設值是 msil，或 Microsoft 中繼語言，也就是所有的 Managed 組件的預設格式。 如果您要針對應用程式中的特定架構預先編譯組件，請變更此欄位。 如需有關預先編譯的詳細資訊，請參閱 Ngen.exe (原生映像產生器)。 |
| 文化特性 | 選擇性。 此應用程式執行的兩部分 ISO 國家及區域代碼。 預設值為 neutral。 |
| 公開金鑰 Token | 選擇性。 已簽署此應用程式資訊清單的公開金鑰。 如果這是新的或不帶正負號的資訊清單，此欄位會顯示為 Unsigned。 |
描述索引標籤
部署資訊清單內通常會提供此資訊。 當選取 [應用程式選項] 索引標籤上的 [使用應用程式資訊清單信任資訊] 核取方塊時，才能修改這些欄位。
| UI 元素 | 描述 |
|---|---|
| 發行者 | 負責應用程式之人員或組織的名稱。 使用此值做為 [開始] 功能表資料夾名稱。 |
| 產品 | 完整的產品名稱。 如果您選取部署資訊清單中 [部署選項] 索引標籤上之 [應用程式類型] 項目的 [本機安裝]，此應用程式的 [開始] 功能表連結和 [新增或移除程式] 中顯示的名稱即為產品的名稱。 |
| 支援位置 | 客戶可以從 URL 取得應用程式說明及支援。 |
應用程式選項索引標籤
| UI 元素 | 描述 |
|---|---|
| Windows Presentation Foundation 瀏覽器應用程式 | 指定是否是會在瀏覽器中以 XAML 瀏覽器應用程式 (XBAP) 執行的 WPF 應用程式。 |
| 使用應用程式資訊清單的信任資訊 | 指定此資訊清單是否包含信任資訊。 |
檔案索引標籤
| UI 元素 | 描述 |
|---|---|
| 應用程式目錄 | 應用程式檔案的所在目錄。 使用省略符號 ([...]) 按鈕來選取目錄。 |
| 擴展 | 將應用程式目錄和子目錄中的所有檔案新增到應用程式資訊清單。 如果 MageUI.exe 在目錄中發現單一可執行檔，它會自動將此標示為進入點，也就是用戶端啟動 ClickOnce 應用程式時第一個執行的檔案。 |
| 應用程式檔案 | 列出所有應用程式中的檔案。 每個檔案有三個可編輯的屬性，將於下列討論。 |
| 檔案類型 | 檔案類型可以是四個值之一： - 無。 - 進入點。 應用程式的主要可執行檔。 只有一個可執行檔可以標示為進入點。 - 資料檔案。 提供資料給應用程式的檔案，例如 XML 檔案。 - 圖示檔案。 應用程式圖示，例如會出現在桌面或應用程式視窗的角落。 |
| 選擇性 | 標示為選擇性的檔案不會在初始安裝或更新時下載，但是可能會在執行階段使用系統部署隨選 API 下載。 如需詳細資訊，請參閱逐步解說：下載組件隨選與 ClickOnce 部署應用程式開發介面使用設計工具。 |
| 群組 | 一組選擇性檔案的標籤。 您可以將群組標籤套用至一組檔案，並使用隨選應用程式開發介面，透過單一應用程式開發介面呼叫來下載批次檔案。 |
所需權限索引標籤
使用 [所需權限] 索引標籤，如果您要授與您的應用程式到本機電腦比預設更多的存取權。 如需詳細資訊，請參閱保護 ClickOnce 應用程式。
| UI 元素 | 描述 |
|---|---|
| 使用權限集合類型 | 指定要在用戶端上執行的應用程式所需的最低權限集合。 如需這些權限集合的描述，及其要求或不要求的權限，請參閱具名使用權限集合。 |
| 詳細資料 | 建立應用程式資訊清單的 XML 來表示權限設定。 除非您有充分的了解應用程式資訊清單 XML 格式，否則您應該手動編輯此 XML。 如需詳細資訊，請參閱 ClickOnce 應用程式資訊清單。 |
部署資訊清單索引標籤
[部署資訊清單] 索引標籤包含下列索引標籤。
| UI 元素 | 描述 |
|---|---|
| 名稱 | 指定此部署相關的識別資訊。 |
| 說明 | 指定發行者、 產品和支援資訊。 |
| 部署選項 | 指定其他部署相關的資訊，例如應用程式類型和開始位置。 |
| 更新選項 | 指定 ClickOnce 應多久檢查一次應用程式更新。 |
| 應用程式參考 | 指定此部署的應用程式資訊清單。 |
名稱索引標籤
當您第一次建立或開啟部署資訊清單時，[名稱] 索引標籤會顯示。 它會唯一識別部署，並選擇性地指定有效的目標平台。
| UI 元素 | 描述 |
|---|---|
| 名稱 | 必要。 部署資訊清單的名稱。 通常與檔案名稱相同。 |
| 版本 | 必要。 部署的版本號碼，格式為 N.N.N.N。只需要第一個主要組建編號。 例如，應用程式版本 1.0，有效的值會包含 1、1.0、1.0.0 和 1.0.0.0。 |
| 處理器 | 選擇性。 可以執行此部署的電腦架構。 預設值是 msil，或 Microsoft 中繼語言，是所有的 Managed 組件的預設格式。 如果您要針對應用程式中的特定架構編譯組件，請變更此欄位。 |
| 文化特性 | 選擇性。 此應用程式執行的兩部分 ISO 國家/區域代碼。 預設值為 neutral。 |
| 公開金鑰 Token | 選擇性。 已簽署此部屬資訊清單的公開金鑰。 如果這是新的或不帶正負號的資訊清單，此欄位會顯示為 Unsigned。 |
描述索引標籤
| UI 元素 | 描述 |
|---|---|
| 發行者 | 必要。 負責應用程式之人員或組織的名稱。 使用此值做為 [開始] 功能表資料夾名稱。 |
| 產品 | 必要。 完整的產品名稱。 如果您選取 [部署選項] 索引標籤上之 [應用程式類型] 項目的 [本機安裝]，此應用程式的 [開始] 功能表連結和 [新增或移除程式] 中顯示的名稱即為產品的名稱。 |
| 支援位置 | 選擇性。 客戶可以從 URL 取得應用程式說明及支援。 |
部署選項索引標籤
| UI 元素 | 描述 |
|---|---|
| 應用程式類型 | 選擇性。 指定是否將這個應用程式本身安裝至用戶端電腦 ([本機安裝])，在線上執行 ([僅限線上])，或者在瀏覽器中執行的 WPF 應用程式 (WPF 瀏覽器應用程式 )。 預設值是 [本機安裝]。 |
| 開始位置 | 選擇性。 應用程式應該實際從 URL 中啟動。 從 CD 部署應用程式時很有用，其應該從 Web 更新本身。 |
| 包含資訊清單中的開始位置 (ProviderURL) | 選擇性。 指定 URL，讓 ClickOnce 從該處檢查是否有應用程式更新。 |
| 在安裝後自動執行的應用程式 | 必要。 指定 ClickOnce 應用程式應該在從 URL 初始安裝之後立刻執行。 這個核取方塊預設為已選取。 |
| 允許 URL 參數傳遞至應用程式 | 必要。 允許透過附加至部署資訊清單 URL 的查詢字串，將參數資料傳輸到 ClickOnce 應用程式。 這個核取方塊預設為已清除。 |
| 使用 .deploy 副檔名 | 必要。 選取時，應用程式資訊清單中的所有檔案必須都有 .deploy 副檔名。 這個核取方塊預設為已清除。 |
更新選項索引標籤
[更新選項] 索引標籤只會包含此處提到的選項 (當 [應用程式類型] 上的選取方塊 [名稱] 索引標籤設定為 [本機安裝])。
| UI 元素 | 描述 |
|---|---|
| 此應用程式應該檢查更新 | 指定 ClickOnce 是否應該檢查應用程式更新。 如果未選取此核取方塊，應用程式將不會檢查更新，除非您使用 System.Deployment.Application 命名空間中的應用程式開發介面，以程式設計方式更新它。 |
| 此應用程式應該檢查更新 | 提供兩個更新檢查選項： - [應用程式啟動之前]。 執行應用程式之前，先執行更新檢查。 - [應用程式啟動後]。 應用程式的主要表單一完成初始化便會開始檢查更新，並將在下一次應用程式啟動之後執行。 |
| 更新檢查頻率 | 決定 ClickOnce 應多久檢查一次更新： - [每次執行應用程式時檢查]。 ClickOnce 會在每次使用者開啟應用程式時執行更新檢查。 - 檢查每個：選取檢查更新前，必須經過多久時間間隔和單位 (小時、天或週)。 |
| 指定此應用程式的最小必要的版本 | 選擇性。 指定您應用程式的特定版本是必要的安裝，防止您的使用者使用較舊的版本。 |
| 版本 | 若選取 [指定此應用程式的最小必要的版本] 核取方塊，則為必要項。 提供的版本號碼必須為 N.N.N.N 格式。只需要第一個主要組建編號。 例如，應用程式版本 1.0，有效的值會包含 1、1.0、1.0.0 和 1.0.0.0。 |
應用程式參考索引標籤
[應用程式參考] 索引標籤包含本主題稍早所述與 [名稱] 索引標籤相同的欄位。 唯一例外的是下列欄位。
| UI 元素 | 描述 |
|---|---|
| 選取資訊清單 | 可讓您選擇應用程式資訊清單。 當您選擇應用程式資訊清單時，將填入此頁面上的所有其他欄位。 |
