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ích instance nebo pravidelné instance aplikace Visual Studio. Je třeba řešit chování rozšíření, můžete také změnit hodnoty registru zobrazte další informace o chybách a konfigurovat jak Visual Studio provede příkazy služby SharePoint.

Ladění rozšíření 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 Visual Studio SDK poskytuje alternativní instanci aplikace Visual Studio, nazývanou experimentální instance, která je k dispozici k instalaci a testování rozšíření. Při vývoji nových rozšíření pomocí pravidelných instancí aplikace Visual Studio, ale ladění a spouštění v experimentální instanci. Další informace naleznete v tématu The Experimental Instance of 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 spuštění naleznete v tématu How to: Choose the Startup Project.

Příklady, které ukazují, jak různé typy rozšíření experimentální instance aplikace Visual Studio viz následující kurzy:

Ladění rozšíření 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í poklikejte na soubor .vsix.

  3. V dialogovém okně Visual Studio Instalační služba rozšíření 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\10.0\Extensions\author name\extension name\version. Poslední tři složky v této cestě jsou zhotoveny z prvků Author, Name a Version v souboru extension.vsixmanifest pro rozšíření.

  4. Po tom 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 nabídce Ladění klikněte na tlačítko Připojit k procesu.

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

  6. Klepně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.

Chcete-li odebrat rozšíření

  1. V aplikaci Visual Studio v nabídce Nástroje klikněte na Správce rozšíření.

    Otevře se okno Správce rozšíření.

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

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

  4. Klikněte na Restartovat nyní pro dokonční odinstalace.

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.

Pro připojení ladicího programu k procesu vssphost4.exe

  1. Spušťte ladění vašeho 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 nabídce Ladit na tlačítko Připojit k procesu.

  3. V seznamu Procesy k dispozici klikněte na 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. Klepněte na tlačítko Připojit.

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

Změna hodnot registru pomoci při ladění rozšíření nástroje služby SharePoint

Při ladění rozšíření nástrojů služby SharePoint v aplikaci Visual Studio, můžete upravit hodnoty v registru, které vám pomohou vyřešit rozšíření. Existují hodnoty v klíči HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\10.0\SharePointTools. Tyto hodnoty neexistují ve výchozím nastavení.

Chcete-li řešení prodloužení nástroje služby SharePoint, můžete nastavit hodnotu EnableDiagnostics. Následující tabulka popisuje tuto hodnotu.

Hodnota

Popis

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 Pomocí služby SharePoint projektu.

Pokud vaše rozšíření obsahuje příkaz služby SharePoint, můžete nastavit další hodnoty k řešení příkaz. Následující tabulka popisuje tyto hodnoty.

Hodnota

Popis

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, tuto hodnota nastavte 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á příkaz SharePoint k provedení. 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é

Další zdroje

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

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