WindowsAppSDK Samples

Exemplos de SDK de aplicativos do Windows

Este repositório hospeda exemplos do SDK do aplicativo Windows. Amostras de vários recursos fornecidos no SDK do aplicativo Windows serão adicionadas a este repositório. Para obter mais informações sobre o Windows App SDK, visite a documentação do Windows App SDK. Para saber mais sobre o design do Windows App SDK ou para contribuir com o projeto, fazer propostas de recursos ou iniciar discussões, visite a página do GitHub do Windows App SDK.

Lista de amostras

Ciclo de vida do aplicativo e serviços do sistema

• Ciclo de vida do aplicativo: esses exemplos demonstram a instância do aplicativo usando as APIs AppLifecycle. Eles incluem os seguintes recursos:
  • Ativação: esses exemplos demonstram suporte para tipos de ativação ricos.
  • Instanciação: Esses exemplos demonstram suporte para instâncias múltiplas únicas e seletivas.
  • Notificações de energia: esses exemplos demonstram as notificações de estado de energia/sistema para gerenciar a carga de trabalho do aplicativo.
  • Reiniciar: estes exemplos demonstram a reinicialização síncrona de um aplicativo com argumentos de reinicialização de linha de comando.
  • Destino de compartilhamento: este exemplo demonstra um aplicativo que pode ser ativado como destino de compartilhamento.

Dados e arquivos

• Gerenciamento de recursos: estes exemplos demonstram o gerenciamento de recursos do aplicativo usando as APIs principais do MRT.

Implantação

• Gerenciador de implantação: este exemplo demonstra como inicializar e acessar informações de implantação para o tempo de execução do SDK do aplicativo Windows.
• Instalador: este exemplo demonstra como iniciar o instalador do SDK do aplicativo Windows sem uma janela de console.
• Não empacotado: esses exemplos demonstram a inicialização automática com o pacote Windows App SDK de um aplicativo não MSIX (não empacotado).

Dependências Dinâmicas

• DirectX: este exemplo demonstra como usar a API de Dependências Dinâmicas para carregar dinamicamente o pacote de estrutura DirectX Runtime MSIX.

Gráficos

• Renderização de texto: este exemplo é uma galeria das APIs DWriteCore que demonstram a renderização de texto.

Notificações

• Notificações push: este é um aplicativo de exemplo que apresenta notificações push.
• Notificações de aplicativos: este é um aplicativo de exemplo que mostra notificações de aplicativos.

Componentes de tempo de execução

• Controles personalizados: este exemplo mostra como criar um componente do Windows Runtime em C# com controles WinUI personalizados.

Interface do usuário e entrada

• Janelas: este exemplo demonstra como gerenciar janelas de aplicativos usando as APIs de janelas.
• Galeria de entrada e composição do Windows: esta coleção de exemplos apresenta APIs Microsoft.UI.Composition e Microsoft.UI.Input.
• Galeria WinUI 3: Este é um aplicativo de exemplo que mostra todos os controles do WinUI 3 em ação.

Requisitos

Os exemplos do SDK do aplicativo Windows têm os seguintes requisitos de sistema:

• Windows 10, versão 1809 (compilação 17763) ou posterior.

• Visual Studio 2022 ou Visual Studio 2019 versão 16.9 ou posterior, com as seguintes cargas de trabalho e componentes:

  • Desenvolvimento da Plataforma Universal do Windows
  • Desenvolvimento de desktop .NET (necessário mesmo se você estiver criando apenas aplicativos C++ Win32)
  • Desenvolvimento de desktop com C++ (necessário mesmo se você estiver criando apenas aplicativos .NET)
  • Windows SDK versão 2004 (compilação 19041) ou posterior. Isso é instalado com o Visual Studio por padrão.

• A criação de exemplos do .NET C# com o Windows App SDK 1.1 também requer uma das seguintes versões do .NET SDK ou posterior:

  • 6.0.202
  • 6.0.104
  • 5.0.407
  • 5.0.213

Consulte a documentação sobre requisitos de sistema e ferramentas para desenvolvimento de aplicativos do Windows para obter uma lista detalhada de requisitos para desenvolver aplicativos com o SDK de aplicativos do Windows.

Usando as amostras

Para usar os exemplos com o Git, clone o repositório WindowsAppSDK-Samples executando git clone https://github.com/microsoft/WindowsAppSDK-Samples.git em um prompt de comando. Em seguida, você pode navegar até o diretório de um exemplo e abrir o arquivo de solução no Visual Studio.

A maneira mais fácil de usar esses exemplos sem Git é baixar o arquivo ZIP. Selecione Baixar ZIP no menu suspenso de download, descompacte todo o arquivo e abra os exemplos no Visual Studio.

Controle de versão de amostras

Os exemplos serão atualizados com versões GA do SDK do aplicativo Windows. O ramo main inclui os exemplos mais recentes, que também podem incluir recursos experimentais ou de visualização. As ramificações de lançamento específicas são denominadas release/xy e contêm exemplos que fazem referência à versão GA correspondente do Windows App SDK. Este repositório atualmente inclui os seguintes ramos de lançamento:

• lançamento/1.0
• lançamento/0,8
• liberação/0,5

Contribuindo

Esses exemplos são fornecidos pelas equipes de recursos e agradecemos sua opinião sobre problemas e sugestões para novos exemplos. Incentivamos você a registrar um novo problema para qualquer feedback ou perguntas!

Os autores de amostras devem seguir as diretrizes de amostras para começar a desenvolver suas amostras. Para exemplos de SDK de aplicativo do Windows baseados em WinUI, use os modelos de exemplo. O arquivo VSIX está disponível para download na página de lançamentos do Github aqui.

Este projeto adotou o Código de Conduta de Código Aberto da Microsoft. Para obter mais informações, consulte as Perguntas frequentes sobre o Código de Conduta ou entre em contato com [email protected] com perguntas ou comentários adicionais.

Depois que um novo aplicativo de exemplo for adicionado, os desenvolvedores da Microsoft deverão considerar a atualização do pipeline interno do Aggregator para:

• Ative a criação do novo aplicativo de exemplo regularmente.
• Adicione um novo caso de teste ao driver de teste SampleTests TAEF existente para verificar regularmente a inicialização bem-sucedida do aplicativo de exemplo em relação à versão mais recente do SDK do aplicativo Windows.

Consulte a documentação no repositório interno do Aggregator para obter instruções, nos estágios BuildSampleApps e TestSampleApps.