Zobrazení oznámení z JavaScriptu (vazby JS)

Tato příručka ukazuje, jak zobrazit oznámení aplikace Windows App SDK přímo z JavaScriptu hlavního procesu Elektron pomocí vygenerovaných vazeb JS.

Předpoklady

Než začnete s touto příručkou, ujistěte se, že máte:

• Dokončili jste nastavení vývojového prostředí.

Krok 1: Zobrazit oznámení z hlavního procesu Electronu

Importujte vygenerované vazby prostřednictvím importu #winapp/bindings balíčku, sestavte oznámení aplikace a zobrazte ho s výchozím správcem oznámení:

Vyžaduje @microsoft/dynwinrt-codegen ≥ 0.1.0-preview.8. Starší projekty mohou buď upgradovat pomocí npm i -D @microsoft/dynwinrt-codegen@latest && npx winapp init --add-js-bindings, aby winapp init nastavil mapu importů #winapp/bindings, nebo zachovat relativní zápis require('../.winapp/bindings/index.js') (cesta je relativní k src/index.js; upravte ji, pokud je váš vstupní soubor jinde).

// 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_mapuje vlastnost Windows App SDKDefault. Vygenerované vazby přidávají koncové slovo _ , protože default se jedná o klíčové slovo JavaScriptu.

Krok 2: Spusťte ho

Než budou oznámení fungovat, ujistěte se, že vaše aplikace běží s identitou:

npx winapp node add-electron-debug-identity

Note

Tento příkaz je již součástí postinstall skriptu přidaného v průvodci nastavením, takže se spustí automaticky po npm install. Spusťte ho ručně, kdykoli upravíte Package.appxmanifest, aktualizujete prostředky aplikace nebo přeinstalujete závislosti.

Teď spusťte aplikaci:

npm start

Oznámení Windows App SDK se zobrazí, když hlavní proces zavolá showNotification.

Další kroky

Gratulujeme! Ve své aplikaci Electron teď můžete zobrazovat oznámení Windows App SDK — bez nativního doplňku, bez kroku buildu node-gyp. 🎉

Teď jste připraveni:

• Zabalte svou aplikaci pro distribuci – vytvořte MSIX, kterou můžete odeslat ( @microsoft/dynwinrt modul runtime je již ve vaší sadě dependencies).

Nebo prozkoumejte další příručky:

• Volání Windows API z JavaScriptu – vyberte soubor a zjistěte rozměry obrázku pomocí vazeb pro JavaScript.
• Volání Phi Silica pomocí JavaScriptu — shrnutí textu pomocí AI ve Windows App SDK a vazeb pro JavaScript.
• Spuštění WinML v JavaScriptu — použijte funkci Windows App SDK pro zjišťování poskytovatelů ML s onnxruntime-node.
• Vytvoření nativního doplňku jazyka C++ – nativního doplňku jazyka C++ pro oznámení
• Úvodní přehled — vraťte se k hlavnímu průvodci.

Další zdroje

• Dokumentace k rozhraní příkazového řádku winapp – kompletní referenční dokumentace k rozhraní příkazového řádku (init, restore, node generate-bindings).
• Ukázková aplikace Electron — kompletní funkční příklad, včetně vazeb pro JS.
• @microsoft/dynwinrt – modul runtime, který řídí generované vazby.
• @microsoft/dynwinrt-codegen – generátor kódu.