Udostępnij za pośrednictwem

Rozwiązywanie problemów z wdrażaniem rozwiązań 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 według aplikacja pakietu Office lication i typu projektu.

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

Podgląd zdarzeń w systemie Windows umożliwia wyświetlanie komunikatów o błędach przechwyconych 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 Aplikacja projektanta projektu po wdrożeniu rozwiązania, narzędzia publikowania zmodyfikują pakiet instalacyjny tak, aby miał jeden plik Setup.exe i dwa manifesty wdrożenia. 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 programu Visual Studio 2010 Tools for Office udostępnia wpis rejestru, którego administratorzy mogą używać do ustawiania wartości limitu czasu 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, które znajdują 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 powiedzieć: "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ż przeznaczone tylko do odczytu dla użytkowników końcowych.

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

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

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

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

Buforowane zestawy są ładowane zamiast zaktualizowanych zestawów

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

Program Visual Studio można skonfigurować tak, aby narzędzie Fusion pobierało zestawy za każdym razem, gdy projekt zostanie uruchomiony.

Jak pobierać zestawy zamiast ładować buforowane kopie

  1. Na pasku menu wybierz pozycję Projekt, <Właściwości ProjectName>.
  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 kontynuować podpisywanie zestawu za pomocą silnej nazwy, a narzędzie Fusion załaduje najnowszą wersję dostosowania.

Uwaga 16.

Począwszy od programu Visual Studio 2017, jeśli spróbujesz użyć symboli wieloznacznych w wersji zestawu, wystąpi błąd kompilacji. Dzieje się tak, ponieważ symbole wieloznaczne w wersji zestawu spowodują przerwanie funkcji deterministycznej msBuild. Zostanie wyświetlony monit o usunięcie symboli wieloznacznych z wersji zestawu lub wyłączenie determinizmu. Aby dowiedzieć się więcej na temat funkcji deterministycznej, zobacz: 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

W przypadku publikowania rozwiązania pakietu Office w lokalizacji HTTP/HTTPS/FTP ścieżka nie może zawierać żadnych znaków Unicode, które nie są w zestawie 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 dewelopera

Podczas tworzenia rozwiązania pakietu Office skompilowana wersja jest automatycznie rejestrowana. Jeśli wcześniej opublikowano i zainstalowano to samo rozwiązanie na komputerze dewelopera, środowisko uruchomieniowe Visual Studio Tools dla pakietu Office wykryje, że ścieżka instalacji dla opublikowanej wersji i wersja kompilowana są inne po następnym skompiluj, skompiluj lub opublikowanym rozwiązaniu. Komunikat o błędzie informuje o tym, że "nie można zainstalować dostosowania, ponieważ jest obecnie zainstalowana inna wersja i nie można jej uaktualnić z tej lokalizacji". Klucze rejestru są aktualizowane za każdym razem, gdy rozwiązanie zostanie ponownie skompilowane. 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 dewelopera, aby przetestować wdrożenie. Alternatywnie możesz odinstalować wersję z listy zainstalowanych programów na komputerze przed następnym opublikowaniem, debugowaniem lub odbudową rozwiązania.

Błąd nieumyślnego wyjątku lub metody nie znaleziono podczas instalowania rozwiązania

Podczas instalowania rozwiązań pakietu Office, otwierając manifest wdrożenia (plik vsto), aplikacja pakietu Office lication, document lub workbook, mogą pojawić się komunikaty o błędach dla następujących warunków:

  • Nie można odnaleźć metody.
  • MissingMethodException.
  • Nieuchwycony wyjątek.

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 wymagań wstępnych ani nie instaluje ich. Program instalacyjny sprawdza poprawną wersję wymagań wstępnych i instaluje je w razie potrzeby.

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

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

Aby obejść ten problem, utwórz projekt InstallShield Limited Edition w innym rozwiązaniu lub użyj nazwy 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 dane osobowe nie są już zainstalowane.

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

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

Podczas ponownej instalacji rozwiązania ArgumentOutOfRangeException pakietu Office może pojawić się wyjątek z następującym 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 zostanie wyświetlony, jeśli po raz pierwszy zainstalowano rozwiązanie http://fabrikam.com/ExcelSolution.vsto pakietu Office, a następnie użyto http://fabrikam.com/excelsolution.vsto go po raz drugi.

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

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

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 wdrożeniem rozwiązania pakietu Office należy zdefiniować typ MIME w usługach IIS.

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

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

Informacje