Compartilhar via

Criando uma extensão

As extensões são escritas em C#. A maneira mais rápida de começar a escrever extensões é da própria Paleta de Comandos. Basta executar o comando "Criar uma nova extensão", preencher os campos para preencher o projeto de modelo e você deve estar pronto para começar.

Criar uma nova extensão

O formulário solicitará as seguintes informações:

  • ExtensionName: o nome da extensão. Isso será usado como o nome do projeto e o nome da classe que implementa seus comandos. Verifique se é um nome de classe C# válido - ele não deve ter espaços ou caracteres especiais e deve começar com uma letra maiúscula. Referência nos documentos como <ExtensionName>.
  • Nome de Exibição da extensão: o nome da sua extensão como aparecerá na Paleta de Comandos. Pode ser um nome mais legível para humanos.
  • Caminho de Saída: a pasta em que o projeto será criado.
    • O projeto será criado em um subdiretório do caminho que você forneceu.
    • Se esse caminho não existir, ele será criado para você.

A página

Depois de enviar o formulário, a Paleta de Comandos gerará automaticamente o projeto para você. Neste ponto, sua estrutura de projetos deve ser semelhante à seguinte:

<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

(com <ExtensionName> substituído pelo nome que você forneceu)

A partir daqui, você pode compilar imediatamente o projeto e executá-lo. Depois que o pacote for implantado e em execução, a Paleta de Comandos descobrirá automaticamente sua extensão e a carregará na paleta.

Dica

Certifique-se de implantar seu aplicativo! Apenas compilar seu aplicativo não atualizará o pacote da mesma forma que implantá-lo.

Aviso

A execução de "<ExtensionName> (Unpackaged)" do Visual Studio não implantará seu pacote de aplicativos.

Se estiver usando git o controle do código-fonte e usar o arquivo padrão .gitignore para C#, você desejará remover as duas linhas a seguir do arquivo .gitignore :

**/Properties/launchSettings.json
*.pubxml

Esses arquivos são usados pelo WinAppSdk para implantar seu aplicativo como um pacote. Sem ele, quem clonar seu repositório não poderá implantar sua extensão.

Você deve ser capaz de ver sua extensão na Paleta de Comandos no final da lista de comandos. A inserção desse comando deve levá-lo à página do seu comando e você deverá ver um único comando que diz TODO: Implement your extension here.

Uma captura de tela do modelo de extensão vazio, em execução na paleta de comandos

Parabéns! Você criou sua primeira extensão! Agora vamos em frente e realmente adicionar alguns comandos a ela.

Ao fazer alterações em sua extensão, você pode recompilar seu projeto e implantá-lo novamente. A Paleta de Comandos não detectará alterações nos pacotes que forem reexecutados no Visual Studio, portanto, você precisará executar manualmente o comando "Recarregar" para forçar a Paleta de Comandos a criar uma instância da sua extensão novamente.

Captura de tela do recarregamento

Avançar: Adicionar comandos à sua extensão

Conteúdo relacionado