Wenn Sie ein Abonnement des Magazins 'Access im Unternehmen' besitzen, können Sie sich anmelden und den kompletten Artikel lesen.
Anderenfalls können Sie das Abonnement hier im Shop erwerben.
COM-Add-Ins: Setup erstellen
Wenn Sie ein COM-Add-In mit Visual Studio 2013 erstellen, möchten Sie es vermutlich nicht nur auf dem Entwicklungsrechner einsetzen, sondern dieses auch weitergeben. Dazu erstellt man der Regel ein Setup, das dann auf den Zielrechner kopiert und dort ausgeführt wird. Der Vorteil ist, dass dieses die benötigten Dateien direkt an der richtigen Stelle speichert und die Registry-Einträge zum System hinzufügt. Dieser Beitrag zeigt die Schritte, die zum Erstellen eines solchen Setups erforderlich sind.
Voraussetzungen
Um die in diesem Beitrag beschriebenen Techniken umzusetzen, benötigen Sie eine Installation von Visual Studio 2013, zum Beispiel die kostenlose Community-Edition. Zusätzlich brauchen wir noch eine Komponente, um das Setup zu erstellen – mehr dazu weiter unten. Schließlich beschreibt der Beitrag COM-Add-Ins mit Visual Studio Community 2013 (www.access-im-unternehmen.de/982), wie Sie das Grundgerüst eines COM-Add-In-Projekts entwickeln, das wir hier weitergeben möchten.
Weitergabe
Wenn Sie dieses Add-In an andere Benutzer weitergeben beziehungsweise auf anderen Rechnern installieren wollen, müssen Sie Visual Studio 2013 noch eine Komponente hinzufügen. Dies erledigen Sie wie in den nachfolgend beschriebenen Schritten.
Als Erstes legen Sie in Visual Studio mit dem Befehl Datei|Neu|Projekt ein neues Projekt an. Dabei wählen Sie im linken Bereich den Eintrag Andere Projekttypen|Setup und Bereitstellung aus. Es erscheint der Eintrag InstallShield Limited Edition aktivieren. Wählen Sie diesen aus, legen Sie eine Bezeichnung für das neue Projekt fest (in diesem Fall SetupUndBereitstellung) und klicken Sie auf OK (s. Bild 1).
Bild 1: Auswählen der Install Shield Limited EditionNach dem Klick auf OK erscheint ein Internet-Browser und zeigt eine Seite mit weiteren Anweisungen an.
Hier klicken Sie auf den Link Rufen Sie die Downloadseite auf (s. Bild 2).
Bild 2: Download-Link auswählenEs erscheint nun eine weitere Internetseite, auf der Sie einige Registrierungsinformationen eintragen (s. Bild 3). Klicken Sie anschließend auf die Schaltfläche Download Now.
Bild 3: Eingeben einiger RegistrierungsinformationenDanach erhalten Sie bereits die Seriennummer sowie den Link zum Download der Komponente (s. Bild 4).
Bild 4: Abruf von Download und SeriennummerDie Seriennummer kopieren Sie bitte an einen sicheren Ort, da Sie diese später zur Aktivierung von InstallShield benötigen. Sie erhalten diese allerdings auch noch per E-Mail.
Laden Sie die Komponente herunter und installieren Sie diese.
Gegebenenfalls müssen Sie noch eine weitere Komponente namens Microsoft Visual C++ 2008 SP1 Redistributable Package (x86) herunterladen und installieren – in diesem Fall erscheint eine entsprechende Meldung. Danach wird dann direkt die InstallShield 2013 Limited Edition installiert.
Damit sind die Arbeiten an dieser Stelle beendet. Sie müssen nun Visual Studio 2013 neu starten.
Anschließend wählen Sie erneut den Menüeintrag Datei|Neu|Projekt. Wählen Sie links wieder den Eintrag Andere Projekttypen|Setup und Bereitstellung aus. In den Vorlagen erscheint nun ein Eintrag namens InstallShield Limited Edition Project (s. Bild 5).
Bild 5: Aktivierung von InstallShieldMarkieren Sie diesen Eintrag und klicken Sie erneut auf OK. Nun erscheint der Dialog aus Bild 6, wo Sie die erste Option wählen.
Bild 6: Aktivierung/Registrierung von InstallShieldSchließlich geben Sie die soeben auf der Internetseite angezeigte Seriennummer in den folgenden Dialog ein (s. Bild 7). Der Assistent validiert nun die Seriennummer und aktiviert das Produkt. Sie können das Projekt nun vorerst schließen.
Bild 7: Eingabe der SeriennummerWeitergabe-Projekt erstellen
Nun wollen wir unser Projekt für die Weitergabe vorbereiten. Dazu öffnen Sie zunächst das gewünschte Projekt – in unserem Fall das im Beitrag COM-Add-Ins mit Visual Studio Community 2013 (www.access-im-unternehmen.de/982) erstellte Projekt Textbausteine2013. Wählen Sie dann den Menübefehl Datei|Hinzufügen|Neues Projekt aus. Hier selektieren Sie nun den Eintrag lnstall Limited Edition Project. Außerdem legen Sie als Name des Projekts den Wert Setup_Textbausteine2013 fest (s. Bild 8).
Bild 8: Hinzufügen des Setup-Projekts zu dem für die Weitergabe bestimmten Projekt
Neben dem eigentlich Projekt erscheint das Setup-Projekt nun zusätzlich in der Projektmappe – samt einem Bereich, der die weiteren Schritte unterstützt (s. Bild 9).
Bild 9: Das Setup-Projekt in der ProjektmappeKlicken Sie nun im Projekt-Explorer doppelt auf den Eintrag Project Assistant (siehe Bild 10).
Bild 10: Auswahl des Projekt-AssistentenHier klicken Sie nun unten auf Application Information und ergänzen die Informationen zur Anwendung wie in Bild 11. Ändern Sie insbesondere den Wert unter Specify your application name noch von Setup_Textbausteine2013 beispielsweise in amvTextbausteine2013, da dies der Name ist, unter dem das Add-In beispielsweise im Setup und in der Liste der installierten Programme in der Systemsteuerung angezeigt wird.
Bild 11: AnwendungsinformationenAnschließend wechseln Sie zum Bereich Application Files und klicken dort auf die Schaltfläche Add Project Outputs. Hier wählen Sie den Eintrag Primäre Ausgabe aus und schließen den Dialog wieder (s. Bild 12).
Bild 12: Primäre Ausgabe einstellen
Dateien hinzufügen
Klicken Sie dann im gleichen Dialog auf die Schaltfläche Add Files. Es erscheint ein Datei öffnen-Dialog, mit dem Sie zu dem Verzeichnis des eigentlichen Projekts navigieren, das die Dateien mit der Dateiendung .vsto und .manifest enthält. Wählen Sie beide aus und klicken Sie auf Öffnen (s. Bild 13).
Bild 13: Auswahl der .vsto- und der .manifest-DateiDie gewählten Dateien erscheinen nun in der Dateistruktur für den Zielcomputer im Verzeichnis [INSTALLDIR] (s. Bild 14).
Bild 14: Die Anwendungsdaten mit den soeben ausgewählten Dateien.NET-Framework als Komponente hinzufügen
Nun fügen wir noch die übrigen für die Funktion des Add-Ins nötigen Komponenten zum Setup hinzu. Das ist beispielsweise das .NET-Framework.
Klicken Sie im Projektmappen-Explorer doppelt auf den Eintrag Specify Application Data|Redistributables und wählen Sie links den Eintrag Microsoft .NET Framework 4.0 (FULL) aus (s. Bild 15).
Bild 15: Hinzufügen des benötigten .NET-FrameworksVisual Studio 2013 Tools for Office-Runtime als Komponente hinzufügen
Dies ist die zweite zusätzlich benötigte Komponente. Hier ist die Vorgehensweise etwas komplizierter. Als Erstes ermitteln Sie eine GUID.
Dazu verwenden Sie den Befehl Extras|GUID erstellen von Visual Studio. Im nun erscheinenden Dialog wählen Sie die Option Registrierungsformat und klicken dann auf Kopieren (s. Bild 16).
Bild 16: GUID ermittelnSchließen Sie den Dialog anschließend wieder. In der Zwischenablage befindet sich eine GUID wie etwa {ABC49891-4A4C-4E07-B540-FB663B5BA318}.
Erstellen Sie dann eine neue Textdatei und fügen Sie den Inhalt aus Listing 1 ein.
<?xml version="1.0" encoding="UTF-8"?>
<SetupPrereq>
<conditions>
<condition Type="32" Comparison="2"
Path="HKEY_LOCAL_MACHINESOFTWAREMicrosoftVSTO Runtime Setupv4R"
FileName="Version" ReturnValue="10.0.50903" Bits="2"></condition>
<condition Type="32" Comparison="2"
Path="HKEY_LOCAL_MACHINESOFTWAREWow6432NodeMicrosoftVSTO Runtime Setupv4R"
FileName="Version" ReturnValue="10.0.50903" Bits="2"></condition>
</conditions>
<files>
<file LocalFile="<ISProductFolder>SetupPrerequisitesVSTORvstor_redist.exe"
Dies war die Leseprobe dieses Artikels.
Melden Sie sich an, um auf den vollständigen Artikel zuzugreifen.