入門指南：將 Windows API 加入你的 Electron 應用程式

本指南將引導你如何使用 Windows 應用程式 Development CLI 為 Electron 應用程式加入 Windows 原生功能。 你會學到如何從 Electron 應用程式呼叫現代 Windows API、使用應用程式身份進行測試，以及打包成分發套件。

您將構建的項目

完成本指南後，你會有一個 Electron 應用程式：

  • ✅ 呼叫現代 Windows API（Windows SDK 和 Windows 應用程式 SDK）
  • ✅ 使用具備 AI 功能的原生外掛（Phi Silica 或 WinML）
  • ✅ 使用應用程式身分識別運行以測試受保護的 API
  • ✅ 套件作為簽署的 MSIX 用於分發

先決條件

在開始之前，請確保您擁有：

  • Windows 11（如果使用 Phi Silica，則可以使用 Copilot+ PC）
  • Node.js - winget install OpenJS.NodeJS --source winget
  • .NET SDK v10 - 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 CLI
  • 初始化 Windows SDK 及所需資產
  • 設定你的建置流程

從設定開始→

2. 建立原生附加元件

接著，你會建立一個原生外掛，呼叫 Windows API。 選擇下列其中一個指南：

選項 A： 建立 C++ 通知外掛

學習如何建立一個 C++ 外掛，呼叫 Windows 應用程式 SDK 通知 API。 這是理解原生插件的好起點，之後再深入更複雜的情境。

建立一個 C++ 通知外掛→

選項 B： 創建 Phi Silica 插件

學習如何建立一個使用 Phi Silica AI 模型來在裝置上摘要文字的 C# 插件。 Phi Silica 是一種小型語言模型，可在 Windows 11 裝置上本地執行，並配備 NPU。

建立 Phi Silica 外掛→

選項 C： 建立 WinML 外掛

學習如何建立一個使用 Windows 機器學習（WinML）來執行自訂 ONNX 模型的 C# 外掛，用於影像分類、物件偵測等功能。

建立一個 WinML 外掛→

3. 分銷包裝

最後，你會把應用程式打包成 MSIX 來分發。 這包括：

  • 為生產環境打造你的應用程式
  • 建立與簽署 MSIX 套件
  • 測試已安裝套件
  • 了解分配選項

打包你的應用程式→

快速導航

階段 Guide 您將學到的內容
1️⃣ 設定 安裝工具、初始化 SDK、設定建置流程
2️⃣ C++ 通知附加元件 建立 C++ 外掛，呼叫通知 API，測試除錯憑證
2️⃣ Phi Silica 附加元件 建立 C# 外掛程式，呼叫 AI 應用程式介面，使用除錯身份進行測試
2️⃣ WinML 附加元件 建立 C# 外掛，呼叫 WinML API，執行 ONNX 模型，整合機器學習
3️⃣ 包裝 建立生產應用程式、建立 MSIX、發佈

其他資源

取得說明

  • Last updated on