Wdrażanie rozwiązania do pakietu Office przy użyciu technologii ClickOnce

Artykuł
06/10/2015

Można wdrożyć swoje Office 2013 lub Office 2010 rozwiązania w mniejszą liczbę czynności, korzystając z technologii ClickOnce.Podczas publikowania aktualizacji rozwiązanie automatycznie je wykryje i zainstaluje.Niedogodność polega na tym, że w technologii ClickOnce rozwiązanie trzeba zainstalować osobno dla każdego użytkownika komputera.W związku z tym w sytuacjach, gdy na jednym komputerze rozwiązania będzie używało kilka osób, warto rozważyć użycie Instalatora Windows (pliku .msi).

W tym temacie

Publikowanie rozwiązania przy użyciu technologii ClickOnce
Określa, jak chcesz udzielić zaufania do rozwiązania
Pomagają użytkownikom zainstalować rozwiązania
Udostępnij dokument rozwiązania na komputerze użytkownika końcowego (tylko w przypadku dostosowania dokumentu na poziomie)
Udostępnij dokument rozwiązania na serwerze z programem SharePoint (tylko w przypadku dostosowania dokumentu na poziomie)
Utwórz niestandardowe Instalatora
Publikowanie aktualizacji
Zmień lokalizację instalacji rozwiązania
Wycofać rozwiązanie do starszej wersji

Aby uzyskać więcej informacji dotyczących sposobu wdrażania rozwiązanie Office, tworząc plik Instalatora Windows, zobacz Wdrażanie rozwiązania do pakietu Office przy użyciu Instalatora Windows.

Publikowanie rozwiązania

Możesz opublikować rozwiązania przy użyciu Kreatora publikowania lub Designer projektu.W tej procedurze użyjesz tu Designer projektu ponieważ zapewnia pełny zestaw opcji publikowania.Zobacz Kreator publikacji (Office Development w Visual Studio).

Aby opublikować rozwiązanie

W Eksploratora rozwiązań, wybierz węzeł, który ma nazwę projektu.
Na pasku menu wybierz polecenie projektu, NazwaProjektu właściwości.
W Designer projektu, wybierz polecenie publikowania kartę, która na poniższej ilustracji pokazano.
W publikacji lokalizacji folderu (serwer ftp lub ścieżka pliku) wprowadź ścieżkę do folderu, w którym ma Designer projektu do kopiowania plików rozwiązania.

Możesz użyć dowolnego z następujących typów ścieżek.
- Ścieżka lokalna (na przykład C:\FolderName\FolderName).
- Ścieżka jednolite UNC (Naming Convention) do folderu w sieci (na przykład \\ServerName\FolderName).
- Ścieżka względna (na przykład PublishFolder\, który jest folder, w którym projekt został opublikowany domyślnie).
W adres URL folderu instalacji wprowadź w pełni kwalifikowana ścieżka lokalizacji, gdzie użytkownicy końcowi będą znaleźć rozwiązania.

Jeśli nie znasz jeszcze tej lokalizacji, nie wypełniaj pola.Domyślnie funkcja ClickOnce szuka aktualizacji w folderze, z którego użytkownicy instalują rozwiązanie.
Naciśnij przycisk Wymagania wstępne.
W wymagań wstępnych okna dialogowego wpisz upewnij się, że Tworzenie Instalatora, aby zainstalować wstępnie wymaganego składnika pole wyboru jest zaznaczone.
W Wybierz które warunków wstępnych, aby zainstalować listy, zaznacz pola wyboru dla Instalator Windows 4.5 i odpowiedniego pakietu programu .NET Framework.

Na przykład jeśli elementy docelowe rozwiązania Program .NET Framework 4.5, zaznacz pola wyboru dla Instalator Windows 4.5 i programu Microsoft .NET Framework 4.5 pełnej.
Jeśli rozwiązanie jest przeznaczony dla platformy .NET Framework 4.5, jest wybierany również programu Visual Studio 2010 Tools dla pakietu Office w czasie wykonywania pole wyboru.

[!UWAGA]

Domyślnie to pole wyboru nie jest wyświetlane.Aby było widoczne, należy utworzyć pakiet programu inicjującego.Zobacz tworzenia pakietu program inicjujący dla pakietu Office 2013 VSTO dodatek programu Visual Studio 2012.

