Udostępnij za pośrednictwem

Rozwiązywanie problemów z wdrażaniem rozwiązania pakietu Office

  • Artykuł

Dotyczy: Visual Studio

W tym artykule przedstawiono sposób rozwiązywania typowych problemów, które mogą wystąpić podczas wdrażania rozwiązań pakietu Office.

Informacje zawarte w tym artykule dotyczą projektów na poziomie dokumentu i projektów dodatków Visual Studio Tools dla pakietu Office (VSTO). Zobacz Funkcje dostępne przez aplikację pakietu Office i typ projektu.

Rozwiązywanie problemów z rozwiązaniami pakietu Office przy użyciu przeglądarki zdarzeń

Podgląd zdarzeń w systemie Windows umożliwia wyświetlanie komunikatów o błędach przechwytywanych przez środowisko uruchomieniowe Visual Studio Tools dla pakietu Office podczas instalowania lub odinstalowywania rozwiązań pakietu Office. Możesz użyć tych komunikatów z rejestratora zdarzeń, aby rozwiązać problemy z instalacją i wdrażaniem. Aby uzyskać więcej informacji, zobacz Rejestrowanie zdarzeń dla rozwiązań pakietu Office.

Zmiana nazwy zestawu powoduje konflikty

Jeśli zmienisz wartość Nazwa zestawu na stronie Aplikacjaprogramu Project Projektant po wdrożeniu rozwiązania, narzędzia do publikowania zmodyfikują pakiet instalatora tak, aby miał jeden plikSetup.exe i dwa manifesty wdrażania. W przypadku wdrożenia dwóch plików manifestu mogą wystąpić następujące warunki:

  • Jeśli użytkownik końcowy zainstaluje obie wersje, aplikacja załaduje oba dodatki VSTO.
  • Jeśli dodatek VSTO został zainstalowany przed zmianą nazwy zestawu, użytkownik końcowy nigdy nie otrzyma aktualizacji.

Aby uniknąć tych warunków, nie zmieniaj wartości nazwy zestawu rozwiązania po wdrożeniu rozwiązania.

Sprawdzanie dostępności aktualizacji trwa długo

Środowisko uruchomieniowe narzędzi Visual Studio 2010 Tools for Office udostępnia wpis rejestru, którego administratorzy mogą użyć do ustawienia wartości limitu czasu na potrzeby pobierania manifestów i rozwiązania.

Jak ustawić wartość limitu czasu

  1. W rejestrze przejdź do następującego klucza:

    HKEY_CURRENT_USER\Software\Microsoft\VSTA

  2. W podkluczu AddInTimeout ustaw wartość limitu czasu w milisekundach.

    Jeśli podklucz AddInTimeout nie istnieje, utwórz go jako dword.

Nie można zaktualizować ani opublikować w sieciowym udziale plików

Rozwiązania pakietu Office znajdujące się w sieciowym udziale plików mogą wyświetlać mylący komunikat podczas aktualizacji, jeśli plik Setup.exe rozwiązania jest zablokowany w procesie podczas publikowania aktualizacji. Komunikat może zawierać następującą informację: "Nie można dodać "setup.exe" do sieci Web. Plik "setup.exe" już istnieje w tej sieci Web."

Aby zapobiec blokowaniu plików, możesz udostępnić udział tylko do odczytu użytkownikom końcowym. Jeśli jednak dokumenty znajdują się w udziale, staną się one również tylko do odczytu dla użytkowników końcowych.

Wymagania wstępne dotyczące pakietu Microsoft Office nie są zainstalowane

Jako wymagania wstępne wdrożone w rozwiązaniu pakietu Office możesz dodać .NET Framework, środowisko uruchomieniowe Visual Studio Tools dla pakietu Office i podstawowe zestawy międzyoperacyjne pakietu Office. Aby uzyskać informacje o sposobie instalowania podstawowych zestawów międzyoperacyjnych, zobacz Konfigurowanie komputera do opracowywania rozwiązań pakietu Office oraz Instrukcje: instalowanie podstawowych zestawów międzyoperacyjnych pakietu Office.

