{"id":55001101,"date":"2017-10-01T00:00:00","date_gmt":"2020-05-13T21:26:55","guid":{"rendered":"http:\/\/access-im-unternehmen.aix-dev.de\/aiu\/?p=1101"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-30T00:00:00","slug":"Setup_fuer_ein_VSTOAddIn","status":"publish","type":"post","link":"https:\/\/access-im-unternehmen.de\/Setup_fuer_ein_VSTOAddIn\/","title":{"rendered":"Setup für ein VSTO-AddIn"},"content":{"rendered":"

\"\"<\/p>\n

Im Beitrag „Effizienz-Hacks: Mailabruf erschweren“ haben wir gezeigt, wie Sie mit Visual Studio 2015 Community Edition ein VSTO-Add-In erstellen, das in Outlook integriert wird. Diesmal wollen wir dem Projekt ein Setup hinzufügen, mit dem Sie das Add-In auch an andere Rechner weitergeben können.<\/b><\/p>\n

Voraussetzungen<\/h2>\n

Voraussetzung ist ein installiertes Visual Studio 2015 in der Community Edition sowie die aktuellsten Erweiterungen, die auch den für das Hinzufügen eines Setup-Projekts benötigten Erweiterungen mit sich bringt. Ausgangspunkt für dieses Projekt ist das im Beitrag Effizienz-Hacks: Mailabruf erschweren <\/b>(www.access-im-unternehmen.de\/1095<\/b>) erstellte Outlook-VSTO-Projekt.<\/p>\n

Setup-Projekt hinzufügen<\/h2>\n

Bevor wir das Setup-Projekt hinzufügen, eine kurze Erläuterung des geplanten Aufbaus: Im oben genannten Beitrag haben wir nur eine einfache Lösung programmiert, die aus einem einzelnen Projekt besteht.<\/p>\n

Auch ein einzelnes Projekt befindet sich jedoch in einer Projektmappe. Hier wird der Begriff der Projektmappe nun wichtig, denn wir fügen dieser nun ein zweites Projekt hinzu – eben das Setup-Projekt. Deshalb verwenden Sie auch nicht einfach den Befehl Da-tei|Neu|Projekt…<\/b>, wie Sie es sonst tun, sondern markieren den Eintrag der Projektmappe im Projektmappen-Explorer, klicken mit der rechten Maustaste darauf und wählen aus dem Kontextmenü den Eintrag Hinzufügen|Neues Projekt…<\/b> aus (s. Bild 1).<\/p>\n

\"Hinzufügen<\/p>\n

Bild 1: Hinzufügen eines neuen Projekts zu einer Projektmappe<\/span><\/b><\/p>\n

Daraufhin erscheint der Dialog Neues Projekt <\/b>hinzufügen. Hier navigieren Sie zum Bereich Andere Projekttypen|Visual Studio Installer <\/b>(wenn Sie diesen nicht finden, prüfen Sie, ob Sie die aktuellsten Visual Studio-Erweiterungen installiert haben) und wählen den Eintrag Setup Project <\/b>aus. Geben Sie als Namen den Wert OutlookAddIn_Setup <\/b>ein (s. Bild 2).<\/p>\n

\"Auswählen<\/p>\n

Bild 2: Auswählen des Projekttyps<\/span><\/b><\/p>\n

Projektausgabe hinzufügen<\/h2>\n

Nach einem Klick auf OK<\/b> wird das neue Projekt als Unterprojekt der Projektmappe angelegt.<\/p>\n

Außerdem erscheint im mittleren Bereich von Visual Studio das Element File System (OutlookAddIn_Setup)<\/b>.<\/p>\n

Klicken Sie hier mit der rechten Maustaste auf den Eintrag Application Folder <\/b>und wählen Sie aus dem Kontextmenü den Befehl Add|Projektausgabe… <\/b>aus (s. Bild 3).<\/p>\n

\"Hinzufügen<\/p>\n

Bild 3: Hinzufügen der Projektausgabe<\/span><\/b><\/p>\n

Nun erscheint der Dialog Projektausgabegruppe hinzufügen<\/b>, wo Sie den Eintrag Primäre Ausgabe <\/b>hinzufügen und auf OK <\/b>klicken (s. Bild 4). Damit fügen Sie dem Setup-Projekt im Projektmappen-Explorer einen Eintrag Primäre Ausgabe from Outlook_AddIn <\/b>hinzu. Außerdem werden einige Einträge unter Detected Dependencies <\/b>angezeigt, die beim Setup berücksichtigt werden sollen.<\/p>\n

\"Auswahl<\/p>\n

Bild 4: Auswahl der primären Ausgabe<\/span><\/b><\/p>\n

Weitere Dateien hinzufügen<\/h2>\n

Damit legen Sie nun fest, welche Dateien alle im Setup landen. Die Option Primäre Ausgabe fügt jedoch nur die im Standardfall benötigten Dateien hinzu.<\/p>\n

Wenn Sie ein Add-In weitergeben wollen, benötigen Sie einige weitere Dateien. Welche Dateien Sie überhaupt benötigen, können Sie abgleichen, wenn Sie sich ansehen, welche Dateien beim Debuggen des Add-In-Projekts in den Ordner …\/bin\/debug <\/b>des Projekts geschrieben werden (s. Bild 5).<\/p>\n

\"Dateien,<\/p>\n

<\/p>\n

Bild 5: Dateien, die beim Debuggen im Zielordner landen<\/span><\/b><\/p>\n

Im Setup landen jedoch nur die Dateien, die im Bereich FileSystem <\/b>von OutlookAddIn_Setup<\/b> aufgeführt werden.<\/p>\n

Welche Dateien unter Primäre Ausgabe … <\/b>zu verstehen sind, erfahren Sie, wenn Sie den Kontextmenü-Eintrag Ausgaben von Primäre Ausgaben from OutlookAddIn (Active) <\/b>auswählen – in diesem Fall die .dll <\/b>plus eine .config<\/b>-Datei (s. Bild 8).<\/p>\n

\"Dateien,<\/p>\n

Bild 6: Dateien, die in der Ausgabe des Setup landen<\/span><\/b><\/p>\n

Vor dem ersten Erstellen und Testen des Setups sollten wir also noch die fehlenden Dateien hinzufügen – in diesem Fall also die folgenden Dateien:<\/p>\n