W obszarze określić lokalizację instalacji wymagań wstępnych, wybierz jedną z opcji, które są widoczne, a następnie wybierz OK przycisku.

W tabeli poniżej opisano wszystkie opcje.

Opcja	Opis
Pobierz wymagań wstępnych z witryny sieci web dostawcy składnika	Użytkownik jest monitowany, aby pobrać i zainstalować następujące składniki wymagane wstępnie od dostawcy.
Pobierz wstępnie wymagane składniki z tej samej lokalizacji co aplikację	Wstępnie wymagane oprogramowanie jest instalowane razem z oprogramowaniem.W przypadku zaznaczenia tej opcji program Visual Studio automatycznie kopiuje wszystkie wstępnie wymagane pakiety do lokalizacji publikowania.Aby opcja działała, składniki muszą się znajdować na komputerze deweloperskim.
Pobierz wstępnie wymagane składniki z następującej lokalizacji	Program Visual Studio kopiuje wszystkie pakiety wstępnie do określonej lokalizacji i instaluje je z rozwiązaniem.

Zobacz Wstępnie wymagane składniki — Okno dialogowe.

Wybierz aktualizacje przycisk, określić, jak często każdego użytkownika końcowego dodatku lub dostosowanie do sprawdzania dostępności aktualizacji, a następnie wybierz OK przycisku.

[!UWAGA]

Jeśli jest wdrażany za pomocą dysku CD lub dysk wymienny, wybierz nigdy nie sprawdzaj aktualizacje przycisk opcji.

Aby uzyskać informacje dotyczące publikowania aktualizacji, zobacz opublikować aktualizację.
Wybierz Opcje przycisk, przejrzyj opcje w Opcje okna dialogowego pole, a następnie wybierz OK przycisku.
Wybierz publikowania teraz przycisku.

Program Visual Studio dodaje następujące foldery i pliki do publikacji folderu, który określono wcześniej w tej procedurze.
- Plików aplikacji folder.
- Program instalacyjny.
- Manifest wdrażania odwołujący się do manifestu wdrażania najnowszej wersji.
Plików aplikacji folder zawiera podfolder dla każdej wersji, który publikowania.Każdy podfolder danej wersji zawiera następujące pliki.
- Manifest aplikacji.
- Manifest wdrażania.
- Zestawy dostosowywania.
Na poniższej ilustracji widać strukturę folderu publikowania dla dodatku programu Outlook.

[!UWAGA]

Funkcja ClickOnce dołącza do zestawów rozszerzenie .deploy, tak aby bezpieczna instalacja programu Internet Information Services (IIS) nie blokowała plików z powodu ich niebezpiecznego rozszerzenia.Po zainstalowaniu rozwiązania rozszerzenie jest automatycznie usuwane.
Skopiuj pliki rozwiązania do lokalizacji instalacji, który określono wcześniej w tej procedurze.

Decyzja w sprawie sposobu udzielenia zaufania rozwiązaniu

Zanim rozwiązanie będzie można uruchomić na komputerach użytkowników, administrator musi udzielić zaufania albo użytkownicy muszą odpowiedzieć na monit o udzielenie zaufania podczas instalacjo rozwiązania.Aby administrator przyznał zaufanie rozwiązaniu, musi podpisać manifest za pomocą certyfikatu identyfikującego znanego i zaufanego wydawcę.Zobacz ufania rozwiązanie podpisywania aplikacji i wdrażania manifesty.

Jeśli jest instalowane dostosowanie na poziomie dokumentu i dokument ma zostać umieszczony w folderze na komputerze użytkownika lub udostępniony w witrynie programu SharePoint, należy się upewnić, że pakiet Office ufa lokalizacji dokumentu.Zobacz Udzielanie zaufania do dokumentów.

Pomaganie użytkownikom w instalowaniu rozwiązania