Publikowanie przy użyciu hosta lokalnego może powodować problemy z instalacją

W przypadku używania http://localhost jako lokalizacji publikowania lub instalacji dla rozwiązań na poziomie dokumentu Kreator publikowania nie konwertuje ciągu na prawdziwą nazwę komputera. W takim przypadku rozwiązanie musi być zainstalowane na komputerze deweloperskim. Aby wdrożyć rozwiązania, użyj usług IIS na komputerze deweloperskim, użyj w pełni kwalifikowanej nazwy dla wszystkich lokalizacji HTTP/HTTPS/FTP zamiast hosta lokalnego.

Zestawy buforowane są ładowane zamiast zaktualizowanych zestawów

Fusion, moduł ładujący zestaw .NET Framework, ładuje buforowaną kopię zestawów, gdy ścieżka wyjściowa projektu znajduje się w udziale plików sieciowych, zestaw jest podpisany z silną nazwą, a wersja zestawu dostosowywania nie ulega zmianie. Jeśli zaktualizujesz zestaw spełniający te warunki, aktualizacja nie zostanie wyświetlona przy następnym uruchomieniu projektu, ponieważ kopia w pamięci podręcznej zostanie załadowana.

Program Visual Studio można skonfigurować tak, aby aplikacja Fusion pobierała zestawy za każdym razem, gdy projekt jest uruchamiany.

Jak pobrać zestawy zamiast ładowania kopii w pamięci podręcznej

  1. Na pasku menu wybierz pozycję Project, <ProjectName> Properties.
  2. Na stronie Aplikacja wybierz pozycję Informacje o zestawie.
  3. Ustaw numer poprawki, trzecie pole wersji zestawu, na symbol wieloznaczny (*). Na przykład "1.0.*". Następnie wybierz przycisk OK .

Po zmianie wersji zestawu możesz nadal podpisywać zestaw przy użyciu silnej nazwy, a funkcja Fusion załaduje najnowszą wersję dostosowania.

Uwaga

Począwszy od programu Visual Studio 2017, jeśli spróbujesz użyć symboli wieloznacznych w wersji zestawu, wystąpi błąd kompilacji. Jest to spowodowane tym, że symbole wieloznaczne w wersji zestawu przerywają funkcję deterministyczną MSBuild. Zostanie wyświetlona instrukcja usunięcia symboli wieloznacznych z wersji zestawu lub wyłączenia determinizmu. Aby dowiedzieć się więcej na temat funkcji deterministycznej, zobacz: Common MSBuild project properties and Customize your build (Typowe właściwości projektu MSBuild i Dostosowywanie kompilacji)

Instalacja kończy się niepowodzeniem, gdy identyfikator URI zawiera znaki, które nie są us-ASCII

Po opublikowaniu rozwiązania pakietu Office w lokalizacji HTTP/HTTPS/FTP ścieżka nie może zawierać żadnych znaków Unicode, które nie znajdują się w us-ASCII. Takie znaki mogą powodować niespójne zachowanie w programie instalacyjnym. Użyj znaków US-ASCII dla ścieżki instalacji.

Monit o ręczne odinstalowanie jest wyświetlany podczas publikowania i instalowania rozwiązania na komputerze deweloperskim

Podczas tworzenia rozwiązania pakietu Office skompilowana wersja jest automatycznie rejestrowana. Jeśli wcześniej opublikowano i zainstalowano to samo rozwiązanie na komputerze deweloperskim, Visual Studio Tools dla pakietu Office środowisko uruchomieniowe wykryje, że ścieżka instalacji opublikowanej wersji i wersji skompilowanej różnią się po następnym skompilowaniu, skompilowaniu lub opublikowaniu rozwiązania. Komunikat o błędzie mówi: "Nie można zainstalować dostosowania, ponieważ inna wersja jest obecnie zainstalowana i nie można jej uaktualnić z tej lokalizacji". Klucze rejestru są aktualizowane za każdym razem, gdy rozwiązanie jest odbudowywane. W związku z tym należy odinstalować poprzednią wersję przed opublikowaniem, debugowaniem lub uruchomieniem nowej wersji.

