Názorný postup: Kopírování dokumentu do počítače koncového uživatele po instalaci technologie ClickOnce

Článek
11/16/2012

Pomocí post-deployment akce ClickOnce, můžete nainstalovat řešení Office úrovni dokumentu a potom dokument zkopírovat do počítače koncového uživatele. To vyžaduje změnit manifest aplikace a znovu podepisovat aplikace a manifestů nasazení před instalací.

Platí pro: 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 Funkce aplikace Office a typ projektu.

Tento návod ilustruje následující úkoly:

Vytváření Office řešení nasazení.
Provádění post-deployment akce, která zkopíruje dokument do počítače koncového uživatele.
Úpravy manifestu aplikace Office roztoku post-deployment akci.
Opětovné podepsání aplikace a nasazení manifesty.

Poznámka

Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. Tyto prvky jsou určeny verzí aplikace Visual Studio a použitým nastavením. Další informace naleznete v tématu Nastavení aplikace Visual Studio.

Požadavky

Chcete-li dokončit tento návod, potřebujete následující komponenty:

Edice sady Visual Studio 2012, která zahrnuje nástroje Microsoft Office Developer Tools. Další informace naleznete v tématu [Konfigurace počítače vyvinout řešení Office](https://msdn.microsoft.com/cs-cz/library/bb398242\(v=vs.110\)).

Excel 2013 Preview nebo Excel 2010.
Testovací počítač.

Vytvoření nového projektu

Nejprve vytvořte projekt sešitu aplikace Excel.

Vytvoření nového projektu v aplikaci Excel

Vytvořte projekt úroveň dokumentu aplikace Excel. Název projektu ExcelWorkbooka uložit projekt %USERPROFILE%\Documents\Visual Studio 2012\Projects adresáře. Další informace naleznete v tématu Jak: vytvoření Office projekty v aplikaci Visual Studio.

Visual Studio otevře nový sešit aplikace Excel v návrháři a přidá ExcelWorkbook projektu řešeníExplorer.

Vytváření projektu knihovny tříd, který definuje Post-Deployment akce

Post-deployment akce je nutné definovat samostatné třídy knihovny. Post-deployment akce provede kopie dokumentu v počítači koncového uživatele.

Vytvořit knihovnu tříd pro akci post-deployment

V soubor příkaz Přidata klepněte na tlačítko Nový projekt.
V Přidat nový projekt v dialogovém okně pole Nainstalované šablony podokno, klepněte na Windows.
V šablony podokno, klepněte na třídyknihovny.
V název pole, zadejte FileCopyPDAa klepněte na tlačítko OK.
V Průzkumníku, klepněte na FileCopyPDA.
Na projektu nabídky, klepněte na Přidatodkaz.

Přidat odkaz na se zobrazí dialogové okno.
Na .NET karta, přidat odkazy na Microsoft.VisualStudio.Tools.Applications.Runtime a Microsoft.VisualStudio.Tools.Applications.ServerDocument.

Soubor kódu Class1 přidejte následující pomocí nebo dovozy příkazů na začátek souboru kódu.

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;

Přejmenování třídy FileCopyPDAa pak přidejte následující kód FileCopyPDA třídy. Tento kód označuje, že FileCopyPDA třída dědí z IAddInPostDeploymentAction.
```
Public Class FileCopyPDA
    Implements IAddInPostDeploymentAction
```
```
public class FileCopyPDA : IAddInPostDeploymentAction
```

Přidejte následující kód k provedení IAddInPostDeploymentAction.Execute metoda. Tento kód provede následující úlohy:

Řešení je nainstalovány nebo aktualizovány zkopíruje soubor sešitu aplikace Excel na ploše uživatele.
Změny _AssemblyLocation vlastnost relativní cestu úplnou cestu k manifestu nasazení. To se provádí pomocí AddCustomization a RemoveCustomization metod.
Pokud odinstalovat řešení odstraní soubor.

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

Vytváření a publikování řešení

Použití Průvodce Publikovat nebo Stránky projektu pro vytváření a publikování řešení Office na vývojovém počítači.

Publikování projektu aplikace Excel

V řešeníExplorer, klepněte pravým tlačítkem myši FileCopyPDA projektu a potom klepněte na tlačítko sestavení.
V řešeníExplorer, klepněte pravým tlačítkem myši ExcelWorkbook projektu a potom klepněte na tlačítko sestavení.
V řešeníExplorer, klepněte pravým tlačítkem myši ExcelWorkbook projektu a potom klepněte na tlačítko Přidat odkaz.
V Přidat odkaz dialogové okno, klepněte projekty kartu.
Klepněte na FileCopyPDAa na OK.
V Průzkumníku, klepněte ExcelWorkbook projektu.
V nabídce Projekt klepněte na Nová složka.
Typ dat a stiskněte klávesu Enter klíč.
V Průzkumníku, klepněte dat složky.
V nabídce Projekt klepněte na Přidat existující položku.
V Přidat existující položku dialogové okno, vyhledejte výstupní adresář ExcelWorkbook projektu.
Klepněte na ExcelWorkbook.xlsxa na Přidat.
V řešeníExplorer, klepněte na ExcelWorkbook.xlsx.

Poznámka

Pokud později upravit soubor zkontrolujte aktualizace souboru přidáním nejnovější verzi souboru.
V Vlastnosti okno Změnit Akce sestavení vlastnost obsahua Kopírovat do výstupního adresáře vlastnost kopie-li novější.
Publikovat ExcelWorkbook projektu c:\publish složky. Další informace naleznete v tématu Jak: publikování pomocí technologie ClickOnce Office Solution.

Manifest aplikace pro úpravy

Změnit manifest aplikace post-deployment akci kopírování souborů pomocí editoru XML v aplikaci Visual Studio. Obsah manifestu aplikace je podobný kusovník, který obsahuje celý obsah pole. manifest aplikace obsahuje všechny požadované a závislé sestavení. Manifest aplikace pro řešení Office obsahuje také seznam sestavení, která by měla být načtena aplikací sady Office pro doplňky aplikace a úpravy na úrovni dokumentu.

Přidání závislostí instalace do manifestu aplikace

Otevřít c:\publish adresáře prostřednictvím Průzkumníka souborů.
Otevřít Soubory aplikace složku a otevřete ExcelWorkbook_1_0_0_0 složky.
Otevřít ExcelWorkbook.dll.manifest soubor v textovém editoru.

Přidejte následující kód po </vstav3:update> prvku. Pro atribut třídy <vstav3:entryPoint> prvku, použijte následující syntaxi: NamespaceName.ClassName. V tomto příkladu jména oboru názvů a třídy jsou stejné, tak, aby výsledný bod název 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>

Opětovné podepsání manifestů

Následující postup podepíše manifest aplikace a manifest nasazení aktualizace. Tím zajistíte, že v počítačích koncových uživatelů nejsou instalovány manipulované soubory.

Chcete-li znovu podepsat manifesty aplikace a nasazení

Kopie ExcelWorkbook_TemporaryKey.pfx soubor certifikátu z %USERPROFILE%\Documents\Visual Studio 2012\Projects\ExcelWorkbook\ExcelWorkbook adresář řešení do c:\publish\Application Files\ExcelWorkbook_1_0_0_0 adresáře.
Otevřete příkazový řádek Visual Studio.
Změnit c:\publish\Application Files\ExcelWorkbook_1_0_0_0 adresáře.
Podepsání manifestu aplikace upravené pomocí následujícího příkazu:
```
mage -sign ExcelWorkbook.dll.manifest -certfile ExcelWorkbook_TemporaryKey.pfx
```
Zobrazí se zpráva "Úspěšně podepsán ExcelWorkbook.dll.manifest".
Změnit c:\publish adresáře.

Aktualizaci a podepsání manifestu nasazení pomocí následujícího příkazu:

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"

Zobrazí se zpráva "Úspěšně podepsán ExcelWorkbook.vsto".

Zkopírujte soubor ExcelWorkbook.vsto c:\publish\Application Files\ExcelWorkbook_1_0_0_0 adresáře.

Testování Post-Deployment akce

Následující postup zajišťuje aktualizovaného manifestu nainstaluje sešit aplikace Excel a sešit zkopíruje do počítače koncového uživatele.

Testování post-deployment akce

Kopie c:\publish do testovacího počítače adresáře.
Spusťte Setup.exe program nebo pokud předpoklady jsou již nainstalovány na počítači, poklepejte ExcelWorkbook.vsto manifest nasazení.

Vlastní instalační Office se zobrazí.
Klikněte na tlačítko Instalovat.

Vlastní instalační Office dialogové okno se zobrazí následující zpráva: "přizpůsobení aplikace Microsoft Office byl úspěšně nainstalován." Sešit aplikace Excel zkopírován do počítače koncového uživatele.
Otevřít ExcelWorkbook.xlsx soubor z plochy.