Udostępnij za pośrednictwem

Debugowanie rozszerzeń dla narzędzia programu SharePoint w programie Visual Studio

  • Artykuł

Rozszerzenia narzędzi programu SharePoint w doświadczalnych wystąpienie lub regularne wystąpienie programu Visual Studio można debugować.Jeśli trzeba rozwiązać problem z rozszerzeniem, można również zmodyfikować wartości rejestru, aby wyświetlić dodatkowe informacje o błędzie i skonfigurować, jak Visual Studio wykonuje polecenia programu SharePoint.

Debugowanie rozszerzeń w doświadczalnych wystąpienie programu Visual Studio

Ochrona środowiska programowania Visual Studio z przypadkowym uszkodzeniem przez niesprawdzone rozszerzenia, Visual Studio SDK zawiera alternatywne wystąpienie programu Visual Studio o nazwie eksperymentalnych wystąpienie, że można użyć, aby zainstalować i przetestować rozszerzeń.Opracowanie nowych rozszerzeń za pomocą regularnych wystąpienie programu Visual Studio, ale debugowania i uruchomić je w instancji doświadczalnych.Aby uzyskać więcej informacji, zobacz Doświadczalne wystąpienia programu Visual Studio.

Jeśli za pomocą projektu VSIX rozszerzenie projektu VSIX jest projekt uruchamiania w swoje rozwiązanie, Visual Studio automatycznie instaluje i uruchamia rozszerzenie w przypadku eksperymentalnych podczas debugowania rozwiązanie.Projekt uruchamiania jest projekt, który rozpoczyna się podczas debugowania rozwiązanie, które zawiera wiele projektów.Aby uzyskać więcej informacji na temat Twojego rozszerzenia za pomocą projektu VSIX, zobacz Wdrażanie rozszerzeń dla narzędzia programu SharePoint w programie Visual Studio.Aby uzyskać więcej informacji na temat projektów uruchamiania, zobacz [NIB] 12/13 Porady: wybieranie projektu startowego.

Przykłady ilustrujące sposób debugowania różnych typów rozszerzeń w doświadczalnych wystąpienie programu Visual Studio zobacz następujące opisy:

Debugowanie rozszerzeń w regularnych wystąpienie programu Visual Studio

Jeśli chcesz debugować projektu rozszerzenie w regularnych wystąpienie programu Visual Studio, należy najpierw zainstalować rozszerzenia w regularnych wystąpienie.Następnie dołączyć debugera do drugiego procesu programu Visual Studio.Po zakończeniu można usunąć rozszerzenie, tak, że nie jest już ładuje na komputerze deweloperskim.

Aby zainstalować rozszerzenie

  1. Zamknij wszystkie wystąpienia programu Visual Studio.

  2. W folderze wyjściowym budować rozszerzenie projektu, otwórz plik .vsix, klikając go dwukrotnie lub otwarcie menu skrótów, a następnie wybierając Otwórz:

  3. W Programu Visual Studio rozszerzenie Installer okno dialogowe Wybierz wydanie programu Visual Studio, do którego chcesz zainstalować rozszerzenie, a następnie wybierz zainstalować przycisk.

    Visual Studio instaluje pliki z rozszerzeniem %UserProfile%\AppData\Local\Microsoft\VisualStudio\11.0\Extensions\Imię i nazwisko autora\Nazwa rozszerzenia\wersji.Ostatnie trzy foldery w tej ścieżce są wykonane z Author, Name, i Version elementy w pliku extension.vsixmanifest dla rozszerzenia.

  4. Po Visual Studio instaluje rozszerzenie, wybierz opcję Zamknij przycisk.

Aby debugować rozszerzenia

  1. Uruchom Visual Studio z uprawnieniami administratora, a następnie otwórz rozszerzenie projektu.Następujące kroki odnoszą się do tego wystąpienia programu Visual Studio jako pierwsze wystąpienie.

  2. Uruchomienie innego wystąpienia programu Visual Studio z uprawnieniami administratora.Następujące kroki odnoszą się do tego wystąpienia programu Visual Studio jako drugiej instancji.

  3. Przełącz się do pierwszego wystąpienia programu Visual Studio.

  4. Na pasku menu wybierz Debug, Dołącz do procesu.

  5. W Dostępne procesy wybierz devenv.exe.Ten wpis odnosi się do drugiej instancji programu Visual Studio; jest to wystąpienie chcesz debugować swoje rozszerzenie projektu w.

  6. Wybierz Attach przycisk.

    Visual Studio działa rozszerzenie projektu w trybie debugowania.

  7. Przełącz się do drugiej instancji programu Visual Studio.

  8. Tworzenie nowego projektu programu SharePoint, który ładuje rozszerzenie.Na przykład, jeśli debugowania z rozszerzeniem dla elementów projektu definicji listy Utwórz Listy definicji projektu.

  9. Wykonywanie, niezależnie od czynności są wymagane do testowania kodu rozszerzenie.

  10. Po zakończeniu debugowania rozszerzenie zamknąć drugie wystąpienie programu Visual Studio.

Aby usunąć rozszerzenie

  1. W programie Visual Studio, na pasku menu wybierz Narzędzia, rozszerzenia i aktualizacje.

    Rozszerzenia i aktualizacje zostanie otwarte okno dialogowe.

  2. Na liście rozszerzeń, należy wybrać nazwę rozszerzenia, a następnie wybierz odinstalować przycisk.

  3. W wyświetlonym oknie dialogowym wybierz Tak przycisk, aby potwierdzić, że chcesz odinstalować rozszerzenie.

  4. Wybierz Uruchom ponownie teraz przycisk, aby zakończyć dezinstalację.

Debugowanie poleceń programu SharePoint

