Начало работы. Добавление API Windows в приложение Electron

В этом руководстве описано, как добавить собственные возможности Windows в приложение Electron с помощью интерфейса командной строки разработки приложение для Windows. Вы узнаете, как вызывать современные API Windows из вашего приложения Electron, тестировать приложения с учетом их идентичности и упаковывать их для распространения.

Что вы будете создавать

В конце этого руководства у вас будет приложение Electron, которое:

• ✅ вызывает современные API Windows (Windows SDK и Windows App SDK)
• ✅ Использует собственную надстройку с функциями искусственного интеллекта (Phi Silica или WinML)
• ✅ Выполняется с идентификатором приложения для тестирования защищенных API
• ✅ Пакеты в виде подписанного MSIX для распространения

Необходимые условия

Прежде чем начать, убедитесь, что у вас есть следующее:

• Windows 11 (Copilot+ PC при использовании Phi Silica)
• Node.js - winget install OpenJS.NodeJS --source winget
• .NET SDK версии 10 - winget install Microsoft.DotNet.SDK.10 --source winget
• Visual Studio с нативной рабочей нагрузкой для настольных ПК - winget install --id Microsoft.VisualStudio.Community --source winget --override "--add Microsoft.VisualStudio.Workload.NativeDesktop --includeRecommended --passive --wait"

Процесс

Создание приложения с поддержкой Windows Electron включает три основных этапа:

1. Настройка среды разработки

Во-первых, вы настроите среду разработки с помощью необходимых средств и пакетов SDK. Сюда входит следующее:

• Создание или настройка приложения Electron
• Установка интерфейса командной строки winapp
• Инициализация пакетов SDK Windows и необходимых ресурсов
• Настройка конвейера сборки

Начните настройку →

2. Создание нативного аддона

Затем вы создадите собственную надстройку, которая вызывает Windows API. Выберите одно из следующих руководств:

Вариант A. Создание надстройки уведомления C++

Узнайте, как создать надстройку C++, которая вызывает API уведомлений Windows App SDK. Это отличная отправная точка для понимания собственных аддонов перед тем как погрузиться в более сложные сценарии.

Создание надстройки уведомления C++ →

Вариант B: Создание надстройки Phi Silica

Узнайте, как создать надстройку C#, которая использует модель ИИ Phi Silica для сводки текста на устройстве. Phi Silica — это небольшая языковая модель, которая выполняется локально на Windows 11 устройствах с NPU.

Создать дополнение Phi Silica →

Вариант C. Создание надстройки WinML

Узнайте, как создать надстройку C#, которая использует Windows Машинное обучение (WinML) для запуска пользовательских моделей ONNX для классификации изображений, обнаружения объектов и т. д.

Создать надстройку WinML →

3. Упаковка для распространения

Наконец, вы упаковите приложение в виде MSIX для распространения. Сюда входит следующее:

• Создание приложения для рабочей среды
• Создание и подписание пакета MSIX
• Тестирование установленного пакета
• Общие сведения о вариантах распространения

Упаковка приложения →

Быстрая навигация

Этап	Guide	Цели обучения
1️⃣	Setup	Установка средств, инициализация пакетов SDK, настройка конвейера сборки
2️⃣	Плагин уведомлений C++	Создайте надстройку C++, вызовите API уведомлений, протестируйте с идентификацией отладки
2️⃣	Фи Силика Addon	Создание дополнения C#, вызов API ИИ, тестирование с помощью отладочной учетной записи
2️⃣	Надстройка WinML	Создание надстройки C#, вызов API WinML, запуск моделей ONNX, интеграция машинного обучения
3️⃣	Упаковка	Создание рабочего приложения, создание MSIX, распространение

Дополнительные ресурсы

• Документация по интерфейсу командной строки winapp — полный справочник по CLI
• Пример приложения Electron — полный рабочий пример
• Коллекция разработчиков ИИ — пример коллекции всех API-интерфейсов ИИ
• Windows App SDK Примеры — коллекция примеров Windows App SDK
• node-api-dotnet — библиотека взаимодействия JavaScript на C# ↔

Получение справки

• Обнаружена ошибка?Файл проблемы