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
- Nutzung
electron-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 erfordert
electron-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
- Durch
systemPreferences.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 Umschaltenvue-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
- Nutzung
protocolModul 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 Protokollnamerequest.url: Vollständige übergebene URLcallback({ 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 klicken
myapp://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.plist
CFBundleURLTypes - Windows erfordert die Registrierung des Protokolls in der Registry
- Die Protokollbehandlungslogik sollte im Hauptprozess platziert werden; der Renderer-Prozess empfängt nur Ereignisse
- macOS erfordert Konfiguration in Info.plist