部署應用程式層級增益集 (2003 系統)

更新：2007 年 11 月

部署使用 Visual Studio Tools for Office 建立的 Microsoft Office 2003 增益集 (Add-In) 通常代表要使用下列檔案：

• 主要增益集組件，以及任何相依組件，例如資源、附屬或 Helper 程式庫。

• 應用程式資訊清單。

• 部署資訊清單 (如果適用的話)。

在您部署解決方案時，請將下列基本方針納入考量：

• 您的使用者必須已安裝 .NET Framework。如需詳細資訊，請參閱轉散發 .NET Framework 和使用多個 .NET Framework 版本。

• 您的使用者必須已安裝 Visual Studio 2005 Tools for Office Second Edition Runtime。如需詳細資訊，請參閱HOW TO：準備使用者電腦來執行 Office 方案 (2003 系統)。

  Visual Studio Tools for Office Runtime 包含 AddinLoader.dll，這是使用 Visual Studio Tools for Office 建立之 Microsoft Office 2003 增益集的載入器。如需詳細資訊，請參閱應用程式層級增益集的架構。

• 每部用戶端電腦都必須要有執行增益集所需的一組登錄項目。如需詳細資訊，請參閱應用程式層級增益集的登錄項目。

• 每位使用者的安全性原則中都必須對增益集組件和所有參考的組件授與完全信任。如需詳細資訊，請參閱執行 Office 方案的安全性需求 (2003 系統)。

若要部署增益集，請執行下列步驟：

• 將建置 (Build) 程序產生的應用程式資訊清單和必要的登錄項目複製至每部用戶端電腦。

• 將增益集組件 (可加上部署資訊清單，但這是選擇性的) 複製至部署位置。

部署位置可以是用戶端電腦上的本機資料夾，也可以是遠端位置，例如網路共用。如需詳細資訊，請參閱 部署模型 (2003 系統)和HOW TO：部署 Office 方案 (2003 系統)。

注意事項：
沒有任何部署選項可以讓使用者使用 Microsoft Office 2003 應用程式中的 [COM 增益集] 對話方塊，安裝使用 Visual Studio Tools for Office 建立的增益集。

使用安裝專案

當您使用 Visual Studio Tools for Office 建立增益集專案時，安裝專案就會自動加入至方案中。如果想要直接將方案部署至用戶端電腦，則可以使用這個安裝專案產生 Windows Installer (.msi) 檔案。Installer 會將方案檔複製到用戶端電腦，並建立執行增益集所需的登錄項目。如需安裝專案的詳細資訊，請參閱應用程式層級增益集的安裝專案 (2003 系統)。如需所需登錄項目的詳細資訊，請參閱應用程式層級增益集的登錄項目。

安裝專案限制

預設安裝專案具有多種限制：

• 安裝專案預設不會設定安全性原則。必須將完全信任授與增益集組件和所有參考的組件，增益集才能執行。您可以在安裝專案中加入設定安全性原則的步驟，也可以由系統管理員設定適當的安全性原則。如需詳細資訊，請參閱執行 Office 方案的安全性需求 (2003 系統)。

• 安裝專案預設不會檢查或安裝 Visual Studio Tools for Office Runtime 和 Microsoft Office 應用程式的主要 Interop 組件 (PIA)。如果使用者電腦未安裝這些元件，則不會執行增益集。如需必要條件的詳細資訊，請參閱 HOW TO：準備使用者電腦來執行 Office 方案 (2003 系統)。

使用發行精靈

如果想要啟用自動組件更新，則可以使用 [發行精靈]。[發行精靈] 會建立方案的部署資訊清單，並將所有必要的檔案複製至部署位置。

在 [方案總管] 中，專案之快速鍵功能表上的 [發行] 命令會啟動 [發行精靈]。您可以識別要將方案發行至其中的資料夾位置，然後精靈就會將部署資訊清單複製至該資料夾中。此外，這個精靈也會將組件和更新的應用程式資訊清單複製到主要部署資料夾的子資料夾中。子資料夾名稱含有版本號碼。如果已選取 [專案設計工具] 之 [發行] 窗格內的 [隨著每次發行自動遞增修訂] 選項，則每次您發行方案時就會建立新的子資料夾。這樣舊的版本還是可以使用。應用程式和部署資訊清單會確保方案永遠使用正確的組件。如需詳細資訊，請參閱Office 方案中的應用程式和部署資訊清單、HOW TO：使用發行精靈部署方案檔 (2003 系統) 和 專案設計工具、發行頁 (2007 系統)。

發行精靈限制

[發行精靈] 具有多種限制：

• [發行精靈] 並不會建立執行增益集所需的登錄項目。如果您使用 [發行精靈] 部署增益集，則必須自行建立這些登錄項目，例如使用登錄檔 (.reg)。此外，[發行精靈] 也不會覆寫或移除您在建置專案時於開發電腦上所建立的登錄項目。如需建置專案的詳細資訊，請參閱 Office 方案建置程序概觀。如需所需登錄項目的詳細資訊，請參閱應用程式層級增益集的登錄項目。

• [發行精靈] 並不會在使用者的安全性原則中將完全信任授與增益集組件。必須將完全信任授與增益集組件和所有參考的組件，增益集才能執行。如需詳細資訊，請參閱執行 Office 方案的安全性需求 (2003 系統)。

更新部署的組件 (版本控制)

如果您將名為 OutlookAddin1 的方案部署至資料夾 C:\DeployFolder 中，其檔案結構看起來就會像這樣：

C:\DeployFolder

這個資料夾包含下列檔案和子資料夾：

• 部署資訊清單 (OutlookAddin1.application)。

  C:\DeployFolder\OutlookAddin1_1.0.0.0

  這個資料夾內含下列檔案：

  • 組件。

  • 應用程式資訊清單 (OutlookAddin1.dll.manifest)。

  • 部署資訊清單的複本。

如果您更新組件並重新發行方案，此目錄結構看起來將會像這樣：

C:\DeployFolder

這個資料夾包含下列檔案和子資料夾：

• 部署資訊清單 (更新以指向 C:\DeployFolder\OutlookAddin1_1.0.0.1 中的應用程式資訊清單)。

  C:\DeployFolder\OutlookAddin1_1.0.0.0

  這個資料夾內含下列檔案：

  • 原始組件。

  • 原始應用程式資訊清單。

  • 原始部署資訊清單。

  C:\DeployFolder\OutlookAddin1_1.0.0.1

  這個資料夾內含下列檔案：

  • 更新的組件。

  • 更新的應用程式資訊清單。

  • 更新部署資訊清單的複本。

每次更新增益集組件時，都會重複產生這個結構。

從命令列使用 MSBuild

您也可以在命令提示字元中使用 MSBuild 來發行方案。當您在命令提示字元中使用 MSBuild 時，您就可以將方案檔發行至某個位置，同時將部署資訊清單和更新的應用程式資訊清單修改為指向不同的位置。若要在命令提示字元中執行 MSBuild 以發行方案，請使用下列語法。

msbuild.exe /target:Publish /property:UpdateUrl=<update location> /property:PublishDir=<publish location> <project file>

例如，如果您想要將名為 OutlookAddin1 的 C# 專案發行至共用資料夾 \\PublishServer\PublishFolder，但是將來想要將部署資訊清單、更新的應用程式資訊清單和增益集組件移至共用資料夾 \\DeploymentServer\DeploymentFolder 時，則可以執行下列命令。

msbuild.exe /target:Publish /property:PublishDir=\\PublishServer\PublishFolder\ /property:UpdateUrl=\\DeploymentServer\DeploymentFolder\ C:\OutlookAddin1\OutlookAddin1.csproj

如需在命令提示字元中使用 MSBuild 的詳細資訊，請參閱從命令列建置 ClickOnce 應用程式。

在 Windows Vista 部署增益集

如果使用者是在 Windows Vista 上執行方案，則在設定部署時必須考慮 Windows Vista 安全性限制，否則使用者會無法安裝更新。

如果是使用 [發行精靈] 將增益集更新發行至 HTTP 或網路位置，則執行 Windows Vista 之電腦上的使用者只有在下列情況下才可以載入組件更新：

• 應用程式資訊清單已安裝至使用者電腦的資料夾中，而且具有標準使用權限的應用程式可以修改該資料夾。

  -或-

• 使用者是使用系統管理員使用權限來執行 Microsoft Office 應用程式。

發行增益集的更新時，Visual Studio Tools for Office Runtime 會在使用者下次開啟應用程式時，嘗試將更新的應用程式資訊清單複製到使用者電腦。執行階段接著會使用更新之資訊清單中的資訊載入更新的組件。在 Windows Vista 上，使用標準使用權限執行的應用程式無法覆寫特定資料夾中的檔案 (含 %ProgramFiles%)。因此，如果應用程式資訊清單是安裝至需要系統管理員使用權限的資料夾，則只有在使用者以系統管理員身分執行應用程式時，應用程式才可以載入更新的組件。如果應用程式資訊清單是安裝至不需要系統管理員使用權限的資料夾 (如 %UserProfile%)，則使用者也可以使用標準使用權限來執行應用程式。

注意事項：
使用增益集專案建立的安裝專案預設會將應用程式資訊清單安裝至 %CommonProgramFiles%。

應用程式和部署資訊清單

應用程式和部署資訊清單可讓增益集使用最新的組件自行更新。如需詳細資訊，請參閱 Office 方案中的應用程式和部署資訊清單。

您可能會在方案的存留期 (Lifetime) 內，多次變更方案的應用程式或部署資訊清單。以下是您會更新資訊清單的兩個主要原因：

• 您部署了新版本的方案組件。如需詳細資訊，請參閱HOW TO：更新部署的組件檔 (2003 系統)。

• 您變更了方案組件的位置。如需詳細資訊，請參閱HOW TO：變更應用程式層級增益集的位置 (2003 系統)。

請參閱

概念

部署 Office 方案 (2003 系統)

應用程式層級增益集的安裝專案 (2003 系統)

設定和部署專案

參考

應用程式層級增益集的登錄項目