Aby zapobiec wyświetlaniu komunikatu, utwórz inne konto użytkownika na komputerze deweloperskim, aby przetestować wdrożenie. Alternatywnie można odinstalować wersję z listy zainstalowanych programów na komputerze przed następnym opublikowaniem, debugowaniem lub ponowną kompilacją rozwiązania.

Błąd nieprzeciętnego wyjątku lub metody nie znaleziono podczas instalowania rozwiązania

Podczas instalowania rozwiązań pakietu Office przez otwarcie manifestu wdrożenia (pliku vsto ), aplikacji pakietu Office, dokumentu lub skoroszytu mogą pojawić się komunikaty o błędach dotyczące następujących warunków:

  • Nie można odnaleźć metody.
  • Missingmethodexception.
  • Wyjątek bez szwanku.

Aby zapobiec tym komunikatom o błędach, zainstaluj rozwiązanie, uruchamiając program instalacyjny.

Podczas instalowania rozwiązania bez uruchamiania programu instalacyjnego instalator nie sprawdza ani nie instaluje wymagań wstępnych. Program instalacyjny sprawdza poprawną wersję wymagań wstępnych i instaluje je w razie potrzeby.

Klucze rejestru manifestu dla dodatków zmieniają się po utworzeniu projektu InstallShield Limited Edition

Klucz rejestru manifestu, który jest częścią programu instalatora dodatku VSTO, czasami zmienia się z .vsto na .dll.manifest podczas tworzenia projektu InstallShield Limited Edition.

Aby obejść ten problem, utwórz projekt InstallShield Limited Edition w innym rozwiązaniu lub użyj parametru CompanyName.AddinName jako wartości klucza rejestru zawierającego nazwę dodatku VSTO.

Instalator ClickOnce dla rozwiązania pakietu Office nie instaluje podstawowych zestawów międzyoperacyjnych

Po uruchomieniu programu instalacyjnego, który clickOnce tworzy dla rozwiązania pakietu Office, instalator podstawowych zestawów międzyoperacyjnych pakietu Office jest uruchamiany tylko wtedy, gdy żadne identyfikatory PIA nie są już zainstalowane.

Jeśli program instalacyjny nie zainstaluje poprawnie identyfikatorów PIA, zainstaluj je ręcznie, uruchamiając plik instalatora o nazwie o2007pia.msi z katalogu instalacyjnego.

Ponowne instalowanie rozwiązań pakietu Office powoduje wyjątek argumentu poza zakresem

Po ponownym zainstalowaniu rozwiązania pakietu Office może pojawić się wyjątek z następującym ArgumentOutOfRangeException komunikatem o błędzie: Określony argument był poza zakresem prawidłowych wartości.

Taka sytuacja występuje, jeśli wielkość liter adresu URL lokalizacji instalacji jest inna. Na przykład ten błąd będzie wyświetlany, jeśli rozwiązanie pakietu Office zostało zainstalowane po http://fabrikam.com/ExcelSolution.vsto raz pierwszy, a następnie użyto http://fabrikam.com/excelsolution.vsto go po raz drugi.

Aby zapobiec wyświetlaniu komunikatu, użyj tej samej obudowy podczas instalowania rozwiązań pakietu Office.

Nie można zainstalować rozwiązania ClickOnce, otwierając manifest wdrożenia z Internetu

Użytkownicy mogą instalować rozwiązania pakietu Office, otwierając manifest wdrożenia z Internetu. Jednak niektóre instalacje usług Internet Information Services (IIS) blokują rozszerzenie nazwy pliku vsto . Przed użyciem go do wdrożenia rozwiązania pakietu Office należy zdefiniować typ MIME w usługach IIS.

Aby uzyskać informacje na temat definiowania typu MIME w usługach IIS 7, zobacz Dodawanie typu MIME (IIS7).

Ustaw rozszerzenie na .vsto , a typ MIME na application/x-ms-vsto.

Informacje