Freigeben über

Bereitstellen von Add-Ins auf Anwendungsebene (2003 System)

  • Artikel

Aktualisiert: November 2007

Betrifft

Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office.

Projekttyp

  • Projekte auf Anwendungsebene

Microsoft Office-Version

  • Microsoft Office 2003

Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Wenn Sie ein Microsoft Office 2003-Add-In bereitstellen, das mit Visual Studio Tools for Office erstellt wird, arbeiten Sie im Allgemeinen mit den folgenden Dateien:

  • Die primäre Add-In-Assembly und sämtliche abhängigen Assemblys, z. B. Ressourcen, Satelliten und Hilfsbibliotheken.

  • Das Anwendungsmanifest.

  • Das Bereitstellungsmanifest (falls zutreffend).

Beachten Sie beim Bereitstellen der Projektmappe die folgenden grundlegenden Richtlinien:

Führen Sie zum Bereitstellen des Add-Ins die folgenden Schritte aus:

  • Kopieren Sie das während des Buildprozesses generierte Anwendungsmanifest und die erforderlichen Registrierungseinträge auf die einzelnen Clientcomputer.

  • Kopieren Sie die Add-In-Assemblys (und optional das Bereitstellungsmanifest) an den Bereitstellungsspeicherort.

Der Bereitstellungsspeicherort kann ein lokaler Ordner auf dem Clientcomputer oder ein Remotespeicherort, z. B. eine Netzwerkfreigabe, sein. Weitere Informationen finden Sie unter Bereitstellungsmodelle (2003 System) und unter Gewusst wie: Bereitstellen von Office-Projektmappen (2003 System).

Hinweis:

Es gibt keine Bereitstellungsoption, die es Endbenutzern ermöglicht, über das Dialogfeld COM-Add-Ins in Microsoft Office 2003-Anwendungen ein Add-In zu installieren, das mithilfe von Visual Studio Tools for Office erstellt wurde.

Verwenden des Setup-Projekts

Wenn Sie ein Add-In-Projekt mit Visual Studio Tools for Office erstellen, wird der Projektmappe automatisch ein Setup-Projekt hinzugefügt. Wenn Sie die Projektmappe direkt auf dem Clientcomputer bereitstellen möchten, können Sie mithilfe dieses Setup-Projekts eine Windows Installer-Datei (MSI-Datei) generieren Das Installationsprogramm kopiert die Projektmappendateien auf den Clientcomputer und erstellt die zum Ausführen des Add-Ins erforderlichen Registrierungseinträge. Weitere Informationen über das Setup-Projekt finden Sie unter Setup-Projekte für Add-Ins auf Anwendungsebene (2003 System). Weitere Informationen über die erforderlichen Registrierungseinträge finden Sie unter Registrierungseinträge für Add-Ins auf Anwendungsebene.

Einschränkungen des Setup-Projekts

Für das Setup-Standardprojekt gelten mehrere Einschränkungen:

  • Das Setup-Projekt legt die Sicherheitsrichtlinie nicht standardmäßig fest. Der Add-In-Assembly und sämtlichen Assemblys, auf die verwiesen wird, muss volle Vertrauenswürdigkeit gewährt werden, damit das Add-In ausgeführt werden kann. Sie können dem Setup-Projekt das Konfigurieren der Sicherheitsrichtlinie als weiteren Schritt hinzufügen oder die entsprechende Sicherheitsrichtlinie von einem Administrator festlegen lassen. Weitere Informationen hierzu finden Sie unter Sicherheitsanforderungen für die Ausführung von Office-Projektmappen (2003 System).

  • Standardmäßig überprüft das Setup-Projekt nicht, ob die Visual Studio Tools for Office-Laufzeit und die primäre Interopassembly (PIA) für die Microsoft Office-Anwendung vorhanden sind und installiert diese Komponenten auch nicht. Wenn diese Komponenten nicht auf dem Endbenutzercomputer installiert sind, wird das Add-In nicht ausgeführt. Weitere Informationen zu den Voraussetzungen finden Sie unter Gewusst wie: Vorbereiten von Endbenutzercomputern für die Ausführung von Office-Projektmappen (2003 System).

Verwenden des Webpublishing-Assistenten

Wenn Sie automatische Assemblyaktualisierungen aktivieren möchten, können Sie den Webpublishing-Assistenten verwenden. Der Webpublishing-Assistent erstellt ein Bereitstellungsmanifest für die Projektmappe und kopiert alle erforderlichen Dateien an den Bereitstellungsspeicherort.

