Telepítési konfigurációk importálása vagy exportálása

A telepítési konfigurációs fájlok használatával konfigurálhatja, hogy mit telepít a Visual Studio. Ehhez exportálja a számítási feladatokat, összetevőket és Marketplace-bővítményadatokat egy .vsconfig fájlba a Visual Studio Installer használatával. Ha már rendelkezik .vsconfig fájllal, manuálisan tovább finomíthatja, és további elemeket vehet fel vagy távolíthat el. A .vsconfig fájl struktúráját és szintaxisát a vsconfig fájlformátum szakasz ismerteti.

Importálhatja a konfigurációs fájlt egy új vagy meglévő Visual Studio-telepítésbe, létrehozhat vagy módosíthat egy elrendezést vagy egy offline telepítést, elhelyezheti egy megoldáskönyvtárban vagy adattárban, és elindíthatja a hiányzó összetevők telepítését, és megoszthatja másokkal.

Konfiguráció exportálása a Visual Studio Installer használatával

A telepítési konfigurációs fájlt exportálhatja a Visual Studio egy korábban telepített példányából.

Jegyzet

A Visual Studio 2022 17.10 előzetes verziójától kezdve exportálhatja Visual Studio Marketplace-bővítményeket, amelyeket egy példányszintű környezetben töltöttek be egy .vsconfig fájlba. Ha azt szeretné, hogy a export funkció más típusú bővítményeket is exportálhasson, például a hálózati megosztásokból vagy a felhasználói környezetbe betöltött bővítményeket, kérjük, tudassa velünk.

A Visual Studio Installer felhasználói felületének használata

  1. A Start menüben nyissa meg a Visual Studio Installert.

  2. A termékkártyán válassza a További gombot, majd jelölje ki a Konfiguráció exportálásaparancsot.

    A Visual Studio telepítőjének termékkártyájáról való exportálási konfiguráció képernyőképe.

  3. Keresse meg vagy írja be azt a helyet, ahová menteni szeretné a .vsconfig fájlt, majd válassza a Részletek áttekintéselehetőséget.

    Képernyőkép a telepítési konfiguráció exportálási hely mezőjéről.

  4. Ellenőrizze, hogy a beállítások pontosak-e, majd válassza az Exportáláslehetőséget.

Konfigurációs fájl programozott exportálása

Egy adott Visual Studio-példány konfigurációs fájlját programozott módon exportálhatja a export paranccsel. További információ: A Visual Studiotelepítése, frissítése és kezelése parancssori paraméterekkel.

Konfiguráció importálása a Visual Studio Installer használatával

Importálhat egy telepítési konfigurációs fájlt a Visual Studio egy korábban telepített példányába, vagy inicializálhatja a Visual Studio új telepítését. Ha egy konfigurációs fájlt importál a Visual Studióba, a konfigurációs fájlban szereplő minden olyan elemet telepít, amely még nincs telepítve.

A .vsconfig fájl alkalmazásának módjától függ, hogy a Visual Studio már telepítve van-e:

  • Ha a Visual Studio még nincs telepítve, használja a kiadás rendszerbetöltőjét (például vs_professional.exe) a(z) --config kapcsolóval.
  • Ha Visual Studio már telepítve van, használja modify a következővel --config : (példáulsetup.exe modify).

A Visual Studio Installer felhasználói felületének használata

Ha készen áll egy telepítési konfigurációs fájl importálására, kövesse az alábbi lépéseket.

  1. Nyissa meg a Visual Studio Installert, és zárja be a Visual Studiót. A legtöbb telepítőművelethez magának a Visual Studio-terméknek a bezárására van szükség.

  2. A Telepített fülön vagy az Elérhető fülön válassza a További beállítások>Importálási konfiguráció opciót a Visual Studio termékkártyán.

  3. Keresse meg az importálni kívánt .vsconfig fájlt, majd válassza a Részletek áttekintéselehetőséget.

  4. Ellenőrizze, hogy a beállítások pontosak-e, majd válassza a módosítása lehetőséget.

Konfigurációs fájl programozott használata új telepítés esetén

Ha .vsconfig fájlt szeretne használni az első telepítés során, töltse le a megfelelő bootstrappert, amely megfelel a kívánt verziónak és kiadásnak (példáulvs_professional.exe). Ezután nyisson meg egy rendszergazdai parancssort, és futtassa a bootstrappert a --config paraméterrel.

vs_professional.exe --config "C:\myconfig.vsconfig" --passive --wait

