Értesítés megjelenítése JavaScriptből (JS-kötések)

Ez az útmutató bemutatja, hogyan jeleníthet meg egy Windows App SDK alkalmazásértesítést közvetlenül az Electron főfolyamatából, JavaScriptből generált JS-kötések használatával.

Prerequisites

Az útmutató megkezdése előtt győződjön meg arról, hogy a következőt tette:

• Befejeződött a fejlesztési környezet beállítása.

1. lépés: Értesítés megjelenítése az Elektron főfolyamatából

Importálja a létrehozott kötéseket a #winapp/bindings csomagimportálással, hozzon létre egy alkalmazásértesítést, és jelenítse meg az alapértelmezett értesítéskezelővel:

Szükséges: @microsoft/dynwinrt-codegen ≥ 0.1.0-preview.8. A régebbi projektek vagy frissíthetők a npm i -D @microsoft/dynwinrt-codegen@latest && npx winapp init --add-js-bindings használatával, hogy a winapp init bekösse a #winapp/bindings importtérképet, vagy megtarthatják a relatív formát require('../.winapp/bindings/index.js') (az útvonal a src/index.js-hoz képest relatív; igazítsa, ha a belépési pontként szolgáló fájl máshol található).

// src/index.js (Electron main, CommonJS)
const {
  AppNotificationBuilder,
  AppNotificationManager,
} = require('#winapp/bindings');

function showNotification(title, message) {
  const notification = AppNotificationBuilder
    .create()
    .addText(title)
    .addText(message)
    .buildNotification();

  AppNotificationManager.default_.show(notification);
}

const createWindow = () => {
  // ... existing window creation code ...

  // Test the Windows App SDK notification
  showNotification(
    'Hello from Electron!',
    'This notification is powered by the Windows App SDK!'
  );
};

Note

AppNotificationManager.default_ leképezi a Windows App SDK Default tulajdonságát. A generált bindingok a végére teszik a(z) _ jelet, mert a default egy JavaScript-kulcsszó.

2. lépés: Futtatás

Mielőtt az értesítések működni fognak, győződjön meg arról, hogy az alkalmazás identitással fut:

npx winapp node add-electron-debug-identity

Note

Ez a parancs már része a telepítési útmutatóban hozzáadott postinstall szkriptnek, ezért a(z) npm install után automatikusan lefut. Futtassa kézzel, valahányszor módosítja a(z) Package.appxmanifest elemet, frissíti az alkalmazás erőforrásait, vagy újratelepíti a függőségeket.

Most indítsa el az alkalmazást:

npm start

A Windows App SDK-értesítés akkor jelenik meg, amikor a fő folyamat meghívja a(z) showNotification elemet.

Következő lépések

Gratulálok! Mostantól Windows App SDK-értesítéseket jeleníthetsz meg az Electron-alkalmazásodból – natív bővítmény és node-gyp fordítási lépés nélkül. 🎉

Most készen áll a következőre:

• Csomagolja be az alkalmazást a disztribúcióhoz – készítsen egy MSIX-et, amelyet elküldhet (a @microsoft/dynwinrt futtatókörnyezet már az Ön dependenciesszámítógépén van).

Vagy fedezze fel a többi útmutatót:

• Windows API-k meghívása JavaScriptből – válasszon ki egy fájlt, és JS-kötések használatával olvassa be a képméreteket.
• Phi Silica meghívása JavaScriptből – a szöveg összegzése Windows App SDK AI-vel JS-kötéseken keresztül.
• WinML futtatása JavaScriptből — használja a Windows App SDK ML-szolgáltatófelderítést a(z) onnxruntime-node használatával.
• C++ natív bővítmény létrehozása – natív C++ bővítmény megfelelője az értesítésekhez.
• Első lépések áttekintése – térjen vissza a fő útmutatóhoz.

További források

• winapp CLI dokumentációja – teljes CLI-referencia (init, restore, ). node generate-bindings
• Minta Electron-alkalmazás – teljes, működő példa, a JS-kötésekkel együtt.
• @microsoft/dynwinrt – az a futtatókörnyezet, amely a létrehozott kötéseket működteti.
• @microsoft/dynwinrt-codegen – a kódgenerátor.