Creare la prima estensione Visual Studio

Questo documento è una guida introduttiva che illustra come creare la prima estensione usando VisualStudio.Extensibility. L'estensione viene eseguita fuori processo, ossia al di fuori del processo di Visual Studio.

Prerequisites

• Visual Studio 2022 versione 17.9 Preview 1 o successiva con carico di lavoro Visual Studio extension development.

Creare il progetto di estensione

• Usa il modello VisualStudio.Extensibility Project per creare un nuovo progetto di estensibilità.

A questo punto, si è pronti per iniziare a estendere Visual Studio aggiungendo comandi e componenti dell'editor all'estensione.

La classe Extension

Il modello crea una classe che estende Extension. Questa classe è la prima di cui viene creata un'istanza quando viene caricata la tua estensione. Nel metodo InitializeServices, è possibile aggiungere i propri servizi alla raccolta dei servizi per renderli disponibili per la dependency injection.

[VisualStudioContribution]
internal class ExtensionEntrypoint : Extension
{
    protected override void InitializeServices(IServiceCollection serviceCollection)
    {
        base.InitializeServices(serviceCollection);

        // You can configure dependency injection here by adding services to the serviceCollection.
    }
}

È anche possibile visualizzare l'attributo VisualStudioContribution usato per contrassegnare i componenti di estensione che devono essere utilizzati da Visual Studio. Questo attributo può essere applicato alle classi che implementano IVisualStudioContributionClass o proprietà statiche di un tipo che implementa IVisualStudioContributionProperty.

Aggiungere il primo comando

Il modello crea Command1.cs come primo gestore di comandi, che è possibile usare come punto di partenza. Poiché si vuole rendere Visual Studio consapevole di questo comando e la classe Command implementa IVisualStudioContributionClass, il comando viene contrassegnato con l'attributo VisualStudioContribution.

[VisualStudioContribution]
internal class Command1 : Command
{

Il comando ha una proprietà di configurazione denominata CommandConfiguration, che definisce il nome visualizzato, l'icona e la Extensions posizione nel menu.

    public override CommandConfiguration CommandConfiguration => new("%MyExtension.Command1.DisplayName%")
    {
        // Use this object initializer to set optional parameters for the command. The required parameter,
        // displayName, is set above. DisplayName is localized and references an entry in .vsextension\string-resources.json.
        Icon = new(ImageMoniker.KnownValues.Extension, IconSettings.IconAndText),
        Placements = new[] { CommandPlacement.KnownPlacements.ExtensionsMenu },
    };

Le proprietà di configurazione vengono valutate dal compilatore C# durante la compilazione dell'estensione e i relativi valori vengono salvati come metadati di estensione in modo che Visual Studio possa leggerlo senza caricare l'assembly di estensione. Per questo motivo, le proprietà di configurazione hanno restrizioni aggiuntive rispetto alle proprietà normali, ad esempio devono essere di sola lettura.

È possibile notare che il nome visualizzato del comando è "%MyExtension.Command1.DisplayName%", che fa riferimento alla MyExtension.Command1.DisplayName stringa nel .vsextension/string-resources.json file, consentendo la localizzazione di questa stringa.

Quando viene eseguito il comando, Visual Studio chiama il metodo ExecuteCommandAsync in cui è possibile posizionare un punto di interruzione. È possibile utilizzare l'argomento context o l'oggetto this.Extensibility per interagire con Visual Studio.

Ad esempio, un gestore di comandi può essere il seguente:

public override async Task ExecuteCommandAsync(IClientContext context, CancellationToken cancellationToken)
{
    await context.ShowPromptAsync(
        "Hello from an extension!", 
        PromptOptions.OK, 
        cancellationToken);
}

Per altre informazioni su come aggiungere comandi, vedere la sezione Comandi .

Eseguire il debug dell'estensione

1. Assicurarsi che il progetto di estensione sia selezionato come progetto di avvio in Visual Studio e premere F5 per avviare il debug.

2. Premendo F5 viene compilata l'estensione e distribuita nell'istanza sperimentale della versione di Visual Studio in uso. Il debugger dovrebbe collegarsi non appena la tua estensione viene caricata.

3. È possibile trovare il nuovo comando nel Extensions menu come illustrato nell'immagine seguente:

   

   

Passaggi successivi

Se non sono state visualizzate le panoramiche introduttive, vedere Introduzione alla documentazione di VisualStudio.Extensibility.

Creare ora un'estensione leggermente più interessante; vedere Creare una semplice estensione.