Udostępnij przez


Aktualizowanie programu Visual Studio przy użyciu minimalnego układu offline

W przypadku komputerów, które nie są połączone z Internetem, tworzenie minimalnego układu jest najprostszym i najszybszym sposobem aktualizowania wystąpień programu Visual Studio w trybie offline.

Narzędzie minimalnego układu generuje układ dostosowany specjalnie do potrzeb twojego zespołu. Administratorzy przedsiębiorstwa mogą używać tego narzędzia do tworzenia układów aktualizacji dla większości wersji programu Visual Studio, w tym programu Visual Studio 2017. W przeciwieństwie do pełnego układu programu Visual Studio układ minimalny zawiera tylko zaktualizowane pakiety, dzięki czemu zawsze jest mniejszy i szybszy do generowania i wdrażania. Można jeszcze bardziej zminimalizować rozmiar układu aktualizacji, określając tylko żądane języki, obciążenia i składniki.

Jak wygenerować minimalny układ

Ważne

Instrukcje zakładają, że wcześniej utworzyłeś i używałeś układów. Aby uzyskać więcej informacji o tym, jak to zrobić, zobacz stronę Aktualizowanie instalacji opartej na sieci programu Visual Studio .

Aby lepiej zrozumieć cykl życia programu Visual Studio, zobacz stronę Cykl życia i obsługa produktu Visual Studio .

To narzędzie tworzy układy aktualizacji dla programu Visual Studio 2017 (15.9) i nowszych. Układ można wdrożyć na maszynach sieciowych/offline w celu zaktualizowania wystąpień programu Visual Studio. Podczas normalnego tworzenia układu pobierane są wszystkie pakiety dla tej konkretnej wersji. Normalne tworzenie układu jest wymagane do naprawiania, odinstalowywania i innych standardowych operacji w wystąpieniach programu Visual Studio. Minimalny układ pobiera tylko zaktualizowane pakiety, dzięki czemu jest mniejszy i łatwiejszy do kopiowania na maszyny w trybie offline.

Instalowanie minimalnego narzędzia układu

  1. Najpierw pobierz minimalne narzędzie układu znajdujące się tutaj. Pamiętaj, aby wybrać pozycję Zapisz po wyświetleniu monitu, a następnie wybierz pozycję Uruchom.

    Zapisz narzędzie do zapisu minimalnego układu

  2. Następnie zaakceptuj monit Kontrola konta użytkownika, klikając przycisk Tak.

    Akceptowanie kontroli konta użytkownika

  3. Narzędzie układu minimalnego zostanie zainstalowane do C:\Program Files (x86)\Microsoft Visual Studio\MinimalLayout.

Sposób użycia narzędzia układu minimalnego

MinimalLayout.exe Używa następujących poleceń i opcji do wygenerowania układu. Do uruchomienia narzędzia wymagane jest co najmniej jedno polecenie. Oto jak uruchomisz narzędzie:

MinimalLayout.exe [command] <options>...

Commands

  • Wersja zapoznawcza: użyj tego polecenia, aby wyświetlić podgląd liczby pobranych pakietów oraz łączną ilość miejsca użytego do utworzenia tego układu.

  • Generuj: użyj tego polecenia, aby wygenerować minimalny układ aktualizacji programu Visual Studio.

  • Regeneruj: użyj tego polecenia, aby odtworzyć układ za pomocą istniejącego minimalnego pliku odpowiedzi układu. Każdy minimalny układ tworzy MinimalLayout.json plik odpowiedzi, który zawiera oryginalne minimalne parametry wejściowe układu. Możesz użyć polecenia Regeneruj i pliku odpowiedzi MinimalLayout.json, aby wygenerować minimalny układ. Jest to przydatne, jeśli chcesz utworzyć minimalny układ nowej aktualizacji programu Visual Studio na podstawie pliku odpowiedzi poprzedniego układu minimalnego.

    W przypadku tego polecenia jest wymagana ścieżka pliku MinimalLayout.json z już wygenerowanego układu.

    MinimalLayout.exe regenerate --filePath C:\MinimalLayout\MinimalLayout.json
    
  • Sprawdź: użyj tego polecenia, aby określić, czy folder układu jest uszkodzony.

  • Poprawka: użyj tego polecenia, aby naprawić uszkodzony folder układu, w tym zastąpić wszystkie brakujące pakiety z folderu układu.

Opcje

Opcje Description Wymagane/opcjonalne Example
--targetLocation <dir> Określa katalog, w którym ma zostać utworzony minimalny układ offline. Required --targetLocation c:\VSLayout\
--baseVersion <wersja> Minimalny układ offline zostanie wygenerowany, począwszy od tej wersji. Required --baseVersion 16.4.0
--targetVersion <wersja> Minimalny układ w trybie offline zostanie wygenerowany do tej wersji włącznie. Required --targetVersion 16.4.4
--Języki Określa języki do uwzględnienia w minimalnym układzie offline. Można określić wiele wartości rozdzielonych spacjami. Required --języki en-US fr-FR
--productIds <co najmniej jeden identyfikator produktu> Identyfikatory produktów, z których zostanie wygenerowany minimalny układ offline, oddzielone przecinkami.
  • Microsoft.VisualStudio.Product.Enterprise
  • Microsoft.VisualStudio.Product.Professional
  • Microsoft.VisualStudio.Product.BuildTools
  • Microsoft.VisualStudio.Product.TestAgent
  • Microsoft.VisualStudio.Product.TestController
  • Microsoft.VisualStudio.Product.TeamExplorer
Required --productIds Microsoft.VisualStudio.Product.Enterprise, Microsoft.VisualStudio.Product.Professional
--filePath Ścieżka pliku MinimalLayout.json w już utworzonym układzie. Ta opcja jest używana tylko z poleceniem Regenerate. Wymagane do ponownego wygenerowania polecenia --filePath C:\VSLayout\minimalLayout.json

Należy pamiętać, że polecenie Ponowne generowanie przyjmuje tylko parametr --filePath jako opcję.
— dodawanie <co najmniej jednego identyfikatora obciążenia lub składnika> Określa co najmniej jeden identyfikator obciążenia lub składnika do dodania. Dodatkowe składniki można dodawać globalnie przy użyciu parametru --includeRecommended i/lub
--zawieraOpcjonalne Można określić wiele obciążeń lub identyfikatorów składników rozdzielonych spacją.
Opcjonalnie --add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.Workload.NetWeb Component.GitHub.VisualStudio
--includeRecommended Zawiera zalecane składniki dla wszystkich zainstalowanych obciążeń, ale nie składników opcjonalnych. Opcjonalnie W przypadku określonego obciążenia:
--add Microsoft.VisualStudio.Workload. ManagedDesktop;includeRecommended

Aby zastosować do wszystkich obciążeń, użyj flagi --includeRecommended.
--includeOptional Zawiera opcjonalne składniki dla wszystkich zainstalowanych obciążeń, w tym zalecanych składników. Opcjonalnie W przypadku określonego obciążenia:
--add Microsoft.VisualStudio.Workload. ManagedDesktop;includeOptional

Aby zastosować do wszystkich obciążeń: --includeOptional

Generowanie minimalnego układu

Ważne

W tych instrukcjach przyjęto założenie, że wcześniej utworzono układ instalacji sieciowej. Aby uzyskać więcej informacji o tym, jak to zrobić, zobacz stronę Tworzenie instalacji sieciowej programu Visual Studio .

Utwórz minimalny układ przy użyciu polecenia generate dla określonego zakresu wersji. Musisz również znać identyfikator produktu, języki i wszystkie wymagane obciążenia. Ten minimalny układ spowoduje zaktualizowanie dowolnej instancji Visual Studio z wersji podstawowej do wersji docelowej.

Przed utworzeniem układu możesz sprawdzić całkowity rozmiar pobierania i liczbę pakietów uwzględnionych za pomocą polecenia w wersji zapoznawczej . To polecenie przyjmuje te same opcje co polecenie generowania , a szczegóły są zapisywane w konsoli programu .

Zapoznajmy się z kilkoma przykładami sposobu wyświetlania podglądu, generowania i ponownego generowania minimalnego układu:

  • Najpierw poniżej przedstawiono przykład sposobu wyświetlania podglądu układu programu Visual Studio Enterprise w wersji 16.4.0 do 16.4.4 dla języka angielskiego.

    MinimalLayout.exe preview --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --languages en-US
    
  • Poniżej przedstawiono sposób generowania tego samego układu z jednym obciążeniem.

    MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeOptional --languages en-US
    
  • Poniżej przedstawiono sposób ponownego generowania minimalnego układu offline przy użyciu istniejącego pliku odpowiedzi.

    MinimalLayout.exe regenerate --filepath c:\VSLayout\MinimalLayout.json
    

Kilka innych przykładów przy użyciu polecenia generate :

  • Poniżej przedstawiono sposób dodawania dodatkowego obciążenia i dołączania tylko zalecanych pakietów.

    MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Professional --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.Workload.NetWeb;includeRecommended --languages en-US
    
  • Można również wygenerować minimalny układ offline, który obsługuje wiele produktów.

    MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise,Microsoft.VisualStudio.Product.Professional --baseVersion 16.4.0 --targetVersion 16.4.4 --languages en-US
    
  • I wreszcie oto, jak można uwzględnić wiele języków w minimalnym układzie.

    MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeOptional --languages en-US fr-FR
    

Jak zachować minimalny układ

Użyj polecenia weryfikacji i poprawy, aby zachować minimalny układ po jego utworzeniu. Polecenie verify określa, czy w minimalnym układzie nie ma żadnych uszkodzonych lub brakujących pakietów. Jeśli po uruchomieniu polecenia verify wystąpią jakiekolwiek problemy, użyj polecenia fix , aby rozwiązać te brakujące lub uszkodzone pakiety.

  • Poniżej przedstawiono sposób sprawdzania, czy układ ma uszkodzone lub brakujące pakiety:

    MinimalLayout.exe Verify --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --languages en-US
    
  • Oto jak naprawić ten układ:

    MinimalLayout.exe fix --targetLocation C:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeRecommended --languages en-US
    