Sie können den Webpublishing-Assistenten starten, indem Sie im Projektmappen-Explorer im Kontextmenü des Projekts den Befehl Veröffentlichen auswählen. Wenn Sie den Speicherort des Ordners angeben, in dem Sie die Projektmappe veröffentlichen möchten, kopiert der Assistent das Bereitstellungsmanifest in diesen Ordner. Außerdem kopiert der Assistent die Assemblys und ein aktualisiertes Anwendungsmanifest in einen Unterordner des Hauptbereitstellungsordners. Der Name des Unterordners enthält eine Versionsnummer. Wenn Sie im Projekt-Designer im Bereich Veröffentlichen die Option Revisionsnummer automatisch mit jeder Veröffentlichung erhöhen auswählen, wird bei jeder Veröffentlichung der Projektmappe ein neuer Unterordner erstellt. Ältere Versionen bleiben weiterhin verfügbar. Durch das Anwendungs- und das Bereitstellungsmanifest wird sichergestellt, dass die Projektmappe immer die korrekte Assembly verwendet. Weitere Informationen finden Sie unter Anwendungs- und Bereitstellungsmanifeste in Office-Projektmappen, Gewusst wie: Bereitstellen von Projektmappendateien mit dem Webpublishing-Assistenten (2003 System) und Seite "Veröffentlichen", Projekt-Designer (2007 System).

Einschränkungen des Webpublishing-Assistenten

Für den Webpublishing-Assistenten gelten mehrere Einschränkungen:

  • Der Webpublishing-Assistent erstellt nicht die Registrierungseinträge, die zum Ausführen des Add-Ins erforderlich sind. Bei Bereitstellung eines Add-Ins mit dem Webpublishing-Assistent müssen Sie diese Registrierungseinträge eigenhändig erstellen, z. B. anhand einer Registrierungsdatei (REG-Datei). Der Webpublishing-Assistent überschreibt oder entfernt auch die Registrierungseinträge nicht, die beim Erstellen des Projekts auf dem Entwicklungscomputer erstellt werden. Weitere Informationen über das Erstellen von Projekten finden Sie unter Übersicht über das Erstellen von Office-Projektmappen. Weitere Informationen über die erforderlichen Registrierungseinträge finden Sie unter Registrierungseinträge für Add-Ins auf Anwendungsebene.

  • Der Webpublishing-Assistent gewährt der Add-In-Assembly in der Sicherheitsrichtlinie des Endbenutzers keine vollständige Vertrauenswürdigkeit. Der Add-In-Assembly und sämtlichen Assemblys, auf die verwiesen wird, muss volle Vertrauenswürdigkeit gewährt werden, damit das Add-In ausgeführt werden kann. Weitere Informationen hierzu finden Sie unter Sicherheitsanforderungen für die Ausführung von Office-Projektmappen (2003 System).

Aktualisieren bereitgestellter Assemblys (Versionsverwaltung)

Wenn Sie eine Projektmappe mit dem Namen OutlookAddin1 im Ordner C:\DeployFolder bereitstellen, ergibt sich folgende Dateistruktur:

C:\DeployFolder

Dieser Ordner enthält die folgende Datei und den folgenden Unterordner:

  • Das Bereitstellungsmanifest (OutlookAddin1.application).

    C:\DeployFolder\OutlookAddin1_1.0.0.0

    Dieser Ordner enthält die folgenden Dateien:

    • Die Assemblys.

    • Das Anwendungsmanifest (OutlookAddin1.dll.manifest).

    • Eine Kopie des Bereitstellungsmanifests.

Wenn Sie die Assembly aktualisieren und die Projektmappe erneut veröffentlichen, ergibt sich folgende Verzeichnisstruktur:

C:\DeployFolder

Dieser Ordner enthält die folgende Datei und die folgenden Unterordner:

  • Das Bereitstellungsmanifest (aktualisiert, sodass es auf das Anwendungsmanifest in C:\DeployFolder\OutlookAddin1_1.0.0.1 zeigt).

    C:\DeployFolder\OutlookAddin1_1.0.0.0

    Dieser Ordner enthält die folgenden Dateien:

    • Die ursprünglichen Assemblys.

    • Das ursprüngliche Anwendungsmanifest.

    • Das ursprüngliche Bereitstellungsmanifest.

    C:\DeployFolder\OutlookAddin1_1.0.0.1

    Dieser Ordner enthält die folgenden Dateien:

    • Die aktualisierten Assemblys.

    • Das aktualisierte Anwendungsmanifest.

    • Eine Kopie des aktualisierten Bereitstellungsmanifests.

Diese Struktur wird bei jeder Aktualisierung der Add-In-Assembly erneut verwendet.

Verwenden von MSBuild über die Befehlszeile

Sie können zur Veröffentlichung der Projektmappe auch MSBuild an einer Eingabeaufforderung verwenden. Wenn Sie MSBuild an einer Eingabeaufforderung verwenden, können Sie die Projektmappendateien an einem Speicherort veröffentlichen und gleichzeitig das Bereitstellungsmanifest und das aktualisierte Anwendungsmanifest so modifizieren, dass sie auf einen anderen Speicherort zeigen. Um zur Veröffentlichung einer Projektmappe MSBuild an einer Eingabeaufforderung auszuführen, verwenden Sie folgende Syntax.

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

Wenn Sie beispielsweise ein C#-Projekt mit dem Namen OutlookAddin1 im freigegebenen Ordner \\PublishServer\PublishFolder veröffentlichen möchten, jedoch für später planen, das Bereitstellungsmanifest, das aktualisierte Anwendungsmanifest und die Add-In-Assembly in den freigegebenen Ordner \\DeploymentServer\DeploymentFolder zu verschieben, führen Sie folgenden Befehl aus.

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

Weitere Informationen zur Verwendung von MSBuild an einer Eingabeaufforderung finden Sie unter Erstellen von ClickOnce-Anwendungen über die Befehlszeile.

Bereitstellen von Add-Ins unter Windows Vista

Wenn Endbenutzer Ihre Projektmappe unter Windows Vista ausführen, müssen Sie beim Einrichten der Bereitstellung die Sicherheitsbeschränkungen von Windows Vista berücksichtigen, da Benutzer sonst keine Updates installieren können.

Wenn Sie den Webpublishing-Assistenten verwenden, um Add-In-Aktualisierungen an einem HTTP-Speicherort oder in einem Netzwerkverzeichnis zu veröffentlichen, können Endbenutzer auf Computern, auf denen Windows Vista ausgeführt wird, unter folgenden Bedingungen Assemblyaktualisierungen laden:

  • Das Anwendungsmanifest ist in einem Ordner auf dem Computer des Endbenutzers installiert, der von einer Anwendung mit Standardberechtigungen geändert werden kann.

    - oder -

  • Der Benutzer führt die Microsoft Office-Anwendung mit Administratorberechtigungen aus.

Wenn Sie eine Aktualisierung für ein Add-In veröffentlichen, versucht die Visual Studio Tools for Office-Laufzeit, beim nächsten Öffnen der Anwendung das aktualisierte Anwendungsmanifest auf den Computer des Endbenutzers zu kopieren. Die Laufzeit verwendet dann die Informationen im aktualisierten Manifest, um die aktualisierte Assembly zu laden. Unter Windows Vista können Anwendungen, die mit Standardberechtigungen ausgeführt werden, in bestimmten Ordnern keine Dateien überschreiben, darunter %ProgramFiles%. Wenn das Anwendungsmanifest in einem Ordner installiert wird, der Administratorberechtigungen erfordert, kann die Anwendung die aktualisierte Assembly daher nur laden, wenn der Benutzer die Anwendung als Administrator ausführt. Der Benutzer kann die Anwendung auch mit Standardberechtigungen ausführen, wenn das Anwendungsmanifest in einem Ordner installiert ist, der keine Administratorberechtigungen erfordert, beispielsweise %UserProfile%.

Hinweis:

Standardmäßig installiert das Setup-Projekt, das mit Add-In-Projekten erstellt wird, das Anwendungsmanifest in %CommonProgramFiles%.

Anwendungs- und Bereitstellungsmanifest

Mit dem Anwendungs- und dem Bereitstellungsmanifest kann ein Add-In mit den Daten für die neueste Assembly aktualisiert werden. Weitere Informationen finden Sie unter Anwendungs- und Bereitstellungsmanifeste in Office-Projektmappen.

Unter Umständen ändern Sie im Laufe der Lebensdauer einer Projektmappe das Anwendungsmanifest und das Bereitstellungsmanifest für die Projektmappe mehrfach. Es gibt zwei Hauptgründe, Manifeste zu aktualisieren:

Siehe auch

Konzepte

Bereitstellen von Office-Projektmappen (2003 System)

Setup-Projekte für Add-Ins auf Anwendungsebene (2003 System)

Setup- und Bereitstellungsprojekte

Referenz

Registrierungseinträge für Add-Ins auf Anwendungsebene