共用方式為


逐步解說:手動部署不需要重新簽署而且會保留商標資訊的 ClickOnce 應用程式

更新:2007 年 11 月

當您建立 ClickOnce 應用程式,然後將它交給客戶發行及部署時,客戶以往都會需要更新部署資訊清單並重新簽署。雖然這種方法仍是大部分情況下偏好使用的方法,不過 .NET Framework 3.5 能讓您建立可由客戶部署的 ClickOnce 部署,而不需產生新的部署資訊清單。如需詳細資訊,請參閱部署 ClickOnce 應用程式但不重新簽章

當您建立 ClickOnce 應用程式,然後將它交給客戶發行及部署時,應用程式可使用客戶的品牌或是保留您的品牌。例如,如果應用程式是單一專屬應用程式,您可能想要保留您的品牌。如果應用程式可針對每位客戶高度自訂,則您可能想要使用客戶的品牌。當您將應用程式交給某個組織部署時,.NET Framework 3.5 可讓您保留品牌、發行者資訊及安全性簽章。如需詳細資訊,請參閱建立 ClickOnce 應用程式供其他人部署

注意事項:

在本逐步解說中,您將使用命令列工具 Mage.exe 或是圖形工具 MageUI.exe 手動建立部署。如需手動部署的詳細資訊,請參閱逐步解說:手動部署 ClickOnce 應用程式

必要條件

若要執行這個逐步解說中的步驟,您需要以下各項:

  • 您準備要部署的 Windows Form 應用程式。這個應用程式將稱為 WindowsFormsApp1。

  • 適用 Windows Server 2008 和 .NET Framework 3.5 的 Visual Studio 2008 或 Windows Software Development Kit (SDK)。

使用 Mage.exe 部署包含多個部署和品牌支援的 ClickOnce 應用程式

  1. 開啟 Visual Studio 2008 命令提示字元或 Windows SDK 命令提示字元,並且切換到將儲存 ClickOnce 檔案的目錄。

  2. 建立目錄,並依照部署的目前版本命名。如果這是第一次部署此應用程式,就可能會選擇 1.0.0.0。

    注意事項:

    部署的版本可能會有別於應用程式檔案的版本。

  3. 建立名為 bin 的子目錄,並將所有的應用程式檔案複製到此處,其中包括可執行檔、組件、資源及資料檔。

  4. 呼叫 Mage.exe 以產生應用程式資訊清單。

    mage -New Application -ToFile 1.0.0.0\WindowsFormsApp1.exe.manifest -Name "Windows Forms App 1" -Version 1.0.0.0 -FromDirectory 1.0.0.0\bin -UseManifestForTrust true -Publisher "A. Datum Corporation"
    
  5. 使用您的數位憑證簽署應用程式資訊清單。

    mage -Sign WindowsFormsApp1.exe.manifest -CertFile mycert.pfx
    
  6. 呼叫 Mage.exe 以產生部署資訊清單。根據預設,Mage.exe 會將您的 ClickOnce 部署標記為已安裝的應用程式,如此就能在線上和離線模式執行。若只要在使用者連線時提供應用程式,請使用 -i 引數與 f 值。由於這個應用程式將利用多重部署功能,因此請不要在 Mage.exe 中包含 -providerUrl 引數 (在 .NET Framework 3.5 之前的版本中,若離線應用程式未包含 -providerUrl,將導致錯誤發生)。

    mage -New Deployment -ToFile WindowsFormsApp1.application -Name "Windows Forms App 1" -Version 1.0.0.0 -AppManifest 1.0.0.0\WindowsFormsApp1.manifest 
    
  7. 請勿簽署部署資訊清單。

  8. 提供所有檔案給將在其網路上部署應用程式的客戶。

  9. 至此,客戶必須使用其自動產生的憑證簽署部署資訊清單。例如,如果客戶為名為 Adventure Works 的公司工作,則可使用 MakeCert.exe 工具產生自動簽署的憑證。接著,使用 Pvk2pfx.exe 工具將 MakeCert.exe 建立的檔案組合成可傳遞至 Mage.exe 的 PFX 檔案。

    makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer
    pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx
    
  10. 接著客戶將使用這個憑證簽署部署資訊清單。

    mage -Sign WindowsFormsApp1.application -CertFile MyCert.pfx
    
  11. 客戶將應用程式部署至其使用者。