Użytkownicy mogą zainstalować rozwiązanie przez uruchomienie programu instalacyjnego, otwarcie manifestu wdrażania lub — w przypadku dostosowania na poziomie dokumentu — bezpośrednie otwarcie dokumentu.Według najlepszych praktyk rozwiązanie należy instalować przy użyciu programu instalacyjnego.Pozostałe dwie metody nie gwarantują instalacji wstępnie wymaganego oprogramowania.Jeśli użytkownicy chcą otwierać dokument z lokalizacji instalacji, muszą ją dodać do listy zaufanych lokalizacji w Centrum zaufania w aplikacji pakietu Office.

Otwieranie dokumentu z dostosowaniem na poziomie dokumentu

Użytkownicy mogą otwierać dokumentu, dostosowywania dokumentu na poziomie bezpośrednio z lokalizacji instalacji lub kopiowanie dokumentu do komputera lokalnego, a następnie otworzyć.

Według najlepszych praktyk należy otwierać kopię dokumentu na swoim komputerze, tak aby wiele osób nie próbowało otworzyć jednocześnie tego samego wystąpienia.W celu wymuszenia tej praktyki można tak skonfigurować program instalacyjny, aby kopiował dokument na komputery użytkowników.Zobacz Put dokumentu na komputerze użytkownika końcowego (tylko w przypadku dostosowania poziomie dokumentu).

Instalowanie rozwiązania przez otwarcie manifestu wdrażania z witryny internetowej usług IIS

Użytkownicy mogą zainstalować rozwiązanie dla pakietu Office poprzez otwarcie manifestu wdrażania z Internetu.Jednak bezpieczna instalacja programu Internet Information Services (IIS) blokuje pliki z rozszerzeniami .vsto.Zanim będzie można wdrożyć rozwiązanie za pomocą usług IIS, w usługach musi być zdefiniowany typ MIME.

Aby dodać typ MIME .vsto do usług IIS 6.0

Na serwerze z programem IIS 6.0, wybierz Start, Wszystkie programy, Narzędzia administracyjne, internetowych usług informacyjnych (IIS) Manager.
Wybierz nazwę komputera, witryn sieci Web folder lub konfiguracji witryny sieci web.
Na pasku menu wybierz polecenie akcji, właściwości.
Na nagłówków HTTP kartę, wybierz typy MIME przycisku.
W typy MIME okna, wybierz polecenie Nowy przycisku.
W Typ MIME oknie wprowadź .vsto jako numer wewnętrzny, wprowadź application/x-ms-vsto jako MIME wpisz, a następnie zastosować nowe ustawienia.

[!UWAGA]

Aby zmiany zaczęły obowiązywać, należy ponownie uruchomić usługę publikowania w sieci World Wide Web lub poczekać na wykonanie cyklu odświeżania w procesie roboczym.Należy następnie opróżnić pamięć podręczną dysku w przeglądarce i spróbować ponownie otworzyć plik .vsto.

Aby dodać typ MIME .vsto do usług IIS 7.0

Na serwerze z programem IIS 7.0, wybierz Start, Wszystkie programy, Akcesoria.
Otwórz menu skrótów wiersza polecenia, a następnie wybierz Uruchom jako administrator.
W Otwórz wprowadź następującą ścieżkę, a następnie wybierz OK przycisku.
```
%windir%\system32\inetsrv 
```
Wprowadź następujące polecenie, a następnie zastosuj nowe ustawienia.
```
set config /section:staticContent /+[fileExtension='.vsto',mimeType='application/x-ms-vsto']
```
[!UWAGA]

Aby zmiany zaczęły obowiązywać, należy ponownie uruchomić usługę publikowania w sieci World Wide Web lub poczekać na wykonanie cyklu odświeżania w procesie roboczym.Należy następnie opróżnić pamięć podręczną dysku w przeglądarce i spróbować ponownie otworzyć plik .vsto.

Umieszczanie dokumentu rozwiązania na komputerze użytkownika końcowego (tylko dostosowania na poziomie dokumentu)

Dokument z rozwiązania może być kopiowany do komputera użytkownika końcowego automatycznie dzięki specjalnie utworzonej akcji powdrożeniowej.W ten sposób użytkownik nie musi ręcznie kopiować dokumentu z lokalizacji instalacji do swojego komputera po zainstalowaniu rozwiązania.Administrator musi utworzyć klasę definiującą akcję powdrożeniową, skompilować i opublikować rozwiązanie, zmodyfikować manifest aplikacji, a następnie ponownie podpisać manifesty aplikacji i wdrażania.

