Introdução: adicionando APIs de Windows ao aplicativo Electron

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

Comece a Configuração →

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.

Criar um addon WinML →

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

Empacotar seu aplicativo →

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

Obter Ajuda