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)
  • ✅Utiliza capacidades de IA do Windows a partir de JavaScript (Phi Silica ou WinML)
  • ✅ Opcionalmente, usa um addon nativo quando uma API precisa de código nativo
  • ✅ 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

Siga estes guias para configurar a sua aplicação Electron, chamar APIs modernas do Windows e empacotá-la para distribuição:

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. Chamar APIs do Windows a partir do JavaScript

Se ativou as associações JS durante a configuração, .winapp/bindings/ contém classes de invólucro geradas .js e declarações correspondentes .d.ts para as APIs do SDK de Aplicações Windows. Importar #winapp/bindings para aceder a todas as classes exportadas. A importação de pacotes #winapp/bindings requer @microsoft/dynwinrt-codegen ≥ 0.1.0-preview.8; os projetos mais antigos podem manter um caminho relativo ao ficheiro que importa (por exemplo, require('../.winapp/bindings/index.js') a partir de src/index.js) ou atualizar com npm i -D @microsoft/dynwinrt-codegen@latest && npx winapp init --add-js-bindings.

3. Opcional: Criar um Addon Nativo

Ignora este passo se as ligações JS geradas cobrirem a API do SDK de Aplicações Windows de que precisas. Crie uma extensão nativa apenas quando precisar de uma interface nativa, como Win32, COM puro, bibliotecas nativas de C/C++ ou assemblies .NET geridas.

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 →

4. 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️⃣ Ligações JS de notificação Mostrar uma notificação do SDK de Aplicações Windows diretamente do JavaScript
2️⃣ Associações JS para APIs do Windows Chamar uma API do SDK de Aplicações Windows e, em seguida, estender as associações às APIs do Windows SDK
2️⃣ Bindings JS de Phi Silica Chame o modelo de linguagem local diretamente a partir do JavaScript
2️⃣ Ligações JS do WinML Registar fornecedores de execução WinML e executar o ONNX Runtime a partir de JavaScript
3️⃣ Addon de Notificação C++ Criar addon C++, chamar APIs de notificação, testar com identidade de depuração
3️⃣ Phi Silica Addon Criar um addon alternativo de C# para APIs de IA
3️⃣ WinML Addon Crie uma alternativa de addon C# para o WinML
4️⃣ Embalagem Construir uma aplicação de produção, criar MSIX, distribuir

Recursos adicionais

Obter Ajuda

  • Last updated on