Jeśli chcesz debugować polecenia programu SharePoint, która jest częścią rozszerzenie narzędzia programu SharePoint, należy dołączyć debuger do procesu vssphost4.exe.Jest to proces hosta 64-bit, który wykonuje polecenia programu SharePoint.Aby uzyskać więcej informacji na temat poleceń programu SharePoint i vssphost4.exe, zobacz Wywołanie do modeli obiektów programu SharePoint.

Aby dołączyć debuger do procesu vssphost4.exe

  1. Rozpocząć debugowanie Twojego rozszerzenia w doświadczalnych wystąpienie programu Visual Studio lub regularne wystąpienie programu Visual Studio, postępując zgodnie z instrukcjami.

  2. W przypadku programu Visual Studio debugger, w którym jest uruchomiony na pasku menu, Debug, Dołącz do procesu.

  3. W Dostępne procesy listy, wybierz opcję vssphost.exe.

    [!UWAGA]

    Jeśli vssphost.exe nie ma na liście, należy uruchomić proces vssphost4.exe w wystąpieniu programu Visual Studio, w którym są uruchomione rozszerzenia.Zazwyczaj można to zrobić, wykonując akcję, która powoduje, że Visual Studio połączyć się z witryną programu SharePoint na komputerze deweloperskim.Na przykład Visual Studio rozpoczyna się vssphost4.exe, po rozwinięciu węzła połączenia witryny (węzeł, który wyświetla adres URL witryny) pod Połączeń SharePoint węzeł w Server Explorer okna, lub po dodaniu pewnych elementów projektu programu SharePoint, takich jak Instancji List lub Odbiorca zdarzenia elementy do projektu programu SharePoint.

  4. Wybierz Attach przycisk.

  5. W wystąpieniu programu Visual Studio jest debugowany należy wykonać czynności, które są wymagane do wykonania polecenia.

Modyfikowanie wartości rejestru do debugowania rozszerzenia narzędzi programu SharePoint

Podczas debugowania rozszerzenie narzędzia programu SharePoint w programie Visual Studio, można zmodyfikować wartości w rejestrze, aby ułatwić rozwiązywanie problemów z rozszerzeniem.Istnieją wartości w kluczu HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\11.0\SharePointTools.Te wartości domyślnie nie istnieje.

Aby ułatwić rozwiązywanie wszelkich rozszerzenie narzędzia programu SharePoint, można utworzyć i ustawić wartość EnableDiagnostics.W poniższej tabeli opisano tę wartość.

Wartość

Opis

EnableDiagnostics

REG_DWORD, która określa, czy diagnostyczne wiadomości są wyświetlane w produkcji okna.

Wyświetlanie komunikatów diagnostycznych, wartość tę należy ustawić na wartość 1.Aby zatrzymać wyświetlanie komunikatów, należy ustawić tę wartość na 0 lub usunąć tę wartość.

Pisać wiadomości, aby produkcji programu SharePoint w oknie narzędzia rozszerzenie, korzystać z usługi programu SharePoint projektu.Aby uzyskać więcej informacji, zobacz Za pomocą usługi SharePoint projektu.

Jeśli rozszerzenie zawiera polecenia programu SharePoint, można utworzyć i ustawić dodatkowe wartości, aby ułatwić rozwiązywanie polecenia.W poniższej tabeli opisano te wartości.

Wartość

Opis

AttachDebuggerToHostProcess

REG_DWORD, która określa, czy mają być wyświetlane okno dialogowe, które pozwala na dołączanie debugera do vssphost4.exe tak szybko, jak zaczyna się.Jest to przydatne, jeśli polecenie, które chcesz debugować jest wykonywany przez vssphost.exe, natychmiast po jego uruchomieniu, i nie jest wystarczająco dużo czasu, aby ręcznie uruchomić debugera, przed wykonaniem polecenia.Aby wyświetlić okno dialogowe, wywołania vssphost4.exe Debugger.Break metoda podczas jego uruchamiania.

Aby włączyć to zachowanie, ta wartość 1.Aby wyłączyć to zachowanie, ustaw tę wartość na 0 lub usunąć tę wartość.

Jeśli ta wartość jest ustawiona na 1, może również chcesz zwiększyć wartość HostProcessStartupTimeout, aby dać sobie wystarczająco dużo czasu na dołączanie debugera, przed vssphost4.exe, aby zasygnalizować, że uruchomiona pomyślnie oczekuje, że Visual Studio.

ChannelOperationTimeout

REG_DWORD, który określa czas w sekundach, przez Visual Studio czeka na wykonanie polecenia programu SharePoint.Jeśli polecenie nie jest wykonywane w czasie, SharePointConnectionException jest generowany.

Wartość domyślna to 120 sekund.

HostProcessStartupTimeout

REG_DWORD, który określa czas w sekundach, przez Visual Studio czeka na vssphost4.exe zasygnalizować, że został uruchomiony pomyślnie.Jeśli vssphost4.exe nie sygnał pomyślne uruchomienie w czasie, SharePointConnectionException jest generowany.

Wartość domyślna to 60 sekund.

MaxReceivedMessageSize

REG_DWORD, która określa maksymalny dozwolony rozmiar w bajtach wiadomości WCF, które są przekazywane między Visual Studio i vssphost4.exe.

Wartość domyślna jest 1048576 bajtów (1 MB).

MaxStringContentLength

REG_DWORD, która określa maksymalny dozwolony rozmiar w bajtach, ciągów, które są przekazywane między Visual Studio i vssphost4.exe.

Wartość domyślna jest 1048576 bajtów (1 MB).

Zobacz też

Koncepcje

Wdrażanie rozszerzeń dla narzędzia programu SharePoint w programie Visual Studio

Inne zasoby

Rozszerzanie narzędzi programu SharePoint w programie Visual Studio