Electron – Fortgeschrittene Themen

Electron kann nicht nur plattformübergreifende Desktop-Anwendungen erstellen, sondern unterstützt auch tiefe Systemintegration und erweiterte Funktionserweiterungen. Die Beherrschung dieser fortgeschrittenen Techniken kann Anwendungen professioneller und leistungsfähiger machen.


Integration nativer Node.js-Module

Verwendung von node-gyp

  • node-gypIst ein Kompilierungstool für native Node.js-Module, unterstützt die Kompilierung von C/C++-Modulen
  • Installation:

    npm install -g node-gyp
  • Projekt initialisieren:
    node-gyp configure
    node-gyp build
  • Ausgabe.nodeDatei, kann direkt in Electron geladen werden:
    const native = require('./build/Release/native.node')

Native Module kompilieren

  • Native Module müssen gegen die Node-Version und ABI von Electron kompiliert werden
  • Nutzungelectron-rebuildWerkzeuge:
    npm install --save-dev electron-rebuild
    npx electron-rebuild
  • Stellen Sie sicher, dass das Modul mit der aktuellen Electron-Version kompatibel ist

Fehlerbehebung bei häufigen Problemen

  • ABI-Inkompatibilität: Electron verwendet unterschiedliche Node-Versionen, was erfordertelectron-rebuild
  • Kompilierung fehlgeschlagen: Prüfen Sie die C++-Kompilierungsumgebung (Windows: Installation der Visual Studio Build Tools erforderlich, macOS: Xcode Command Line Tools erforderlich)
  • Pfadproblem: Stellen Sie sicher, dass der Modulpfad korrekt ist, verwenden Sie absolute Pfade zum Laden.nodeDatei

Tiefe Integration mit dem System

System-Theme-Erkennung

  • Dunkles/helles Theme erkennen:
    const { nativeTheme } = require('electron')
    console.log(nativeTheme.shouldUseDarkColors)
    nativeTheme.on('updated', () => {
      console.log('主题更新:', nativeTheme.shouldUseDarkColors)
    })
  • Systemruhezustand verhindern:
    const { powerSaveBlocker } = require('electron')
    const id = powerSaveBlocker.start('prevent-display-sleep')
    powerSaveBlocker.stop(id)
  • Energiestatus erkennen:
    const { systemPreferences } = require('electron')
    console.log(systemPreferences.getSystemIdleTime())

Bildschirmverwaltung

  • Bildschirminformationen abrufen:
    const { screen } = require('electron')
    const primaryDisplay = screen.getPrimaryDisplay()
    console.log(primaryDisplay.size)
  • Multi-Screen-Unterstützung, Auflösungserkennung und automatische Fensteranpassung

System-Leerlauferkennung

  • DurchsystemPreferences.getSystemIdleTime()Leerlaufzeit des Benutzers abrufen
  • Kann für automatische Bildschirmsperre, Energiesparen oder Erinnerungsfunktionen verwendet werden

Mehrsprachige Unterstützung

i18n-Implementierungsansatz

Gängige Bibliotheken:

  • i18next: Unterstützung von JSON/YAML-Sprachpaketen, dynamisches Umschalten
  • vue-i18n / react-i18nextFrontend-Framework-Integration:

Dateistruktur:

locales/
  en.json
  zh.json

Sprachumschaltung:

const i18next = require('i18next')
i18next.init({
  lng: 'en',
  resources: {
    en: { translation: require('./locales/en.json') },
    zh: { translation: require('./locales/zh.json') }
  }
})
console.log(i18next.t('hello')) // 输出 hello

Kann dynamisch geändert werdenlng, was Echtzeit-Sprachumschaltung ermöglicht.

Sprachpakete dynamisch laden

  • Bei großen Projekten können Sprachpakete bei Bedarf geladen werden:
    async function setLanguage(lang) {
      const resources = await import(`./locales/${lang}.json`)
      i18next.addResources(lang, 'translation', resources.default)
      i18next.changeLanguage(lang)
    }
  • Paketgröße optimieren, Startladezeit reduzieren

Benutzerdefiniertes Protokoll

Electron unterstützt die Registrierung benutzerdefinierter Protokolle, wodurch die Anwendung interne Funktionen aufrufen oder Deep Linking über spezifische URL-Schemata implementieren kann.

Benutzerdefiniertes Protokoll registrieren

  • NutzungprotocolModul registriert benutzerdefiniertes Protokoll
  • Kann verwendet werden, um interne Anwendungsressourcen zu laden oder auf bestimmte URLs zu reagieren
const { app, protocol } = require('electron')

app.whenReady().then(() => {
  protocol.registerFileProtocol('myapp', (request, callback) => {
    const url = request.url.substr(7) // 去掉 'myapp://'
    callback({ path: `${__dirname}/${url}` })
  })
})

Beschreibung:

  • 'myapp': Benutzerdefinierter Protokollname
  • request.url: Vollständige übergebene URL
  • callback({ path }): Verweist auf einen lokalen Dateipfad, kann zum Laden von HTML, Bildern usw. verwendet werden

Deep Linking

  • Deep-Links ermöglichen es Benutzern, bestimmte Seiten oder Funktionen einer Anwendung direkt über eine URL zu öffnen
  • Systemprotokoll registrieren:
    if (!app.isDefaultProtocolClient('myapp')) {
      app.setAsDefaultProtocolClient('myapp')
    }
  • Unter macOS / Windows klickenmyapp://note/123Kann Anwendungsereignisse auslösen
  • Deep-Links verarbeiten:
    app.on('open-url', (event, url) => {
      event.preventDefault()
      console.log('接收到深度链接:', url)
      // 可解析 URL 跳转到应用内部页面
    })
  • Windows-Ereignisbehandlung:
    app.on('second-instance', (event, argv) => {
      const url = argv.find(arg => arg.startsWith('myapp://'))
      if (url) {
        console.log('接收到深度链接:', url)
      }
    })

Protokollbehandlung

  • Sicherheit:

    • URL-Inhalt validieren, um unautorisierte Operationen zu verhindern
    • Vermeiden Sie das Laden bösartiger Dateien oder die Ausführung beliebiger Befehle
  • Anwendungsszenarien:

    • Eine bestimmte Notiz, ein Dokument oder eine Seite öffnen
    • Mit Webseiten interagieren, lokale Funktionen aufrufen
    • Anwendungsübergreifende oder plattformübergreifende Kommunikation
  • Hinweise:

    • macOS erfordert Konfiguration in Info.plistCFBundleURLTypes
    • Windows erfordert die Registrierung des Protokolls in der Registry
    • Die Protokollbehandlungslogik sollte im Hauptprozess platziert werden; der Renderer-Prozess empfängt nur Ereignisse
Weitere Erweiterungen