Começar: Adicionar APIs do Windows à sua aplicação Electron

Este guia guia-o sobre como adicionar funcionalidades nativas do Windows a uma aplicação Electron usando a linha de comando do Aplicação do Windows Development. Vai aprender a chamar APIs modernas do Windows a partir da sua aplicação Electron, testar com a identidade da aplicação e o pacote para distribuição.

O que você vai construir

Ao final deste guia, terá uma aplicação Electron que:

  • ✅ Chamadas de APIs modernas do Windows (Windows SDK e SDK de Aplicações Windows)
  • ✅ Usa um addon nativo com capacidades de IA (Phi Silica ou WinML)
  • ✅ Executa com identidade de aplicação para testar APIs protegidas
  • ✅ Pacotes como MSIX assinados para distribuição

Pré-requisitos

Antes de começar, certifique-se de:

  • Windows 11 (Copilot+ PC se estiver a usar 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 Nativa para Desktop - winget install --id Microsoft.VisualStudio.Community --source winget --override "--add Microsoft.VisualStudio.Workload.NativeDesktop --includeRecommended --passive --wait"

O Processo

Construir uma aplicação Electron compatível com Windows envolve três fases principais:

1. Criação do Ambiente de Desenvolvimento

Primeiro, vais configurar o teu ambiente de desenvolvimento com as ferramentas e SDKs necessários. Isto inclui:

  • Criação ou configuração de uma aplicação Electron
  • Instalação da linha de comando winapp
  • Inicialização de SDKs do Windows e recursos necessários
  • Configurar o seu pipeline de build

Comece com a configuração →

2. Criação de um Addon Nativo

De seguida, vais criar um addon nativo que chama APIs do Windows. Escolha um dos seguintes guias:

Opção A: Criação de um Addon de Notificação em C++

Aprenda a criar um addon em C++ que chame as APIs de notificação do SDK de Aplicações Windows. Este é um ótimo ponto de partida para perceber addons nativos antes de entrar em cenários mais complexos.

Criar um addon de notificação em C++ →

Opção B: Criar um Addon Phi Silica

Aprenda a criar um addon C# que utilize o modelo de IA Phi Silica para resumir texto no dispositivo. Phi Silica é um pequeno modelo de linguagem que corre localmente em dispositivos Windows 11 com NPUs.

Cria um addon Phi Silica →

Opção C: Criar um Addon WinML

Aprenda a criar um addon C# que use Windows Machine Learning (WinML) para executar modelos ONNX personalizados para classificação de imagens, deteção de objetos e muito mais.

Criar um Addon WinML →

3. Embalagem para Distribuição

Por fim, irá embalar a sua aplicação como um MSIX para distribuição. Isto inclui:

  • Preparar a aplicação para produção
  • Criação e assinatura de um pacote MSIX
  • Testar o pacote instalado
  • Compreender as opções de distribuição

Empacote a sua aplicação →

Navegação Rápida

Fase Guide O que você vai aprender
1️⃣ Configuração Instalar ferramentas, inicializar SDKs, configurar o pipeline de construção
2️⃣ Addon de Notificação C++ Criar addon C++, chamar APIs de notificação, testar com identidade de depuração
2️⃣ Phi Silica Addon Criar complemento C#, chamar APIs de IA, testar com identidade de depuração
2️⃣ WinML Addon Criar addon C#, chamar APIs WinML, correr modelos ONNX, integrar ML
3️⃣ Embalagem Construir uma aplicação de produção, criar MSIX, distribuir

Recursos adicionais

Obter Ajuda