Uwaga / Notatka

Nie można użyć tego układu do naprawy instalacji programu Visual Studio. Aby naprawić istniejące wystąpienie programu Visual Studio, zobacz Naprawianie programu Visual Studio.

Jak zaktualizować istniejącą instalację programu Visual Studio przy użyciu minimalnego układu offline

Po wygenerowaniu minimalnego układu można skopiować cały minimalny folder układu na maszynę kliencką. Jest to wymagane, jeśli komputer nie ma dostępu do folderu układu minimalnego w oryginalnej lokalizacji.

Przejdź do folderu i zidentyfikuj nazwę aplikacji bootstrapper. Nazwa programu rozruchowego zależy od wartości ProductId określonej podczas generowania układu minimalnego. Zapoznaj się z poniższą tabelą, aby zapoznać się z typowymi przykładami.

Wartość ProduktId Nazwa aplikacji
Microsoft.VisualStudio.Product.Enterprise vs_enterprise.exe
Microsoft.VisualStudio.Product.Professional vs_professional.exe
Microsoft.VisualStudio.Product.BuildTools vs_buildtools.exe

Aktualizacja dotyczy instancji programu Visual Studio w dwóch krokach. Zacznij od zaktualizowania Instalatora programu Visual Studio, a następnie zaktualizowania programu Visual Studio.

  1. Aktualizowanie instalatora programu Visual Studio

    Uruchom następujące polecenie, zastępując vs_enterprise.exe poprawną nazwą aplikacji bootstrappującej, jeśli to konieczne.

    vs_enterprise.exe --quiet --update --offline C:\VSLayout\vs_installer.opc
    
  2. Aktualizowanie aplikacji programu Visual Studio

    Aby zaktualizować program Visual Studio, należy określić ścieżkę instalacji wystąpienia programu Visual Studio, które chcesz zaktualizować. Jeśli zainstalowano wiele wystąpień programu Visual Studio, każdy z nich musi zostać zaktualizowany oddzielnie. Zdecydowanie zalecamy określenie opcji –noWeb przy użyciu polecenia aktualizacji, aby zapobiec instalacji składników, które nie są w minimalnym układzie. Uniemożliwia to pozostawienie programu Visual Studio w stanie bezużytecznym.

    Uruchom następujące polecenie, zastępując odpowiednio parametr wiersza polecenia installPath. Pamiętaj, aby również użyć poprawnej nazwy aplikacji startowej.

    vs_enterprise.exe update --noWeb --quiet --installpath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"
    
  1. Aktualizowanie instalatora programu Visual Studio

    Uruchom następujące polecenie, zastępując vs_enterprise.exe poprawną nazwą aplikacji bootstrappującej, jeśli to konieczne.

    vs_enterprise.exe --quiet --update --offline C:\VSLayout\vs_installer.opc
    
  2. Aktualizowanie aplikacji programu Visual Studio

    Aby zaktualizować program Visual Studio, należy określić ścieżkę instalacji wystąpienia programu Visual Studio, które chcesz zaktualizować. Jeśli zainstalowano wiele wystąpień programu Visual Studio, każdy z nich musi zostać zaktualizowany oddzielnie. Zdecydowanie zalecamy określenie opcji –noWeb przy użyciu polecenia aktualizacji, aby zapobiec instalacji składników, które nie są w minimalnym układzie. Uniemożliwia to pozostawienie programu Visual Studio w stanie bezużytecznym.

    Uruchom następujące polecenie, zastępując odpowiednio parametr wiersza polecenia installPath. Pamiętaj, aby również użyć poprawnej nazwy aplikacji startowej.

    vs_enterprise.exe update --noWeb --quiet --installpath "C:\Program Files\Microsoft Visual Studio\18\Enterprise"
    

Pomoc techniczna lub rozwiązywanie problemów

Czasami coś może pójść źle. Jeśli instalacja programu Visual Studio nie powiedzie się, zobacz Rozwiązywanie problemów z instalacją i uaktualnianiem programu Visual Studio, aby uzyskać szczegółowe wskazówki.

Oto kilka dodatkowych opcji pomocy technicznej:

  • Skorzystaj z opcji czatu instalacyjnego (tylko w języku angielskim) w razie problemów z instalacją.
  • Zgłoś problemy z produktem za pomocą narzędzia Zgłoś problem, które jest wyświetlane zarówno w Instalatorze programu Visual Studio, jak i w środowisku IDE programu Visual Studio. Jeśli jesteś administratorem IT i nie masz zainstalowanego programu Visual Studio, możesz przesłać opinię administratora IT.
  • Zasugeruj funkcję, śledź problemy z produktami i znajdź odpowiedzi w witrynie Visual Studio Developer Community.