Nasazování rozšíření pro nástroje služby SharePoint v aplikaci Visual Studio

Chcete-li nasadit rozšíření nástrojů SharePoint, vytvořte balíček Visual Studio rozšíření (VSIX), který obsahuje sestavení rozšíření a všechny další soubory, které chcete distribuovat s rozšířením.VSIX balíček je komprimovaný soubor, který následuje standardní OPC (Open Packaging Convention).VSIX balíčky mají příponu .vsix.

Po vytvoření balíčku VSIX mohou ostatní uživatelé spouštět soubor .vsix k instalaci rozšíření.Pokud uživatel nainstaluje vaše rozšíření, všechny soubory jsou nainstalovány do složky %UserProfile%\AppData\Local\Microsoft\VisualStudio\11.0\Extensions.Chcete-li nasadit rozšíření, můžete nahrát balíček VSIX Galerie Visual Studio webu, nebo balíček distribuovat zákazníkům některými jinými prostředky, jako je například na sdílené síťové složky nebo na jiný webový server.

Další informace o vytváření balíčků VSIX a jejich nasazení Galerie Visual Studio, viz Nasazení serveru VSIX.

Můžete vytvořit balíček VSIX pomocí šablony Projektu VSIX v aplikaci Visual Studio nebo můžete vytvořit VSIX balíček ručně.

Použití VSIX projektů k vytvoření balíčků VSIX

Můžete použít Projektu VSIX šablony Visual Studio SDK pro vytvoření balíčků VSIX pro rozšíření nástrojů SharePoint.Během vytváření balíčku VSIX ručně pomocí projektu VSIX poskytuje několik výhod:

• Visual Studio automaticky generuje VSIX balíček, když sestavuje projekt.Úlohy jako například přidávání souborů nasazení balíčku a vytváření souboru [Content_Types].xml pro balíček jsou pro vás hotovy.

• Můžete konfigurovat projekt VSIX pro zahrnutí výstupu sestavení rozšíření projektu a další soubory jako šablony projektů a šablony položek v balíčku VSIX.

Další informace o použití projektu VSIX naleznete v tématu Šablona projektu VSIX.

Uspořádání vašich projektů

Ve výchozím projekty VSIX generují pouze VSIX balíčky sestavení není.Proto je obvykle není implementovat rozšíření nástrojů SharePoint v projektu VSIX.Obecně pracovat alespoň dva projekty:

• Projekt VSIX.

• Projekt knihovny tříd, který implementuje vaše rozšíření.

Můžete také pracovat s další projekty pro určité typy rozšíření:

• Projekt knihovny tříd, který implementuje všechny příkazy služby SharePoint, které používá vaše rozšíření.Návod, který demonstruje tento scénář, viz Názorný postup: Rozšíření serveru Explorer k zobrazení webové části.

• Šablona položky nebo šablonu projektu projekt, který vytvoří šablonu položky projektu nebo šablony projektu, pokud vaše rozšíření definuje nový typ položky projektu služby SharePoint.Návod, který demonstruje tento scénář, viz Názorný postup: Vytváření projektu vlastní akci pomocí položky šablony, část 1.

• Projekt knihovny tříd, který implementuje vlastní průvodce pro šablonu projektu nebo šablony položky, pokud vaše rozšíření obsahuje šablonu.Návod, který demonstruje tento scénář, viz Názorný postup: Vytváření projektu vlastní akci pomocí položky šablony, část 2.

Pokud zahrnete všechny projekty ve stejném řešení sady Visual Studio, můžete upravit soubor source.extension.vsixmanifest v projektu VSIX pro zahrnutí výstupu sestavení projektů knihoven tříd.

Úpravy manifestu souboru VSIX

Musíte upravit soubor source.extension.vsixmanifest v projektu VSIX pro zahrnutí položek pro všechny položky, které chcete zahrnout do rozšíření.Při otevření souboru source.extension.vsixmanifest z místní nabídky se zobrazí v návrháři, který poskytuje uživatelské rozhraní pro úpravy XML v souboru souboru.Další informace naleznete v tématu VSIX manifestu Designer.