W poniższych procedurach założono, że nazwa projektu jest ExcelWorkbook i opublikowanie rozwiązanie, aby C:\publish katalogu na tym komputerze.

Tworzenie klasy definiującej akcję powdrożeniową

Na pasku menu, kliknij Plik, Dodaj, Nowy projekt.
W Dodaj nowy projekt dialogowym zainstalowane szablony okienku wybierz Windows folder.
W Szablony okienku wybierz biblioteki klas szablonu.
W Nazwa wprowadź FileCopyPDA, a następnie wybierz OK przycisku.
W Eksploratora rozwiązań, wybierz polecenie FileCopyPDA projektu.
Na pasku menu, kliknij Projekt, Dodaj odwołanie.
Na .NET kartę, należy dodać odniesienia do Microsoft.VisualStudio.Tools.Applications.Runtime i Microsoft.VisualStudio.Tools.Applications.ServerDocument.

Zmień nazwę klasy do FileCopyPDA, a następnie zastąp zawartość pliku z kodem.Kod będzie wykonywał następujące zadania:

Kopiowanie dokumentu do komputera użytkownika.
Zmiany _AssemblyLocation Właściwość ze ścieżką względną do w pełni kwalifikowanej ścieżki dla manifestu wdrażania.
Usunięcie pliku, jeśli użytkownik odinstaluje rozwiązanie.

Imports Microsoft.VisualStudio.Tools.Applications.Deployment
Imports Microsoft.VisualStudio.Tools.Applications

Public Class FileCopyPDA
    Implements IAddInPostDeploymentAction

    Sub Execute(ByVal args As AddInPostDeploymentActionArgs) Implements IAddInPostDeploymentAction.Execute
        Dim dataDirectory As String = "Data\ExcelWorkbook.xlsx" 
        Dim file As String = "ExcelWorkbook.xlsx" 
        Dim sourcePath As String = args.AddInPath
        Dim deploymentManifestUri As Uri = args.ManifestLocation
        Dim destPath As String = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory)
        Dim sourceFile As String = System.IO.Path.Combine(sourcePath, dataDirectory)
        Dim destFile As String = System.IO.Path.Combine(destPath, file)

        Select Case args.InstallationStatus
            Case AddInInstallationStatus.InitialInstall, AddInInstallationStatus.Update
                System.IO.File.Copy(sourceFile, destFile)
                ServerDocument.RemoveCustomization(destFile)
                ServerDocument.AddCustomization(destFile, deploymentManifestUri)
                Exit Select 
            Case AddInInstallationStatus.Uninstall
                If System.IO.File.Exists(destFile) Then
                    System.IO.File.Delete(destFile)
                End If 
                Exit Select 
        End Select 
    End Sub

using Microsoft.VisualStudio.Tools.Applications.Deployment;
using Microsoft.VisualStudio.Tools.Applications;
using System.IO;

namespace FileCopyPDA
{
    public class FileCopyPDA : IAddInPostDeploymentAction
    {
        public void Execute(AddInPostDeploymentActionArgs args) 
        {
            string dataDirectory = @"Data\ExcelWorkbook.xlsx";
            string file = @"ExcelWorkbook.xlsx";
            string sourcePath = args.AddInPath;
            Uri deploymentManifestUri = args.ManifestLocation;
            string destPath = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory);
            string sourceFile = System.IO.Path.Combine(sourcePath, dataDirectory);
            string destFile = System.IO.Path.Combine(destPath, file);