使用 MageUI.exe 部署包含多個部署和品牌支援的 ClickOnce 應用程式

  1. 開啟 Visual Studio 2008 命令提示字元或 Windows SDK 命令提示字元,並且瀏覽至將儲存 ClickOnce 檔案的目錄。

  2. 建立名為 bin 的子目錄,並將所有的應用程式檔案複製到此處,其中包括可執行檔、組件、資源及資料檔。

  3. 建立子目錄,並依照部署的目前版本命名。如果這是第一次部署此應用程式,就可能會選擇 1.0.0.0。

    注意事項:

    部署的版本可能會有別於應用程式檔案的版本。

  4. 將 \bin 目錄移至您在步驟 2 中建立的目錄。

  5. 啟動圖形工具 MageUI.exe。

    MageUI.exe
    
  6. 從功能表依序選取 [檔案]、[新增]、[應用程式資訊清單],以建立新的應用程式資訊清單。

  7. 在預設的 [名稱] 索引標籤上,輸入此部署的名稱和版本號碼。同時提供 [發行者] 的值,該值將在部署時,用來做為 [開始] 功能表中應用程式捷徑連結的資料夾名稱。

  8. 選取 [應用程式選項] 索引標籤,然後按一下 [使用應用程式資訊清單供信任資訊使用]。如此將針對這個 ClickOnce 應用程式使用協力廠商品牌。

  9. 選取 [檔案] 索引標籤,並按一下 [應用程式目錄] 文字方塊旁的 [瀏覽] 按鈕。

  10. 選取您在步驟 2 中建立,含有應用程式檔案的目錄,並在 [資料夾選取] 對話方塊中,按一下 [確定]。

  11. 按一下 [填入] 按鈕,將所有的應用程式檔案加入到檔案清單中。如果您的應用程式含有一個以上的可執行檔,請從 [檔案類型] 下拉式清單選取 [進入點],將此部署的主要可執行檔標記為啟動應用程式 (如果您的應用程式只含有一個可執行檔,MageUI.exe 將會為您標記該檔)。

  12. 選取 [必要的使用權限] 索引標籤,並選取需要應用程式判斷提示的信任層級。預設值為 [完全信任],將會適用於多數的應用程式。

  13. 從功能表依序選取 [檔案] 及 [儲存],並儲存應用程式資訊清單。在儲存時,將會收到對應用程式資訊清單簽章的提示。

  14. 如果在檔案系統上擁有儲存為檔案的憑證,請使用 [簽章為憑證檔] 選項,並使用省略符號 (...) 按鈕從檔案系統選取憑證。

    -或-

    如果您的憑證保留在可從電腦存取的憑證存放區中,請選取 [以預存的憑證選項簽章],並從提供的清單中選取憑證。

  15. 從功能表依序選取 [檔案]、[新增] 及 [部署資訊清單],以建立您的部署資訊清單,然後在 [名稱] 索引標籤上,提供名稱和版本號碼 (在此範例中為 1.0.0.0)。

  16. 切換至 [更新] 索引標籤,並指定您要更新此應用程式的頻率。如果應用程式使用 ClickOnce 部署 API 來自我檢查更新,請清除標記為 [此應用程式應該檢查更新檔] 的核取方塊。

  17. 切換至 [應用程式參考] 索引標籤。按一下 [選取資訊清單] 按鈕,並選取您在先前步驟中建立的應用程式資訊清單,即可在此索引標籤上預先填入所有的值。

  18. 選擇 [儲存],並將部署資訊清單儲存至磁碟。在儲存時,將會收到對應用程式資訊清單簽章的提示。按一下 [取消] 儲存資訊清單,但不簽署。

  19. 提供所有應用程式檔案給客戶。

  20. 至此,客戶必須使用其自動產生的憑證簽署部署資訊清單。例如,如果客戶為名為 Adventure Works 的公司工作,則可使用 MakeCert.exe 工具產生自動簽署的憑證。接著,使用 Pvk2pfx.exe 工具將 MakeCert.exe 建立的檔案組合成可傳遞至 MageUI.exe 的 PFX 檔案。

    makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer
    pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx
    
  21. 有了產生的憑證後,客戶現在將開啟 MageUI.exe 中的部署資訊清單再將它儲存,藉此簽署部署資訊清單。簽署對話方塊出現時,客戶將選取 [簽章為憑證檔] 選項,然後選擇儲存在磁碟上的 PFX 檔案。

  22. 客戶將應用程式部署至其使用者。

請參閱

參考

資訊清單產生和編輯工具 (Mage.exe)

圖形用戶端、資訊清單產生和編輯工具 (MageUI.exe)

憑證建立工具 (Makecert.exe)