Je nutné přidat položky do souboru source.extension.vsixmanifest pro následující položky:

• Sestavení rozšíření.

• Sestavení, které implementuje všechny příkazy služby SharePoint, které používá vaše rozšíření.

• Šablony projektu nebo šablony položky, které jsou přidruženy k rozšíření.

• Vlastní Průvodce šablony, který je přidružen k rozšíření.

Následující postupy popisují, jak přidat soubor .vsixmanifest položky pro každý z těchto položek.

Chcete-li zahrnout rozšíření sestavení

1. V projektu VSIX otevřete místní nabídku pro soubor source.extension.vsixmanifest a zvolte otevřete.

   Soubor se otevře v Návrháři

2. Na majetku kartě Editor, zvolte Nový tlačítko.

   Přidat nový majetek dialogové okno.

3. V typu seznam, zvolte Microsoft.VisualStudio.MefComponent.

4. V zdroje seznamu, proveďte jeden z následujících kroků:

   • Je-li rozšíření sestavení vytvořeno z projektu, který je ve stejném řešení jako projekt VSIX, zvolte projekt v aktuálním řešení.V projektu seznam, zvolte název projektu.

   • Pokud je sestavení rozšíření zahrnuto jako soubor ve vašem projektu, zvolte souboru na filesystem.V cestu seznam, zadejte úplnou cestu k souboru sestavení rozšíření nebo použít Procházet tlačítko vyhledejte a vyberte soubor sestavení.

5. Klikněte na tlačítko OK.

Chcete-li zahrnout sestavení příkazu SharePoint

1. V projektu VSIX otevřete místní nabídku pro soubor source.extension.vsixmanifest a zvolte otevřete tlačítko.

   Soubor se otevře v návrháři.

2. V majetku části editoru, zvolte Nový tlačítko.

   Přidat nový majetek dialogové okno.

3. V typu zadejte SharePoint.Commands.v4.

4. V zdroje seznamu, proveďte jeden z následujících kroků:

   • Je-li příkaz sestavení vytvořen z projektu, který je ve stejném řešení jako projekt VSIX, zvolte projekt v aktuálním řešení.V projektu seznam, zvolte název projektu.

   • Pokud je sestavení příkazu zahrnuto jako soubor ve vašem projektu, zvolte souboru na filesystem.V cestu seznam, zadejte úplnou cestu k souboru sestavení rozšíření nebo použít Procházet tlačítko vyhledejte a vyberte soubor sestavení.

5. Klikněte na tlačítko OK.

Zahrnout šablony vytvoříte

1. V projektu VSIX otevřete místní nabídku pro soubor source.extension.vsixmanifest a zvolte otevřete tlačítko.

   Soubor se otevře v návrháři.

2. V majetku části editoru, zvolte Nový tlačítko.

   Přidat nový majetek dialogové okno.

3. V typu seznam, zvolte Microsoft.VisualStudio.ProjectTemplate nebo Microsoft.VisualStudio.ItemTemplate.

4. V zdroje seznam, zvolte projektu v aktuálním řešení.

5. V projektu seznam, zvolte název projektu a pak zvolte OK tlačítko.

6. V Průzkumníku, otevřete místní nabídku pro šablonu projektu nebo šablonu položky projektu a pak zvolte Uvolnit projekt.

7. Znovu otevřete místní nabídku pro uzel projektu a zvolte UpravitYourTemplateProjectName**.csproj** nebo UpravitYourTemplateProjectName**.vbproj**.

8. Najděte následující prvek VSTemplate v souboru projektu.

   <VSTemplate Include="YourTemplateName.vstemplate">
   

9. Tento prvek nahraďte následujícím XML.

   <VSTemplate Include="YourTemplateName.vstemplate">
     <OutputSubPath>SharePoint\SharePoint14</OutputSubPath>
   </VSTemplate>
   

   OutputSubPath Element určuje další složky v cestě, pod kterým je vytvořena šablona projektu při sestavení projektu.Zde určené složky zajistí, že šablonu položky budou k dispozici pouze v případě, že otevřete zákazníky Přidat nový projekt dialogové okno pole, rozbalte položku SharePoint uzel a pak zvolte 2010 uzlu.

