Sdílet prostřednictvím

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

  • Článek

Můžete ladit rozšíření nástrojů SharePoint v experimentální instanci nebo pravidelné instanci aplikace Visual Studio.Potřebujete-li poradce při potížích s chováním rozšíření, můžete také změnit hodnoty registru pro zobrazení dalších informací o chybě a pro konfiguraci, jak aplikace Visual Studio provede příkazy serveru SharePoint.

Rozšíření ladění v experimentální instanci aplikace Visual Studio

K ochraně vašeho vývojového prostředí Visual Studio před náhodným poškozením netestovaným rozšířením poskytuje Visual Studio SDK alternativní instanci aplikace Visual Studio nazývanou experimentální instance, která je k dispozici k instalaci a testování rozšíření.Nová rozšíření vyvíjíte pomocí pravidelných instancí aplikace Visual Studio, ale ladíte a spouštíte je v experimentální instanci.Další informace naleznete v tématu Experimentální Instance aplikace Visual Studio.

Je-li k nasazení vašeho rozšíření použit projekt VSIX a projekt VSIX je projekt po spuštění ve vašem řešení, Visual Studio automaticky nainstaluje a spustí rozšíření v experimentální instanci při ladění vašeho řešení.Projekt spuštění je projekt, který se spustí při ladění řešení, které obsahuje více projektů.Další informace o použití projektu VSIX pro nasazení vašeho rozšíření naleznete v tématu Nasazování rozšíření pro nástroje služby SharePoint v aplikaci Visual Studio.Další informace o projektech po spuštění naleznete v tématu Postupy: Nastavení projektů po spuštění.

Příklady ukazující, jak lze ladit různé typy rozšíření v experimentální instanci aplikace Visual Studio, naleznete v následujících návodech:

Rozšíření ladění v normální instanci aplikace Visual Studio

Chcete-li ladit vaše rozšíření projektu v normální instanci aplikace Visual Studio, nejprve instalujte rozšíření v normální instanci.Potom připojte ladicí program k druhému procesu Visual Studio.Po dokončení můžete odebrat rozšíření tak, aby se již ve vývojovém počítači nenačítalo.

Chcete-li instalovat rozšíření

  1. Ukončete všechny instance aplikace Visual Studio.

  2. Ve výstupní složce sestavení pro projekt rozšíření otevřete soubor .vsix poklepáním nebo otevřením jeho místní nabídky a zvolením Otevřít:

  3. V dialogovém okně Instalační služba rozšíření Visual Studio zvolte edici sady Visual Studio, do které chcete instalovat rozšíření a klikněte na tlačítko Instalovat.

    Visual Studio nainstaluje soubory rozšíření do %UserProfile%\AppData\Local\Microsoft\VisualStudio\11.0\Extensions\author name\extension name\version.Poslední tři složky v této cestě jsou vytvořeny z prvků Author, Name a Version v souboru extension.vsixmanifest pro rozšíření.

  4. Poté, co Visual Studio nainstaluje rozšíření, klikněte na tlačítko Zavřít.

Chcete-li ladit rozšíření

  1. Spusťte aplikaci Visual Studio s oprávněními správce a otevřete projekt rozšíření.Následující kroky odkazují na tuto instanci aplikace Visual Studio jako první instanci.

  2. Spusťte jinou instanci aplikace Visual Studio s oprávněními správce.Následující kroky odkazují na tuto instanci aplikace Visual Studio jako druhou instanci.

  3. Přepněte na první instanci aplikace Visual Studio.

  4. V panelu nabídky zvolte Ladění, Připojit k procesu.

  5. V seznamu Procesy k dispozici zvolte devenv.exe.Tato položka odkazuje na druhou instanci aplikace Visual Studio; toto je instance, kterou chcete ladit rozšíření vašeho projektu.

  6. Klikněte na tlačítko Připojit.

    Visual Studio spustí rozšíření projektu v režimu ladění.

  7. Přepněte na druhou instanci aplikace Visual Studio.

  8. Vytvořte nový projekt služby SharePoint, který načte rozšíření.Například ladíte-li rozšíření pro položky projektu definice seznamu, vytvořte projekt Seznam definic.

  9. Provádění jakýchkoli kroků je nezbytné pro testování kódu rozšíření.

  10. Po dokončení ladění rozšíření zavřete druhou instanci programu Visual Studio.

Odebrat rozšíření

  1. V sadě Visual Studio v panelu nabídek zvolte možnosti Nástroje, Rozšíření a aktualizace.

    Otevře se dialogové okno Aktualizace a rozšíření.

  2. V seznamu rozšíření zvolte název rozšíření a potom klikněte na tlačítko Odinstalovat.

  3. V dialogovém okně, které se objeví, zvolte tlačítko Ano pro potvrzení, že chcete odinstalovat rozšíření.

  4. Zvolením tlačítka Restartovat nyní dokončete odinstalaci.

Ladění příkazů služby SharePoint

