Začínáme: Přidání rozhraní API Windows do aplikace Elektron

Tato příručka vás provede přidáním Windows nativních funkcí do aplikace Electron pomocí rozhraní příkazového řádku aplikace pro Windows Development CLI. Naučíte se volat moderní rozhraní API Windows z aplikace Electron, testovat s identitou aplikace a připravit balíček pro distribuci.

Co budete vytvářet

Na konci tohoto průvodce budete mít aplikaci Elektron, která:

  • ✅ používá moderní rozhraní API Windows (Windows SDK a Windows App SDK).
  • ✅Používá funkce Windows AI z JavaScriptu (Phi Silica nebo WinML).
  • ✅ Volitelně používá nativní doplněk, pokud rozhraní API potřebuje nativní kód.
  • ✅ Spouští se s identitou aplikace pro testování chráněných rozhraní API.
  • ✅ Balíčky jako podepsaný MSIX pro distribuci

Předpoklady

Než začnete, ujistěte se, že máte:

  • Windows 11 (Pc Copilot+ při použití Phi Silica)
  • Node.js - winget install OpenJS.NodeJS --source winget
  • .NET SDK v10 - winget install Microsoft.DotNet.SDK.10 --source winget
  • Visual Studio s nativní desktopovou pracovní zátěží - winget install --id Microsoft.VisualStudio.Community --source winget --override "--add Microsoft.VisualStudio.Workload.NativeDesktop --includeRecommended --passive --wait"

Proces

Podle těchto příruček nastavte aplikaci Electron, zavolejte moderní Windows rozhraní API a zabalte ji pro distribuci:

1. Nastavení vývojového prostředí

Nejprve nastavíte vývojové prostředí s potřebnými nástroji a sadami SDK. Sem patří:

  • Vytvoření nebo konfigurace aplikace Elektron
  • Instalace rozhraní příkazového řádku winapp
  • Inicializace sad SDK Windows a požadovaných prostředků
  • Nastavení procesu sestavení

Začínáme s nastavením →

2. Volání rozhraní API Windows z JavaScriptu

Pokud jste během instalace povolili vazby JS, .winapp/bindings/ obsahuje generované .js třídy obálky a odpovídající .d.ts deklarace pro Windows App SDK rozhraní API. Import #winapp/bindings pro přístup ke všem exportovaným třídám. Import balíčku #winapp/bindings vyžaduje @microsoft/dynwinrt-codegen ≥ 0.1.0-preview.8; starší projekty mohou zachovat cestu relativní k importujícímu souboru (například require('../.winapp/bindings/index.js') z src/index.js) nebo provést upgrade pomocí npm i -D @microsoft/dynwinrt-codegen@latest && npx winapp init --add-js-bindings.

3. Volitelné: Vytvoření nativního doplňku

Tento krok přeskočte, pokud generované vazby JS pokrývají Windows App SDK rozhraní API, které potřebujete. Nativní doplněk vytvořte pouze v případě, že potřebujete nativní hranici, jako je Win32, pure COM, nativní knihovny C/C++ nebo spravovaná sestavení .NET.

Možnost A: Vytvoření doplňku pro oznámení jazyka C++

Zjistěte, jak vytvořit doplněk jazyka C++, který volá rozhraní API pro oznámení Windows App SDK. Toto je skvělý výchozí bod pro pochopení nativních doplňků před tím, než se ponoříte do složitějších scénářů.

Vytvořit C++ doplněk oznámení →

Možnost B: Vytvoření doplňku Phi Silica

Zjistěte, jak vytvořit doplněk jazyka C#, který používá model Phi Silica AI ke shrnutí textu na zařízení. Phi Silica je malý jazykový model, který běží místně na Windows 11 zařízeních s NPU.

Vytvořte doplněk Phi Silica →

Možnost C: Vytvoření doplňku WinML

Zjistěte, jak vytvořit doplněk jazyka C#, který používá Windows Machine Learning (WinML) ke spouštění vlastních modelů ONNX pro klasifikaci obrázků, detekci objektů a další.

Vytvoření doplňku WinML →

4. Balení pro distribuci

Nakonec aplikaci zabalíte jako MSIX pro distribuci. Sem patří:

  • Sestavení aplikace pro produkční prostředí
  • Vytvoření a podepsání balíčku MSIX
  • Testování nainstalovaného balíčku
  • Porozumění možnostem distribuce

Zabalte svou aplikaci

Rychlá navigace

Fáze Guide Co se naučíte
1️⃣ Setup Instalace nástrojů, inicializace sad SDK, konfigurace kanálu buildu
2️⃣ JavaScriptové vazby pro oznámení Zobrazení oznámení Windows App SDK přímo z JavaScriptu
2️⃣ JS vazby pro rozhraní API systému Windows Volání rozhraní API Windows App SDK a následné rozšíření vazeb na rozhraní API sady Windows SDK
2️⃣ JavaScriptové rozhraní Phi Silica Volání místního jazykového modelu přímo z JavaScriptu
2️⃣ Rozhraní WinML pro JS Registrace zprostředkovatelů spouštění WinML a spuštění modulu RUNTIME ONNX z JavaScriptu
3️⃣ Doplněk pro oznámení jazyka C++ Vytvořit doplněk C++, volání API notifikací, otestujte pomocí identity pro ladění
3️⃣ Phi Silica Addon Vytvoření alternativního doplňku jazyka C# pro rozhraní API AI
3️⃣ Doplněk WinML Vytvoření alternativního doplňku jazyka C# pro WinML
4️⃣ Balení Sestavení produkční aplikace, vytvoření MSIX, distribuce

Další zdroje

Získání nápovědy

  • Last updated on