10. Soubor uložte a zavřete.

11. V Průzkumníku, otevřete místní nabídku pro šablonu projektu nebo šablonu položky projektu a zvolte Znovu načíst projekt.

Zahrnout šablony, který vytvoříte ručně

1. V projektu VSIX přidejte novou složku do projektu, která bude obsahovat šablonu.

2. V této nové složce vytvořte následující podsložky a pak přidejte soubor šablony (.zip) do složky Locale ID.

        YourTemplateFolder

             SharePoint

                  [4_3_sharepoint]

                       Locale ID

                            YourTemplateName.zip

   Máte-li například šablonu položky s názvem ContosoCustomAction.zip, která podporuje národní prostředí Angličtina (Spojené státy), úplná cesta může být ItemTemplates\SharePoint\SharePoint14\1033\ContosoCustomAction.zip.

3. V Průzkumníku, zvolte soubor šablony (YourTemplateNameZIP).

4. V okně Vlastnosti nastavte vlastnost Akce Sestavení na hodnotu Content.

5. Otevřete místní nabídku pro soubor source.extension.vsixmanifest a pak zvolte Open.

   Soubor se otevře v návrháři.

6. V majetku části editoru, zvolte Nový tlačítko.

   Přidat nový majetek dialogové okno.

7. V typu seznam, zvolte Microsoft.VisualStudio.ItemTemplate nebo Microsoft.VisualStudio.ProjectTemplate.

8. V zdroje seznam, zvolte souboru na filesystem.