Pokud chcete ladit příkaz SharePoint, který je součástí rozšíření nástrojů aplikace SharePoint, je nutné připojit ladicí program k procesu vssphost4.exe.To je 64bitový hostitelský proces, který provede příkazy služby SharePoint.Další informace o příkazech SharePoint a vssphost4.exe najdete v tématu Volání do objektových modelů služby SharePoint.

Připojení ladicího programu k procesu vssphost4.exe

  1. Spusťte ladění rozšíření v experimentální instanci aplikace Visual Studio nebo normální instanci aplikace Visual Studio podle výše uvedených pokynů.

  2. V instanci aplikace Visual Studio, ve které používáte ladicí program, klikněte v panelu nabídky na Ladit, Připojit k procesu.

  3. V seznamu Procesy k dispozici zvolte vssphost.exe.

    [!POZNÁMKA]

    Pokud se vssphost.exe v seznamu nezobrazí, je nutné spustit proces vssphost4.exe v instanci aplikace Visual Studio, ve které používáte rozšíření.Obvykle to uděláte provedením akce, která způsobí, že se Visual Studio připojí k webu služby SharePoint ve vývojovém počítači.Například Visual Studio spustí vssphost4.exe po rozbalení uzlu připojení k webu (uzel, který zobrazuje adresu URL webu) pod uzlem Připojení služby SharePoint v okně Průzkumník serveru, nebo pokud přidáte určité položky projektu služby SharePoint, jako jsou například položky Seznam instancí nebo Přijímač událostí, do projektu služby SharePoint.

  4. Klikněte na tlačítko Připojit.

  5. V instanci aplikace Visual Studio, která je právě laděna, proveďte kroky nutné pro provedení příkazu.

Změny hodnot registrů pro pomoc s laděním rozšíření služby SharePoint

Při ladění rozšíření nástrojů SharePoint v aplikaci Visual Studio můžete změnit hodnoty registru pro usnadnění odstraňování potíží s rozšířením.Hodnoty existují v klíči HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\11.0\SharePointTools.Tyto hodnoty neexistují ve výchozím nastavení.

Chcete-li řešit potíže jakéhokoli rozšíření nástrojů služby SharePoint, můžete vytvořit a nastavit hodnotu EnableDiagnostics.Následující tabulka tuto hodnotu popisuje.

Value

Description

EnableDiagnostics

REG_DWORD, která určuje, zda jsou diagnostické zprávy zobrazeny v okně Výstup.

Chcete-li zobrazit diagnostické zprávy, nastavte tuto hodnotu na 1.Chcete-li ukončit zobrazování zpráv, nastavte tuto hodnotu na 0 nebo tuto hodnotu odstraňte.

Pro zapisování zpráv do okna Výstup z rozšíření nástrojů SharePoint použijte službu projektu SharePoint.Další informace naleznete v tématu Použití služby projektu služby SharePoint.

Pokud vaše rozšíření obsahuje příkaz SharePoint, můžete vytvořit a nastavit další hodnoty, které vám pomohou řešit potíže s příkazem.Následující tabulka tyto hodnoty popisuje.

Value

Description

AttachDebuggerToHostProcess

REG_DWORD, která určuje, zda se má zobrazit dialogové okno, které umožňuje připojit ladicí program k vssphost4.exe co nejdříve po spuštění.To je užitečné, pokud je příkaz, který chcete ladit, spuštěn ve vssphost.exe ihned po svém spuštění a není dostatek času ručně připojit ladicí program před provedením příkazu.Pro zobrazení dialogového okna volá vssphost4.exe při spuštění metodu Debugger.Break.

Chcete-li povolit toto chování, nastavte tuto hodnotu na 1.Chcete-li toto chování vypnout, nastavte hodnotu na 0 nebo tuto hodnotu odstraňte.

Pokud jste nastavili tuto hodnotu na 1, můžete také zvýšit hodnotu HostProcessStartupTimeout, abyste si zajistili dostatek času na připojení ladicího programu před očekávaným signálem vssphost4.exe pro Visual Studio, že je úspěšně spuštěn.

ChannelOperationTimeout

REG_DWORD, které udává čas v sekundách, po který Visual Studio čeká na provedení příkazu SharePoint.Pokud se příkaz nespustí včas, je vyvolána SharePointConnectionException.

Výchozí hodnota je 120 sekund.

HostProcessStartupTimeout

REG_DWORD určující dobu v sekundách, po kterou Visual Studio čeká na signál vssphost4.exe, že byl úspěšně spuštěn.Pokud vssphost4.exe nevydá signál o úspěšném včasném spuštění, je vyvolána SharePointConnectionException.

Výchozí hodnota je 60 sekund.

MaxReceivedMessageSize

REG_DWORD specifikuje maximální povolenou velikost v bajtech zpráv WCF, které jsou předávány mezi Visual Studio a vssphost4.exe.

Výchozí hodnota je 1 048 576 bajtů (1 MB).

MaxStringContentLength

REG_DWORD specifikuje maximální povolenou velikost v bajtech řetězců, které jsou předávány mezi Visual Studio a vssphost4.exe.

Výchozí hodnota je 1 048 576 bajtů (1 MB).

Viz také

Koncepty

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

Další zdroje

Rozšíření nástrojů SharePoint v aplikaci Visual Studio