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.Potřebujete-li Poradce při potížích s chováním rozšíření, můžete také změnit hodnoty registru Chcete-li zobrazit další informace o chybě a nakonfigurovat, 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 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 spuštění naleznete v tématu [NIB] 12/13 Postupy: Výběr spouštěného projektu.

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

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í otevřete soubor .vsix poklepáním nebo otevřením své místní nabídce a potom zvolíte otevřete:

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

    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 zhotoveny z prvků Author, Name a Version v souboru extension.vsixmanifest pro rozšíření.

  4. Po tom co Visual Studio nainstaluje rozšíření, zvolte Zavřít tlačítko.

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. Na panelu nabídek zvolte ladění, připojit k procesu.

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

  6. Zvolte Attach tlačítko.

    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 řádku nabídek zvolte Nástroje, aktualizace a rozšíření.

    Aktualizace a rozšíření dialogové okno.

  2. V seznamu rozšíření zvolte název rozšíření a pak zvolte Odinstalace tlačítko.

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

  4. Zvolte Restartovat nyní tlačítko 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, které používáte ladicí program, v řádku nabídek zvolte ladění, připojit k procesu.

  3. V Procesy k dispozici vyberte 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. Zvolte Attach tlačítko.

  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ástrojů SharePoint

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

K řešení rozšíření nástrojů SharePoint, můžete vytvořit a nastavit hodnotu EnableDiagnostics.Následující tabulka popisuje tuto hodnotu.

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

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

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, 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é

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