Aggiornamento e migrazione delle estensioni di Visual Studio

Questo articolo illustra l'aggiornamento di un'estensione esistente a Visual Studio 2026 e la migrazione dal Visual Studio SDK (VSSDK) al modello VisualStudio.Extensibility.

Non è necessario modificare i modelli di estendibilità solo per supportare una versione più recente di Visual Studio. Testa prima la compatibilità, quindi modernizza la compilazione o esegui la migrazione delle API in base alle esigenze.

Eseguire l'aggiornamento a Visual Studio 2026

Le estensioni di Visual Studio 2022 si installano e funzionano in Visual Studio 2026 con modifiche minime o nessuna modifica.

Installare e testare

  1. Installare Visual Studio 2026.
  2. Apri Estensioni> e trova la tua estensione.
  3. Testa l'estensione per verificare che tutte le funzionalità funzionino correttamente.

Modifiche radicali

Visual Studio 2026 presenta poche modifiche che causano incompatibilità:

Esperienze:

  • Rimozione del target di installazione IntegratedShell — aggiornamento a Microsoft.VisualStudio.Community.
  • Frequenza modificata dell'analisi delle estensioni SDK
  • Rimozione dei modelli di progetto VSIX in stile MPF
  • Rimozione del visualizzatore della libreria di immagini

API:

  • Rimozione di IGraphProvider API : usare IAttachedCollectionSourceProvider invece .
  • Rimozione delle API pubbliche in Microsoft.VisualStudio.Text.Internal.dll
  • Rimozione dell'estendibilità legacy di Quick Info sincrone — usare l'API async di Quick Info.
  • Rimozione delle API nuGet Visual Studio estendibilità inutilizzate

Se l'estensione ha come destinazione IntegratedShell, aggiorna il file manifest:

<InstallationTarget
  Id="Microsoft.VisualStudio.Community"
  Version="[17.0,)" />

Per l'elenco completo, vedere la pagina ↗ delle modifiche di rilievo in GitHub.

Modifiche al colore del tema

Visual Studio 2026 consolida i token di colore del tema, vedere Modernizzare i colori dei temi. La migrazione del tema non richiede un nuovo payload VSIX.

Eseguire la migrazione di un progetto VSIX all'SDK del progetto Visual Studio

Per modernizzare la configurazione di compilazione di un progetto VSSDK esistente senza modificarne l'ID di estensione o adottare un modello di estendibilità diverso, vedere Eseguire la migrazione di un progetto VSIX all'SDK del progetto Visual Studio.

Eseguire la migrazione da VSSDK a VisualStudio.Extensibility

Per iniziare, verificare se VisualStudio.Extensibility supporta le funzionalità dell'estensione. Vedere Scenari che richiedono VSSDK.

Se hai ancora bisogno delle API VSSDK, adottare VisualStudio.Extensibility in modo incrementale in un'estensione ibrida. Entrambi gli SDK vengono eseguiti nel processo di Visual Studio e possono contribuire alle funzionalità dello stesso VSIX. Seguire Aggiungi VisualStudio.Extensibility a un progetto di estensione VSSDK esistente per la configurazione e l'iniezione di servizi. Le chiamate VSSDK mantengono i requisiti di threading.

Quando tutte le funzionalità necessarie hanno equivalenti di VisualStudio.Extensibility, è possibile eseguire la migrazione completamente fuori processo per l'isolamento dei processi e il moderno .NET. Usare Crea la prima estensione per configurare il progetto di destinazione, convertire le funzionalità e testare il comportamento prima di sostituire l'estensione esistente.

Per le differenze di architettura e threading, vedere Confronto dettagliato dei modelli di estendibilità.

Contenuti correlati

  • Ultimo aggiornamento: