Wprowadzenie: dodawanie interfejsów API Windows do aplikacji Electron

Ten przewodnik przeprowadzi Cię przez proces dodawania Windows natywnych funkcji do aplikacji Electron przy użyciu interfejsu wiersza polecenia tworzenia aplikacja dla systemu Windows. Dowiesz się, jak wywoływać nowoczesne interfejsy API Windows z aplikacji Electron, testować przy użyciu tożsamości aplikacji i pakować do dystrybucji.

Co będziesz budować

Na końcu tego przewodnika będziesz mieć aplikację Electron, która:

  • ✅ wywołuje nowoczesne interfejsy API systemu Windows (zestaw SDK Windows i Zestaw SDK do aplikacji systemu Windows)
  • ✅Używa Windows możliwości sztucznej inteligencji z języka JavaScript (Phi Silica lub WinML)
  • ✅ Opcjonalnie używa natywnego dodatku, gdy interfejs API wymaga kodu natywnego
  • ✅ Działa z tożsamością aplikacji na potrzeby testowania chronionych interfejsów API
  • ✅ Pakiety jako podpisany plik MSIX do dystrybucji

Wymagania wstępne

Przed rozpoczęciem upewnij się, że masz:

  • Windows 11 (Copilot+ PC w przypadku korzystania z Phi Silica)
  • Node.js - winget install OpenJS.NodeJS --source winget
  • .NET SDK w wersji 10 - winget install Microsoft.DotNet.SDK.10 --source winget
  • Visual Studio z obciążeniem pulpitu natywnego - winget install --id Microsoft.VisualStudio.Community --source winget --override "--add Microsoft.VisualStudio.Workload.NativeDesktop --includeRecommended --passive --wait"

Proces

Postępuj zgodnie z poniższymi przewodnikami, aby skonfigurować aplikację Electron, wywołać nowoczesne interfejsy API Windows i spakować ją do dystrybucji:

1. Konfigurowanie środowiska deweloperskiego

Najpierw skonfigurujesz środowisko projektowe przy użyciu niezbędnych narzędzi i zestawów SDK. Obejmuje to:

  • Tworzenie lub konfigurowanie aplikacji Electron
  • Instalowanie interfejsu wiersza polecenia usługi WinApp
  • Inicjowanie zestawów SDK Windows i wymaganych zasobów
  • Konfigurowanie potoku kompilacji

Wprowadzenie do konfigurowania →

2. Wywoływanie interfejsów API Windows z poziomu języka JavaScript

Jeśli podczas instalacji włączysz powiązania JavaScript, .winapp/bindings/ zawiera wygenerowane .js klasy opakowujące i odpowiadające im .d.ts deklaracje dla interfejsów API zestawu Zestaw SDK do aplikacji systemu Windows. Zaimportuj #winapp/bindings , aby uzyskać dostęp do wszystkich wyeksportowanych klas. Import pakietu #winapp/bindings wymaga @microsoft/dynwinrt-codegen ≥ 0.1.0-preview.8; starsze projekty mogą zachować ścieżkę względną względem pliku importującego (na przykład require('../.winapp/bindings/index.js') z src/index.js) lub zaktualizować za pomocą npm i -D @microsoft/dynwinrt-codegen@latest && npx winapp init --add-js-bindings.

3. Opcjonalne: tworzenie dodatku natywnego

Pomiń ten krok, jeśli wygenerowane powiązania JS obejmują potrzebny interfejs API Zestaw SDK do aplikacji systemu Windows. Utwórz dodatek macierzysty tylko wtedy, gdy potrzebujesz granicy natywnej, takiej jak Win32, pure COM, natywne biblioteki C/C++ lub zarządzane zestawy .NET.

Opcja A: Tworzenie dodatku powiadomień języka C++

Dowiedz się, jak utworzyć dodatek C++, który wywołuje API powiadomień Zestaw SDK do aplikacji systemu Windows. Jest to doskonały punkt wyjścia do zrozumienia natywnych dodatków przed rozpoczęciem bardziej złożonych scenariuszy.

Tworzenie dodatku powiadomień języka C++ →

Opcja B: Tworzenie dodatku krzemionki Phi

Dowiedz się, jak utworzyć dodatek języka C#, który używa modelu Sztucznej inteligencji Phi do podsumowania tekstu na urządzeniu. Silica Phi to mały model językowy, który działa lokalnie na urządzeniach Windows 11 z jednostkami NPU.

Utwórz dodatek Phi Silica →

Opcja C: Tworzenie dodatku WinML

Dowiedz się, jak utworzyć dodatek języka C#, który używa Windows Machine Learning (WinML) do uruchamiania niestandardowych modeli ONNX na potrzeby klasyfikacji obrazów, wykrywania obiektów i nie tylko.

Tworzenie → dodatku WinML

4. Pakowanie do dystrybucji

Na koniec spakujesz aplikację jako plik MSIX do dystrybucji. Obejmuje to:

  • Przygotowanie aplikacji do użycia w środowisku produkcyjnym
  • Tworzenie i podpisywanie pakietu MSIX
  • Testowanie zainstalowanego pakietu
  • Omówienie opcji dystrybucji

Spakuj swoją aplikację →

Szybka nawigacja

Faza Przewodnik Czego nauczysz się
1️⃣ Setup Instalowanie narzędzi, inicjowanie zestawów SDK, konfigurowanie potoku kompilacji
2️⃣ Powiązania JS powiadomień Wyświetlanie powiadomienia Zestaw SDK do aplikacji systemu Windows bezpośrednio z poziomu języka JavaScript
2️⃣ wiązania JS do interfejsów API systemu Windows Wywołaj interfejs API pakietu Zestaw SDK do aplikacji systemu Windows, a następnie rozszerz powiązania o interfejsy API pakietu Windows SDK
2️⃣ Wiązania JS Phi Silica Wywoływanie lokalnego modelu językowego bezpośrednio z poziomu języka JavaScript
2️⃣ Powiązania JS języka WinML Rejestrowanie dostawców wykonywania WinML i uruchamianie środowiska uruchomieniowego ONNX z poziomu języka JavaScript
3️⃣ Dodatek powiadomień języka C++ Utwórz dodatek C++, wywołaj interfejsy API powiadomień, przetestuj za pomocą identyfikatora debugowania
3️⃣ Dodatek krzemionkowy Phi Tworzenie alternatywnego dodatku języka C# dla interfejsów API sztucznej inteligencji
3️⃣ Dodatek WinML Tworzenie alternatywnego dodatku języka C# dla języka WinML
4️⃣ Pakowanie Tworzenie aplikacji produkcyjnej, tworzenie pliku MSIX, dystrybucja

Dodatkowe zasoby

Uzyskiwanie pomocy

  • Last updated on