Instruktaż: Kopiowanie dokumentu do komputera użytkownika końcowego po instalacji ClickOnce

Artykuł
11/16/2012

Za pomocą akcji powdrożeniowe ze strony działu ClickOnce, można zainstalować rozwiązania biurowe poziomie dokumentu i następnie skopiować dokument na komputerze użytkownika końcowego. Wymaga to zmodyfikować manifest aplikacji i ponownie podpisać wniosek i manifestów wdrażania przed instalacją.

Dotyczy: The information in this topic applies to document-level projects and application-level projects for Microsoft Office 2013 Preview and Microsoft Office 2010. For more information, see Funkcje dostępne w aplikacji pakietu Office i typ projektu.

W tym instruktażu przedstawiono następujące zadania:

Tworzenie wdrożyć rozwiązanie pakietu Office.
Wdrażanie działań powdrożeniowe ze strony działu, który kopiuje dokument do pulpitu użytkownika końcowego.
Modyfikowanie manifest aplikacji rozwiązania pakietu Office, aby uruchomić akcję powdrożeniowe ze strony działu.
Objawia się ponownego podpisania aplikacji i wdrażania.

Uwaga

Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. Używana wersja programu Visual Studio oraz jej ustawienia określają te elementy. Aby uzyskać więcej informacji, zobacz Visual Studio, ustawienia.

Warunki wstępne

Potrzebne do przeprowadzenia tego instruktażu następujące składniki:

Wersja Visual Studio 2012 zawierająca narzędzia dla deweloperów pakietu Microsoft Office. Aby uzyskać więcej informacji, zobacz [Konfigurowanie komputera do opracowywania rozwiązań pakietu Office](https://msdn.microsoft.com/pl-pl/library/bb398242\(v=vs.110\)).

Excel 2013 Previewor Excel 2010.
Komputerze testowym.

Tworzenie nowego projektu

Najpierw należy utworzyć projektu skoroszytu programu Excel.

Aby utworzyć nowy projekt programu Excel

Tworzenie projektu poziomie dokumentu programu Excel. Nazwa projektu ExcelWorkbooki zapisać projekt, aby %USERPROFILE%\Documents\Visual Studio 2012\Projects katalogu. Aby uzyskać więcej informacji, zobacz Jak: tworzenie projektów pakietu Office w programie Visual Studio.

Otwiera nowy skoroszyt programu Excel w projektancie programu Visual Studio i dodaje ExcelWorkbook projekt rozwiązanieExplorer.

Tworzenie projektu biblioteki klas, który definiuje działania powdrożeniowe ze strony działu

Działania powdrożeniowe ze strony działu należy zdefiniować w bibliotece osobnej klasy. Działania powdrożeniowe ze strony działu wykonuje kopie dokumentu na komputerze użytkownika końcowego.

Aby utworzyć bibliotekę klas działania powdrożeniowe ze strony działu

W pliku menu, wskaż Dodaj, a następnie kliknij przycisk Nowy projekt.
W Dodać nowy projekt okno dialogowe, w Szablonów okienka, kliknij przycisk Windows.
W Szablony okienka, kliknij przycisk klasybiblioteki.
W Nazwa wpisz FileCopyPDA, a następnie kliknij przycisk OK.
W Solution Explorer, kliknij FileCopyPDA.
Na Projekt menu, kliknij przycisk Dodajodniesienia.

Dodaj odwołanie pojawi się okno dialogowe.
Na .NET kartę, dodać odwołania do Microsoft.VisualStudio.Tools.Applications.Runtime i Microsoft.VisualStudio.Tools.Applications.ServerDocument.

Dodać następujący wpis w pliku kod Class1 za pomocą lub przywóz instrukcji do początku pliku kodu.

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

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

Zmień nazwę klasy do FileCopyPDA, a następnie dodaj następujący kod do FileCopyPDA klasy. Ten kod wskazuje, że FileCopyPDA dziedziczy po klasie IAddInPostDeploymentAction.
```
Public Class FileCopyPDA
    Implements IAddInPostDeploymentAction
```
```
public class FileCopyPDA : IAddInPostDeploymentAction
```

Dodaj następujący kod w celu zaimplementowania IAddInPostDeploymentAction.Execute metoda. Ten kod wykonuje następujące zadania:

Kopiuje plik skoroszytu programu Excel na pulpicie użytkownika, jeśli rozwiązanie jest zainstalowane lub zaktualizowane.
Zmiany _AssemblyLocation właściwość ze ścieżką względną do w pełni kwalifikowaną ścieżkę dla manifestu wdrażania. Odbywa się za pomocą AddCustomization i RemoveCustomization metody.
Usuwa plik, jeśli roztwór jest odinstalowany.

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

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;
    }
}

Tworzenie i publikowanie rozwiązanie

Użycie Kreatora publikowania lub Strony projektu do tworzenia i publikowania rozwiązań pakietu Office na komputerze dewelopera.

Aby opublikować projekt programu Excel