            switch (args.InstallationStatus)
            {
                case AddInInstallationStatus.InitialInstall:
                case AddInInstallationStatus.Update:
                    File.Copy(sourceFile, destFile);
                    ServerDocument.RemoveCustomization(destFile);
                    ServerDocument.AddCustomization(destFile, deploymentManifestUri);
                    break;
                case AddInInstallationStatus.Uninstall:
                    if (File.Exists(destFile))
                    {
                        File.Delete(destFile);
                    }
                    break;
            }
        }

Kompilowanie i publikowanie rozwiązania

W Eksploratora rozwiązań, otwórz menu skrótów FileCopyPDA projektu, a następnie wybierz Tworzenie.
Otwórz menu skrótów ExcelWorkbook projektu, a następnie wybierz Tworzenie.
Otwórz menu skrótów ExcelWorkbook projektu, a następnie wybierz Dodaj odwołanie.
W Dodaj odwołanie okna dialogowego opcję projektów kartę, wybierz FileCopyPDA, a następnie wybierz OK przycisk.
W Eksploratora rozwiązań, wybierz polecenie ExcelWorkbook projektu.
Na pasku menu, wybierz polecenie projektu, Nowy Folder.
Wypełnij pole Dane i naciśnij klawisz Enter.
W Eksploratora rozwiązań, wybierz polecenie danych folder.
Na pasku menu wybierz polecenie projektu, Dodaj istniejący element.
W Dodaj istniejący element okno dialogowe, przejdź do katalogu wyjściowego dla ExcelWorkbook projektu, wybierz polecenie ExcelWorkbook.xlsx pliku, a następnie wybierz Dodaj przycisku.
W Eksploratora rozwiązań wybierz ExcelWorkbook.xlsx pliku.
W właściwości okna, zmiany Tworzenie akcji właściwość do zawartości i Kopiuj do katalogu wyjściowego właściwości skopiować nowszej.

Po wykonaniu tych czynności projekt będzie przypominał poniższą ilustrację.
Publikowanie ExcelWorkbook projektu.

Modyfikowanie manifestu aplikacji

Otwórz c:\publish katalogu przy użyciu Explorer pliku.
Otwórz plików aplikacji folderu, a następnie otwórz folder odpowiadający do najnowszej wersji rozwiązania opublikowane.
Otwórz ExcelWorkbook.dll.manifest plik w edytorze tekstu, np.

Po </vstav3:update> elementu, dodać następujące kodu.Dla atrybutu klasy <vstav3:entryPoint> element, należy użyć następującej składni: NamespaceName.ClassName.W poniższym przykładzie nazwy obszaru nazw i klasy są takie same, dzięki czemu można wynikowe Nazwa punktu wejścia FileCopyPDA.FileCopyPDA.

<vstav3:postActions>
  <vstav3:postAction>
    <vstav3:entryPoint
      class="FileCopyPDA.FileCopyPDA">
      <assemblyIdentity
        name="FileCopyPDA"
        version="1.0.0.0"
        language="neutral"
        processorArchitecture="msil" />
    </vstav3:entryPoint>
    <vstav3:postActionData>
    </vstav3:postActionData>
  </vstav3:postAction>
</vstav3:postActions>

Ponowne podpisywanie manifestów aplikacji i wdrażania

W %USERPROFILE%\Documents\Visual Studio 2013\Projects\ExcelWorkbook\ExcelWorkbook folderu, kopiowania ExcelWorkbook_TemporaryKey.pfx plik certyfikatu, a następnie wklej go do PublishFolder \Application Files\ExcelWorkbookMostRecentPublishedVersion folder.
Otwórz wiersz polecenia programu Visual Studio, a następnie zmień katalogi w celu c:\publish\Application Files\ExcelWorkbookMostRecentPublishedVersion folder (na przykład c:\publish\Application Files\ExcelWorkbook_1_0_0_4).
Podpisz zmodyfikowany manifest aplikacji, wykonując następujące polecenie:
```
mage -sign ExcelWorkbook.dll.manifest -certfile ExcelWorkbook_TemporaryKey.pfx
```
Zostanie wyświetlony komunikat „Plik ExcelWorkbook.dll.manifest został pomyślnie podpisany”.
Zmień na c:\publish folderu, następnie aktualizacji i logowania wdrożenia manifestu, należy uruchomić następujące polecenie:
```
mage -update ExcelWorkbook.vsto -appmanifest "Application Files\Ex
celWorkbookMostRecentVersionNumber>\ExcelWorkbook.dll.manifest" -certfile "Application Files\ExcelWorkbookMostRecentVersionNumber>\ExcelWorkbook_TemporaryKey.pfx"
```
[!UWAGA]

W poprzednim przykładzie, Zastąp MostRecentVersionNumber numer wersji wcześniej opublikowanej wersji rozwiązania (na przykład 1_0_0_4).

Zostanie wyświetlony komunikat „Plik ExcelWorkbook.dll.vsto został pomyślnie podpisany”.
Skopiuj plik ExcelWorkbook.vsto do c:\publish\Application Files\ExcelWorkbookMostRecentVersionNumber katalogu.

Umieszczanie dokumentu rozwiązania na serwerze z programem SharePoint (tylko dostosowania na poziomie dokumentu)

Dostosowanie na poziomie dokumentu można opublikować użytkownikom końcowym za pomocą programu SharePoint.Gdy użytkownicy przejdą do witryny programu SharePoint i otworzą dokument, środowisko uruchomieniowe automatycznie zainstaluje rozwiązanie z udostępnionego folderu sieciowego na komputerze lokalnym.Po lokalnym zainstalowaniu rozwiązania dostosowanie nadal będzie działać, nawet, jeśli dokument skopiowano w inne miejsce, na przykład na pulpit.

Aby umieścić dokument na serwerze z programem SharePoint

Dodaj dokument z rozwiązania do biblioteki dokumentów w witrynie programu SharePoint.
Wykonaj czynności dla jednej z poniższych metod:
- Za pomocą narzędzia konfiguracji pakietu Office dodaj serwer z programem do Centrum zaufania w programie Word lub Excel na komputerach wszystkich użytkowników.
  
