Condividi tramite

Creazione di un'estensione

Le estensioni vengono scritte in C#. Il modo più rapido per iniziare a scrivere estensioni è dal riquadro comandi stesso. È sufficiente eseguire il comando "Crea una nuova estensione", compilare i campi per popolare il progetto modello e si dovrebbe essere pronti per iniziare.

Creazione di una nuova estensione

Il modulo richiederà le informazioni seguenti:

  • ExtensionName: nome dell'estensione. Verrà usato come nome del progetto e come nome della classe che implementa i comandi. Assicurarsi che si tratti di un nome di classe C# valido, che non deve contenere spazi o caratteri speciali e che inizi con una lettera maiuscola. Riferimento nella documentazione come <ExtensionName>.
  • Nome visualizzato dell'estensione: Il nome della tua estensione come apparirà nella Palette dei comandi. Può trattarsi di un nome più leggibile.
  • Percorso di output: cartella in cui verrà creato il progetto.
    • Il progetto verrà creato in una sottodirectory del percorso specificato.
    • Se questo percorso non esiste, verrà creato automaticamente.

Pagina

Dopo aver inviato il modulo, il riquadro comandi genererà automaticamente il progetto. A questo punto, la struttura dei progetti dovrebbe essere simile alla seguente:

<ExtensionName>/
│   Directory.Build.props
│   Directory.Packages.props
│   nuget.config
│   <ExtensionName>.sln
└───<ExtensionName>
    │   app.manifest
    │   Package.appxmanifest
    │   Program.cs
    │   <ExtensionName>.cs
    │   <ExtensionName>.csproj
    │   <ExtensionName>CommandsProvider.cs
    ├───Assets
    │   <A bunch of placeholder images>
    ├───Pages
    │   <ExtensionName>Page.cs
    └───Properties
        │   launchSettings.json
        └───PublishProfiles
                win-arm64.pubxml
                win-x64.pubxml

(sostituendo il nome specificato con <ExtensionName>)

Da qui è possibile compilare immediatamente il progetto ed eseguirlo. Dopo la distribuzione e l'esecuzione del pacchetto, il riquadro comandi rileverà automaticamente l'estensione e la caricherà nel riquadro.

Suggerimento

Assicurarsi di distribuire l'app. La compilazionedell'applicazione non aggiornerà il pacchetto nello stesso modo in cui verrà distribuito.

Avvertimento

L'esecuzione di "<ExtensionName> (Unpackaged)" da Visual Studio non distribuirà il pacchetto dell'app.

Se si usa git per il controllo del codice sorgente e si usa il file standard .gitignore per C#, è necessario rimuovere le due righe seguenti dal .gitignore file:

**/Properties/launchSettings.json
*.pubxml

Questi file vengono usati da WinAppSdk per distribuire l'app come pacchetto. Senza di esso, chiunque cloni il repository non sarà in grado di distribuire l'estensione.

Dovrebbe essere possibile visualizzare l'estensione nel riquadro comandi alla fine dell'elenco dei comandi. L'immissione di tale comando dovrebbe passare alla pagina del comando e dovrebbe essere visualizzato un singolo comando che indica TODO: Implement your extension here.

Uno screenshot del modello di estensione vuoto, eseguito nella palette dei comandi

L'esercizio è terminato. Hai fatto la tua prima estensione! A questo punto è possibile procedere e aggiungervi alcuni comandi.

Quando si apportano modifiche all'estensione, è possibile ricompilare il progetto e distribuirlo di nuovo. La Palette dei comandi non noterà modifiche ai pacchetti che vengono rieseguiti tramite Visual Studio, quindi dovrai eseguire manualmente il comando "Ricarica" per forzare la ri-inizializzazione della tua estensione nella Palette dei comandi.

Screenshot del ricaricamento

Successivamente: Aggiungere comandi all'estensione

Contenuti correlati