Ha explicit módon szeretné beállítani a telepítési helyet, adja meg a következőket --installPath: .

vs_professional.exe --installPath "C:\Program Files\Microsoft Visual Studio\18\Professional" --config "C:\myconfig.vsconfig" --passive --wait

vs_professional.exe --installPath "C:\Program Files\Microsoft Visual Studio\2022\Professional" --config "C:\myconfig.vsconfig" --passive --wait

Important

Első telepítéskor a kiadás bootstrapperét használja (vs_professional.exe, vs_enterprise.exe és így tovább), ne a setup.exe modify-t.

Ha a .vsconfig fájl bővítményeket tartalmaz, és --passive vagy --quiet módban fut, adja meg a(z) --allowUnsignedExtensions elemet.

Programozott módon konfigurációs fájl használatával adhat hozzá összetevőket egy meglévő telepítéshez

A paraméterrel --configmodify összetevőket adhat hozzá egy meglévő telepítéshez. Az alábbi példa az ügyfélszámítógépen futó telepítő program használatával módosít egy meglévő telepítést.

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\Program Files\Microsoft Visual Studio\18\Professional" --config "C:\myconfig.vsconfig" --passive --allowUnsignedExtensions

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\Program Files\Microsoft Visual Studio\2022\Professional" --config "C:\myconfig.vsconfig" --passive --allowUnsignedExtensions

Jegyzet

Ha összetevőket szeretne hozzáadni egy meglévő telepítéshez egy .vsconfig fájl használatával, modify kell használnia, és nemupdate. A update parancs csak frissíti a meglévő telepített összetevőket a legújabb verzióra. A különböző telepítőműveletekkel kapcsolatos további információkért tekintse meg a Visual Studio parancssori telepítésének dokumentációját.

Elrendezés tartalmának inicializálása konfigurációs fájl használatával

A Visual Studio kívánt verziójának és kiadásának megfelelő bootstrapper használatával nyisson meg egy rendszergazdai parancssort, és futtassa a következő parancsot az elrendezés tartalmának konfigurálásához a --config paraméterrel. Az elrendezések inicializálásához és telepítéséhez .vsconfig fájlok használatával kapcsolatos további információkért lásd: Elrendezésitartalmának inicializálása konfigurációs fájl használatával.

vs_enterprise.exe --layout "c:\localVSlayout" --config "c:\myconfig.vsconfig" --lang en-US

Hiányzó összetevők automatikus telepítése konfigurációs fájl használatával

Ha egy .vsconfig fájlt ment a megoldás gyökérkönyvtárába, majd megnyit egy megoldást, a Visual Studio automatikusan észleli a hiányzó összetevőket, és kéri a telepítésüket.

Jegyzet

Ha a .vsconfig fájl bővítményeket tartalmaz, akkor jelenleg csak a Visual Studio Marketplace által üzemeltetett bővítmények aktiválják az automatikus hiányzik észlelés és telepítés. Ha azt szeretné, hogy ez a logika olyan bővítményeket tartalmazzon, amelyeket nem Marketplace-ről telepítettek, kérjük, adja meg a forgatókönyv részleteit itt.

A Megoldáskezelő képernyőképe, amely további összetevőket javasol.

A Megoldáskezelő képernyőképe, amely további összetevőket javasol.

Létrehoztunk egy nyílt forráskódú segédprogramot is, amely megkeresi a Visual Studio telepítési konfigurációját .vsconfig fájlokat rekurzív módon, és egyesíti őket. A segédprogrammal kapcsolatos további információkért tekintse meg VSConfigFindert a GitHubon.

vsconfig fájlformátum

A .vsconfig fájl egy olyan json fájlformátum, amely tartalmaz egy összetevőszakaszt és opcionálisan egy bővítményszakaszt. Az összetevők szakasza számítási feladatokat és összetevőket tartalmaz, és a következőképpen néz ki:

{
  "version": "1.0", 
  "components": [ 
    "Microsoft.VisualStudio.Component.CoreEditor", 
    "Microsoft.VisualStudio.Workload.CoreEditor", 
    "Microsoft.VisualStudio.Component.NuGet" 
    ] 
}

Kiterjesztések