9. V cestu zadejte úplnou cestu k sestavení (například ItemTemplates\SharePoint\SharePoint14\1033\ContosoCustomAction.zip, nebo Procházet tlačítko vyhledejte a zvolte sestavení a potom zvolte OK tlačítko.

Zahrnout Průvodce pro šablonu projektu nebo šablony položky

1. V projektu VSIX otevřete místní nabídku pro soubor source.extension.vsixmanifest a zvolte otevřete.

   Soubor se otevře v návrháři.

2. V majetku části editoru, zvolte Nový tlačítko.

   Přidat nový majetek dialogové okno.

3. V typu seznam, zvolte Microsoft.VisualStudio.Assembly.

4. V zdroje seznamu, proveďte jeden z následujících kroků:

   • Pokud Průvodce sestavení vytvořeno z projektu, který je ve stejném řešení jako projekt VSIX, zvolte projekt v aktuálním řešení.V projektu seznam, zvolte název projektu.

   • Pokud je zahrnuto jako soubor ve vašem projektu na sestavení průvodce, zvolte souboru na filesystem.V cestu pole, zadejte úplnou cestu k souboru sestavení nebo použít Procházet tlačítko vyhledejte a zvolte sestavení.

5. Klikněte na tlačítko OK.

Související návody

V následující tabulce jsou uvedeny návody, které ukazují použití projektu VSIX pro nasazení různých typů rozšíření nástrojů SharePoint.

Typ rozšíření	Související návody
Rozšíření, který obsahuje sestavení rozšíření	Názorný postup: Rozšíření typ položky služby SharePoint projektu Názorný postup: Vytváření rozšíření projektu SharePoint Názorný postup: Volání do modelu objektu klienta SharePoint v serverové rozšíření aplikace Explorer
Rozšíření, které obsahuje příkazy služby SharePoint	Názorný postup: Vytváření vlastní nasazení krok pro projekty SharePoint Názorný postup: Rozšíření serveru Explorer k zobrazení webové části Názorný postup: Vytvoření položky projektu sloupec webu pomocí šablony projektu, část 2
Rozšíření, které obsahuje šablony aplikace Visual Studio	Názorný postup: Vytváření projektu vlastní akci pomocí položky šablony, část 1 Názorný postup: Vytvoření položky projektu sloupec webu pomocí šablony projektu, část 1
Rozšíření, které obsahuje Průvodce šablonou	Názorný postup: Vytváření projektu vlastní akci pomocí položky šablony, část 2 Názorný postup: Vytvoření položky projektu sloupec webu pomocí šablony projektu, část 2

Ruční vytváření balíčků VSIX

Pokud chcete ručně vytvořit balíček VSIX pro rozšíření nástrojů aplikace SharePoint, proveďte následující kroky:

1. Vytvořte soubor extension.vsixmanifest, [Content_Types].xml a soubor balíčku VSIX (.vsix).Další informace naleznete v tématu Anatomie balíček VSIX a Jak: ručně balíček rozšíření (VSIX Deployment).

2. Přidejte vaše sestavení balíčku VSIX.Pokud vaše rozšíření obsahuje příkaz SharePoint, přidejte také sestavení, které implementuje příkaz SharePoint pro VSIX balíček.

3. Upravte soubor extension.vsixmanifest file:

   • Přidat Microsoft.VisualStudio.MefComponent elementu Assets prvek a poté nastavte hodnotu nový prvek relativní cesta sestavení, který implementuje vaše rozšíření v balíčku VSIX.Další informace naleznete v tématu MefComponent Element.

   • Pokud vaše rozšíření obsahuje příkaz SharePoint, který volá do modelu objektu serveru SharePoint, přidejte Microsoft.VisualStudio.Assembly elementu Assets prvku.Nastavte hodnotu nového prvku relativní cesta sestavení, které implementuje příkaz SharePoint v balíčku VSIX.Další informace naleznete v tématu Prvek majetku (VSX schéma).

   • Pokud vaše rozšíření obsahuje šablonu projektu nebo šablony položky, přidat ProjectTemplate nebo ItemTemplate elementu Assets prvku.Nastavte hodnotu nového prvku relativní cestu složky obsahující šablonu v balíčku VSIX.Další informace naleznete v tématu ProjectTemplate Element a ItemTemplate Element.

   • Pokud vaše rozšíření obsahuje vlastní průvodce pro šablonu projektu nebo šablony položky, přidat Assembly elementu Assets prvku.Nastavte hodnotu nového prvku relativní cesta sestavení balíčku VSIX a potom nastavte AssemblyName atribut úplného názvu sestavení (včetně verze, jazyková verze a tokenu veřejného klíče).Další informace naleznete v tématu Prvek závislost (VSX schéma).

Příklad

Následující příklad ukazuje obsah souboru extension.vsixmanifest pro rozšíření nástrojů služby SharePoint.Rozšíření je implementována v sestavení s názvem Contoso.ProjectExtension.dll.Rozšíření zahrnuje sestavení příkazu SharePoint s názvem Contoso.ExtensionCommands.dll a šablonu položky ve složce s názvem ItemTemplates v balíčku VSIX.Tento příklad předpokládá, že jsou obě sestavení ve stejné složce jako soubor extension.vsixmanifest v balíčku VSIX.

<PackageManifest Version=”2.0.0” xmlns=”https://schemas.microsoft.com/developer/vsx-schema/2011”>
  <Metadata>
    <Identity Id="CustomActionProjectItem.Microsoft.b99efe4d-cef3-4afd-b9af-034ca0c52743" Version="1.0" Language="en-US" Publisher="Microsoft" />
    <DisplayName>CustomActionProjectItem</DisplayName>
    <Description>Empty VSIX Project.</Description>
  </Metadata>
  <Installation>
    <InstallationTarget Id="Microsoft.VisualStudio.Pro" Version="11.0" />
  </Installation>
  <Dependencies>
    <Dependency Id="Microsoft.Framework.NDP" DisplayName="Microsoft .NET Framework" Version="4.5" />
  </Dependencies>
  <Assets>
    <Asset Type="Microsoft.VisualStudio.ItemTemplate" Path="ItemTemplates" />
    <Asset Type="Microsoft.VisualStudio.MefComponent" Path="ProjectItemDefinition.dll" />
  </Assets>
</PackageManifest>

Viz také

Koncepty

Rozšíření systému projektů služby SharePoint

Volání do objektových modelů služby SharePoint

Ladění rozšíření pro nástroje služby SharePoint v aplikaci Visual Studio

Další zdroje

Rozšíření uzlu připojení služby SharePoint v aplikaci Server Explorer