  Zobacz Zasady zabezpieczeń i ustawienia w pakiecie Office 2010.
- Upewnij się, że każdy użytkownik wykona następujące czynności.
  1. Na komputerze lokalnym, otwórz Word czy Excel, wybierz pliku kartę, a następnie wybierz Opcje przycisku.
  2. W Centrum zaufania okna dialogowego opcję zaufanych lokalizacji przycisku.
  3. Wybierz Zezwalaj na zaufane lokalizacje w mojej sieci (niezalecane) pole wyboru, a następnie wybierz Dodaj nową lokalizację przycisku.
  4. W ścieżki wprowadź adres URL biblioteki dokumentów programu SharePoint zawiera dokument, który można przekazać (na przykład http://SharePointServerName/TeamName/ProjectName/DocumentLibraryName).
    
    Nie dodawaj nazwy domyślnej strony internetowej, np. default.aspx czy AllItems.aspx.
  5. Wybierz podfoldery tej lokalizacji są także zaufane pole wyboru, a następnie wybierz OK przycisku.
    
    Gdy użytkownicy otwierają dokument z poziomu witryny programu SharePoint, następuje otwarcie dokumentu i zainstalowanie dostosowania.Użytkownicy mogą wtedy skopiować dokument na swoje komputery.Dostosowanie będzie nadal działać, ponieważ właściwości w dokumencie wskazują jego lokalizację sieciową.

Tworzenie niestandardowego instalatora

Dla rozwiązania pakietu Office można utworzyć niestandardowego instalatora, który zastąpi program instalacyjny tworzony automatycznie podczas publikowania rozwiązania.W niestandardowym instalatorze instalacja może być inicjowana przez skrypt logowania albo plik wsadowy może instalować rozwiązanie bez udziału użytkownika.Scenariusze te działają najlepiej, jeśli na komputerach użytkowników końcowych są już zainstalowane wstępnie wymagane składniki.

W ramach procesu instalacji niestandardowej należy wywołać to narzędzie Instalatora dla rozwiązań dla pakietu Office (VSTOInstaller.exe), które jest domyślnie instalowana w następującej lokalizacji:

%commonprogramfiles%\microsoft shared\VSTO\10.0\VSTOInstaller.exe

Jeśli narzędzia nie ma w tym folderze, poszukaj go w kluczu rejestru HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath or HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath.

Narzędzie VSTOinstaller.exe współpracuje z parametrami wymienionymi poniżej.

Parametr	Definicja
/Install lub /I	Instalowanie rozwiązania.Po tej opcji należy podać ścieżkę manifestu wdrażania.Można określić ścieżkę na komputerze lokalnym, universal naming konwencji UNC udziału plików.Można określić ścieżkę lokalną (C:\FolderName\PublishFolder), ścieżką względną (Publish\), lub w pełni kwalifikowana lokalizacji (\\ServerName\FolderName lub http://nazwa_serwera/nazwa folderu).
/Uninstall lub /U	Odinstalowywanie rozwiązania.Po tej opcji należy podać ścieżkę manifestu wdrażania.Można określić ścieżkę mogą być na komputerze lokalnym, udział pliku UNC.Można określić ścieżkę lokalną (c:\FolderName\PublishFolder), ścieżką względną (Publish\), lub w pełni kwalifikowana lokalizacji (\\ServerName\FolderName lub http://nazwa_serwera/nazwa folderu).
/Silent lub /S	Instalowanie lub odinstalowywanie bez monitowania użytkownika o wprowadzenie danych ani wyświetlania jakichkolwiek komunikatów.Jeśli jest potrzebny monit o udzielenie zaufania, dostosowanie nie jest instalowane ani aktualizowane.
/Help lub /?	Wyświetlanie informacji Pomocy.

W trakcie pracy narzędzia VSTOinstaller.exe mogą być wyświetlane różne kody błędów.

Kod błędu	Definicja
0	Rozwiązanie zostało pomyślnie zainstalowane lub odinstalowane albo została wyświetlona Pomoc narzędzia VSTOInstaller.
-100	Co najmniej jedna opcja wiersza polecenia jest nieprawidłowa lub została użyta więcej niż raz.Aby uzyskać więcej informacji, wprowadź "Instalator vstoinstaller /?" lub zobacz Tworzenie instalatora niestandardowego rozwiązania ClickOnce pakietu Office..
-101	Co najmniej jedna opcja wiersza polecenia jest nieprawidłowa.Aby uzyskać więcej informacji, wpisz „vstoinstaller /?”.
-200	Identyfikator URI manifestu wdrażania jest nieprawidłowy.Aby uzyskać więcej informacji, wpisz „vstoinstaller /?”.
-201	Nie można zainstalować rozwiązania, ponieważ manifest wdrażania jest nieprawidłowy.Zobacz Manifesty wdrożenia dla rozwiązań Office.
-202	Nie można zainstalować rozwiązania, ponieważ sekcja programu Visual Studio Tools for Office w manifeście aplikacji jest nieprawidłowa.Zobacz Manifesty aplikacji dla rozwiązań Office.
-203	Nie można zainstalować rozwiązania, ponieważ wystąpił błąd pobierania.Sprawdź identyfikator URI lub lokalizację pliku sieciowego manifestu wdrażania, a następnie ponów próbę.
-300	Nie można zainstalować rozwiązania, ponieważ wystąpił wyjątek zabezpieczeń.Zobacz Zabezpieczanie rozwiązań pakietu Office.
-400	Nie można zainstalować rozwiązania.
-401	Nie można odinstalować rozwiązania.
-500	Operacja została anulowana, ponieważ nie można zainstalować lub odinstalować rozwiązania albo nie można pobrać manifestu wdrażania.

Publikowanie aktualizacji

Aby zaktualizować rozwiązanie, przed opublikowaniem ponownie przy użyciu Designer projektu lub Kreatora publikowania, a następnie skopiuj zaktualizowane rozwiązanie do lokalizacji instalacji.Podczas kopiowania plików do lokalizacji instalacji trzeba koniecznie zaznaczyć opcję zastąpienia poprzednich plików.

Gdy następnym razem rozwiązanie będzie sprawdzać dostępność aktualizacji, znajdzie i automatycznie zainstaluje nową wersję.

Zmiana lokalizacji instalacji rozwiązania

Po opublikowaniu rozwiązania można dodać lub zmienić ścieżkę instalacji.Często powody takiej zmiany są następujące:

Program instalacyjny został skompilowany przed ustaleniem ścieżki instalacji.
Pliki rozwiązania skopiowano do innej lokalizacji.
Serwer, na którym znajdują się pliki instalacyjne, ma nową nazwę lub lokalizację.

Aby zmienić ścieżkę instalacji rozwiązania, należy zaktualizować program instalacyjny, po czym użytkownicy muszą go uruchomić.W przypadku dostosowań na poziomie dokumentu użytkownicy muszą również w swoich dokumentach tak zaktualizować odnośną właściwość, aby wskazywała nową lokalizację.

[!UWAGA]

Jeśli z jakichś względów lepiej, aby użytkownicy sami nie aktualizowali właściwości dokumentów, można im polecić pobranie zaktualizowanego dokumentu z lokalizacji instalacji.

Aby zmienić ścieżkę instalacji w programie instalacyjnym

Otwórz wiersza polecenia okna, a następnie zmień katalogi do folderu instalacji.
Uruchomienie programu instalacyjnego i uwzględniają /url parametr, który ma nową ścieżkę instalacji jako ciąg.

Poniższy przykład pokazuje, jak zmienić ścieżkę instalacji na lokalizację w witrynie internetowej firmy Fabrikam; widoczny adres URL można zastąpić dowolną inną ścieżką:
```
setup.exe /url="http://www.fabrikam.com/newlocation"
```
[!UWAGA]

Jeśli pojawi się komunikat z informacją, że podpis pliku wykonywalnego zostanie unieważniony, certyfikat użyty do podpisania rozwiązania jest nieważny, a wydawca nieznany.W rezultacie przed zainstalowaniem rozwiązania użytkownicy będą musieli potwierdzić, że ufają jego źródłu.

[!UWAGA]

Aby wyświetlić bieżącą wartość adresu URL, należy uruchomić setup.exe /url.

Dla dostosowania poziomu dokumentu użytkowników musi Otwórz dokument, a następnie zaktualizować jego _AssemblyLocation Właściwości.Poniżej zamieszczono odpowiednią procedurę.

Aby zaktualizować właściwość _AssemblyLocation w dokumencie

Na pliku kartę, wybierz informacje o, który na poniższej ilustracji pokazano.
W właściwości wybierz Zaawansowane właściwości, który na poniższej ilustracji pokazano.
Na niestandardowy kartę w właściwości wybierz _AssemblyLocation, jak pokazano na poniższej ilustracji.

Wartość pole zawiera identyfikator manifestu wdrażania.
Przed identyfikator, wprowadź w pełni kwalifikowana ścieżka dokumentu, a następnie paska w formacie ścieżki |Identyfikatora (na przykład File://ServerName/FolderName/FileName |74744e4b-e4d6-41eb-84f7-ad20346fe2d9.

Aby uzyskać więcej informacji na temat formatowania tego identyfikatora, zobacz Niestandardowe właściwości dokumentu ― Omówienie.
Wybierz OK przycisk, a następnie zapisz i zamknij dokument.
Uruchom program instalacyjny bez parametru /url. Rozwiązanie zostanie zainstalowane w podanej lokalizacji.

Wycofywanie rozwiązania do wcześniejszej wersji

Podczas przywracania rozwiązanie przywróceniu użytkowników z powrotem do starszej wersji tego rozwiązania.

Aby wycofać rozwiązanie

Otwórz lokalizację instalacji rozwiązania.
W folderze publikowania na najwyższym poziomie usuń manifest wdrażania (plik .vsto).
Znajdź podfolder wersji, do której chcesz wycofać rozwiązanie.
Skopiuj manifest wdrażania z tego podfolderu do folderu publikowania najwyższego poziomu.

Na przykład można wycofać rozwiązanie, które jest wywoływane w OutlookAddIn1 z wersji 1.0.0.1 do wersji 1.0.0.0, skopiuj plik OutlookAddIn1.vsto z OutlookAddIn1_1_0_0_0 folder.Wklej pliku na najwyższym poziomie publikowanie folderu, zastępując manifestu wdrażania określonej wersji dla OutlookAddIn1_1_0_0_1 który został w już.

Na ilustracji poniżej widać strukturę folderu publikowania w opisywanym przykładzie.

Gdy użytkownik następnym razem otworzy aplikację lub dostosowany dokument, zostanie wykryta zmiana manifestu wdrażania.Starsza wersja rozwiązania dla pakietu Office jest uruchamiana z pamięci podręcznej funkcji ClickOnce.

[!UWAGA]

Dane lokalne są zapisywane tylko dla jednej poprzedniej wersji rozwiązania.W przypadku wycofania o dwie wersje lokalne dane nie zostaną zachowane.Aby uzyskać więcej informacji na temat danych lokalnych zobacz Uzyskiwanie dostępu do danych lokalnych i zdalnych w aplikacjach ClickOnce.