Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este guia explica como adicionar recursos nativos de Windows a um aplicativo Electron usando a CLI de Desenvolvimento do aplicativo do Windows. Você aprenderá a chamar APIs de Windows modernas de seu aplicativo Electron, testar com a identidade do aplicativo e empacotar para distribuição.
O que você construirá
Ao final deste guia, você terá um aplicativo Electron que:
- ✅ Chama APIs de Windows modernas (Windows SDK e SDK do Aplicativo Windows)
- ✅ Usa um complemento nativo com funcionalidades de IA (Phi Silica ou WinML)
- ✅ É executado com a identidade do aplicativo para testar APIs protegidas
- ✅ Pacotes como um MSIX assinado para distribuição
Pré-requisitos
Antes de começar, verifique se você tem:
- Windows 11 (Pc Copilot+ se estiver usando Phi Silica)
-
Node.js -
winget install OpenJS.NodeJS --source winget -
.NET SDK v10 -
winget install Microsoft.DotNet.SDK.10 --source winget -
Visual Studio com a Carga de Trabalho para Aplicativos Desktop Nativos -
winget install --id Microsoft.VisualStudio.Community --source winget --override "--add Microsoft.VisualStudio.Workload.NativeDesktop --includeRecommended --passive --wait"
O processo
A criação de um aplicativo Electron habilitado para Windows envolve três fases principais:
1. Configurando o ambiente de desenvolvimento
Primeiro, você configurará seu ambiente de desenvolvimento com as ferramentas e os SDKs necessários. Isso inclui:
- Criando ou configurando um aplicativo Electron
- Instalando a CLI do winapp
- Inicializando Windows SDKs e ativos necessários
- Configurando o pipeline de build
2. Criando um complemento nativo
Em seguida, você criará um complemento nativo que chama APIs Windows. Escolha um dos seguintes guias:
Opção A: Criando um complemento de notificação do C++
Saiba como criar um complemento C++ que chama as APIs de notificação SDK do Aplicativo Windows. Este é um ótimo ponto de partida para entender os complementos nativos antes de se aprofundar em cenários mais complexos.
Criar um complemento de notificação do C++ →
Opção B: Criando um addon Phi Silica
Saiba como criar um complemento C# que usa o modelo de IA do Phi Silica para resumir o texto no dispositivo. O Phi Silica é um modelo de linguagem pequeno que é executado localmente em dispositivos Windows 11 com NPUs.
Criar um complemento Phi Silica →
Opção C: Criando um complemento WinML
Saiba como criar um complemento C# que usa Windows Machine Learning (WinML) para executar modelos ONNX personalizados para classificação de imagem, detecção de objetos e muito mais.
3. Empacotamento para Distribuição
Por fim, você empacotará seu aplicativo como um MSIX para distribuição. Isso inclui:
- Compilando seu aplicativo para produção
- Criando e assinando um pacote MSIX
- Testando o pacote instalado
- Noções básicas sobre as opções de distribuição
Navegação Rápida
| Phase | Guide | O que você vai aprender |
|---|---|---|
| 1️⃣ | Setup | Instalar ferramentas, inicializar SDKs, configurar o pipeline de build |
| 2️⃣ | Complemento de notificação do C++ | Criar complemento em C++, utilizar APIs de notificação, testar com identidade de depuração |
| 2️⃣ | Complemento Phi Silica | Criar complemento C#, chamar APIs de IA, testar com perfil de debug |
| 2️⃣ | Complemento WinML | Criar complemento C#, chamar APIs WinML, executar modelos ONNX, integrar ML |
| 3️⃣ | Embalagem | Criar aplicativo de produção, criar MSIX, distribuir |
Recursos adicionais
- Documentação da CLI do winapp – Referência completa da CLI
- Exemplo de aplicativo Electron – exemplo totalmente funcional
- Galeria de Desenvolvimento de IA – Galeria de exemplos de todas as APIs de IA
- SDK do Aplicativo Windows Samples - Coleção de amostras de SDK do Aplicativo Windows
- node-api-dotnet – biblioteca de interoperabilidade do JavaScript em C# ↔
Obter Ajuda
- Encontrou um bug?Registrar um problema
Windows developer