W rozwiązanieExplorer, kliknij prawym przyciskiem myszy FileCopyPDA projektu, a następnie kliknij przycisk budować.
W rozwiązanieExplorer, kliknij prawym przyciskiem myszy ExcelWorkbook projektu, a następnie kliknij przycisk budować.
W rozwiązanieExplorer, kliknij prawym przyciskiem myszy ExcelWorkbook projektu, a następnie kliknij przycisk Dodaj odwołanie.
W Dodaj odwołanie okno dialogowe, kliknij przycisk projektów kartę.
Kliknij przycisk FileCopyPDAi kliknij przycisk OK.
W Solution Explorer, kliknij ExcelWorkbook projektu.
W menu Projekt kliknij przycisk Nowy Folder.
Typ danych i naciśnij klawisz Enter klucz.
W Solution Explorer, kliknij danych folder.
W menu Projekt kliknij przycisk Dodaj istniejący element.
W Dodaj istniejący element okno dialogowe, przejdź do katalogu wyjściowego dla ExcelWorkbook projektu.
Kliknij przycisk ExcelWorkbook.xlsxi kliknij przycisk Dodaj.
W rozwiązanieExplorer, kliknij ExcelWorkbook.xlsx.

Uwaga

Jeśli później modyfikować ten plik, upewnij się, że aktualizacja pliku przez dodanie najnowszą wersję pliku.
W Właściwości okna, zmiana Tworzenie akcji właściwość, aby zawartościi Kopiuj do katalogu wyjściowego właściwość, aby kopięJeśli nowszy.
Publikowanie ExcelWorkbook projekt c:\publish folder. Aby uzyskać więcej informacji, zobacz Jak: publikowanie rozwiązanie Office przy użyciu technologii ClickOnce.

Modyfikowanie Manifest aplikacji

Edytor XML w programie Visual Studio do modyfikowania manifest aplikacji, aby uruchomić akcję powdrożeniowe ze strony działu kopiowania plików. Manifest aplikacji są podobne do BOM, który wymienia całą zawartość pola; manifest aplikacji zawiera listę wszystkich zestawów zależnych i uwzględnione w wymaganiach wstępnych. Manifest aplikacji rozwiązania pakietu Office zawiera również listę zestawów, które powinny być ładowane przez aplikację pakietu Office na poziomie aplikacji dodatków i dostosowań na poziomie dokumentu.

Aby dodać zależności instalacji do manifestu aplikacji

Otwórz c:\publish katalogu za pomocą Eksploratora plików.
Otwórz Plików aplikacji folder, a następnie otwórz ExcelWorkbook_1_0_0_0 folder.
Otwórz ExcelWorkbook.dll.manifest plik w edytorze tekstu.

Dodaj następującą kod po </vstav3:update> element. Dla atrybutu klasy <vstav3:entryPoint> element, należy użyć następującej składni: NamespaceName.ClassName. W tym przykładzie nazwy obszaru nazw i klasy są takie same, tak aby nazwy 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>

Ponownego podpisania manifestów

Poniższa procedura podpisuje manifest aplikacji i aktualizuje manifestu wdrażania. Dzięki temu pliki zmodyfikowanego obrazu nie są zainstalowane na komputerach użytkownika końcowego.

Aby podpisać ponownie manifesty aplikacji i wdrażania

Kopiuj ExcelWorkbook_TemporaryKey.pfx plik certyfikatu z %USERPROFILE%\Documents\Visual Studio 2012\Projects\ExcelWorkbook\ExcelWorkbook katalogu roztwór do c:\publish\Application Files\ExcelWorkbook_1_0_0_0 katalogu.
Otwórz okno wiersza polecenia programu Visual Studio.
Zmienić na c:\publish\Application Files\ExcelWorkbook_1_0_0_0 katalogu.
Podpisz manifest aplikacji zmodyfikowane za pomocą następującego polecenia:
```
mage -sign ExcelWorkbook.dll.manifest -certfile ExcelWorkbook_TemporaryKey.pfx
```
Pojawia się komunikat "Pomyślnie podpisane ExcelWorkbook.dll.manifest".
Zmienić na c:\publish katalogu.

Aktualizacja i podpisania manifestu wdrażania za pomocą następującego polecenia:

mage -update ExcelWorkbook.vsto -appmanifest "Application Files\Ex
celWorkbook_1_0_0_0\ExcelWorkbook.dll.manifest" -certfile "Application Files\ExcelWorkbook_1_0_0_0\ExcelWorkbook_TemporaryKey.pfx"

Pojawia się komunikat "Pomyślnie podpisane ExcelWorkbook.vsto".

Skopiuj plik ExcelWorkbook.vsto do c:\publish\Application Files\ExcelWorkbook_1_0_0_0 katalogu.

Testowanie działania powdrożeniowe ze strony działu

Poniższa procedura zapewnia, że manifest zaktualizowane instaluje skoroszyt programu Excel i kopiuje skoroszytu na pulpicie użytkownika końcowego.

Aby przetestować działanie powdrożeniowe ze strony działu

Kopiuj c:\publish katalogu na komputerze testowym.
Uruchom Setup.exe program lub jeśli wymagania wstępne są już zainstalowane na komputerze, kliknij dwukrotnie ExcelWorkbook.vsto manifest wdrożenia.

Dostosowywania Instalatora systemu Microsoft Office pojawia się.
Kliknij przycisk zainstalować.

Dostosowywania Instalatora systemu Microsoft Office okno dialogowe zawiera następujący komunikat: "Dostosowywanie programu Microsoft Office została zainstalowana pomyślnie." Skoroszyt programu Excel jest kopiowany do komputera użytkownika końcowego.
Otwórz ExcelWorkbook.xlsx plik na pulpicie.

Udostępnij za pośrednictwem