A Visual Studio 2022 17.9-es verziójának -től kezdve a .vsconfig fájlban adhat meg bővítményeket, és a Visual Studio Installer használatával egész gépre betöltheti őket, így azok minden felhasználó számára elérhetővé válnak. A Visual Studio 2022 17.10 előzetes verziójától kezdve a Visual Studio Installer használatával a Visual Studio Marketplace bővítményeket a példányszintű környezetben betöltött export fájlba helyezheti, ahogyan azt korábban ismertettük.

A konfigurációs fájlban van néhány ismert kikötés, amelyek támogatják a bővítményeket.

  • Mivel a konfigurációs fájlon keresztül betöltött bővítmények példányszintűen vannak telepítve, rendszergazdai engedélyekkel kell rendelkeznie a telepítésükhöz, vagy rendelkeznie kell a AllowStandardUserControl házirend által biztosított telepítői jogosultsággal. A Visual Studio Extension Manager által korábban telepített bővítmények felhasználónként (és általában) nem példányonként voltak telepítve, és a felhasználónak nem kellett rendszergazdai engedélyekkel rendelkeznie a telepítéshez.
  • A Visual Studio Installer jelenleg csak bizonyos típusú bővítmények importálását támogatja, például a *.vsix csomagban lévőket, vagy azokat, amelyek nem túl bonyolult. Ha olyan bővítménye van, amely nem megfelelően töltődik be konfigurációs fájlon keresztül, küldjön róla egy új fejlesztői közösségi javaslatot.
  • Csak a Visual Studio Marketplace-en üzemeltetett bővítmények aktiválják az automatikus hiányzó észlelést és telepítést, ha a .vsconfig fájl egy megoldáskönyvtárban található. Ha azt szeretné, hogy ez a logika olyan bővítményeket tartalmazzon, amelyeket nem Marketplace-ről telepítettek, itt adja meg a forgatókönyv részleteit.
  • Ha programozott módon használ egy .vsconfig fájlt bővítmények hozzáadásához, akkor a --allowUnsignedExtensions paraméterrel is engedélyeznie kell nem aláírt bővítmények betöltését --passive vagy --quiet környezetben. Ha elrendezésből telepít, hozzáadhatja a "allowUnsignedExtensions" : true szintaxist a response.json fájlhoz a hasonló hatás eléréséhez.

Az összes példányra kiterjedő bővítmény automatikusan körülbelül naponta egyszer frissül egy ütemezett feladat révén. További információ: Automatikus bővítményfrissítések.

A bővítményeket tartalmazó .vsconfig fájlformátumnak így kell kinéznie.

{
  "version": "1.0", 
  "components": [ 
    // Whatever components you want to install come here, in quotes, separated by commas.
    // You can use the installer to select the components you want to install and then export them,
    // Or you can specify the ones you want according to the [component-id's](https://learn.microsoft.com/en-us/visualstudio/install/workload-and-component-ids).
    // This array should not be null! If you don't want to install any component, just leave the array empty.
  ],
  "extensions": [
    // The extensions you want to install are specified in this section, in quotes, separated by commas.
    // Extensions are optional in .vsconfig, so if you don't want any, you can delete the entire extensions section.
    // The extensions must be in a *.vsix package
    // Make sure that the extensions you specify are designed to work with that version of Visual Studio.
    // examples below
    "https://marketplace.visualstudio.com/items?itemName=MadsKristensen.ImageOptimizer64bit",   //unsigned extension
    "https://marketplace.visualstudio.com/items?itemName=vsext.RegexMatchVisualizer",  //signed extension
    "c:\\mylocaldrive\\someextension.vsix",
    "\\\\server\\share\\myextension.vsix",
    "https://myweb/anotherextension.vsix"
  ]
}

Támogatás vagy hibaelhárítás

Néha a dolgok elromlhatnak. Ha a Visual Studio telepítése sikertelen, lásd a részletes útmutatást A Visual Studio telepítési és frissítési problémáinak elhárítása című részben lépésről lépésre.

Íme néhány további támogatási lehetőség:

  • A telepítéssel kapcsolatos problémák esetén használja a telepítési csevegési (csak angol nyelvű) támogatási lehetőséget.
  • Termékproblémák bejelentése a Probléma eszközzel, amely a Visual Studio Installerben és a Visual Studio IDE-ben is megjelenik. Ha Ön informatikai rendszergazda, és nincs telepítve a Visual Studio, elküldheti rendszergazdai visszajelzést.
  • Javasoljon egy funkciót, kövesse nyomon a termékekkel kapcsolatos problémákat, és keressen választ a Visual Studio fejlesztői közösségében.

Kapcsolódó tartalom

  • Last updated on