Продвинутые темы Electron
Electron может не только создавать кроссплатформенные настольные приложения, но и поддерживает глубокую интеграцию с системой и расширения с дополнительными возможностями. Освоение этих продвинутых приёмов может сделать приложения более профессиональными и мощными.
Интеграция нативных модулей Node.js
Использование node-gyp
- node-gyp— это инструмент компиляции нативных модулей Node.js, поддерживает компиляцию модулей C/C++
Установка:
npm install -g node-gyp
- Инициализация проекта:
node-gyp configure node-gyp build
- Вывод
.nodeфайл, можно загрузить напрямую в Electron:const native = require('./build/Release/native.node')
Компиляция нативных модулей
- Нативные модули должны быть скомпилированы под версию Node и ABI Electron
- Использование
electron-rebuildИнструменты:npm install --save-dev electron-rebuild npx electron-rebuild
- Убедитесь, что модуль совместим с текущей версией Electron
Устранение типичных проблем
- Несовместимость ABI: Electron использует разные версии Node, что требует
electron-rebuild - Ошибка компиляции:Проверьте C++ CompileEnvironment(Windows требует установки Visual Studio Build Tools,macOS требует Xcode Command Line Tools)
- Проблема с путём: убедитесь, что путь к модулю указан верно, используйте абсолютные пути для загрузки
.nodeФайл
Глубокая интеграция с системой
Определение системной темы
- Определение тёмной/светлой темы:
const { nativeTheme } = require('electron') console.log(nativeTheme.shouldUseDarkColors) nativeTheme.on('updated', () => { console.log('主题更新:', nativeTheme.shouldUseDarkColors) }) - Предотвращение засыпания системы:
const { powerSaveBlocker } = require('electron') const id = powerSaveBlocker.start('prevent-display-sleep') powerSaveBlocker.stop(id) - Определение состояния питания:
const { systemPreferences } = require('electron') console.log(systemPreferences.getSystemIdleTime())
Управление экраном
- Получение информации об экране:
const { screen } = require('electron') const primaryDisplay = screen.getPrimaryDisplay() console.log(primaryDisplay.size) - Поддержка нескольких экранов, определение разрешения и автоматическая адаптация окон
Определение простоя системы
- Через
systemPreferences.getSystemIdleTime()Получение времени бездействия пользователя - Может использоваться для автоматической блокировки экрана, энергосбережения или функций напоминания
Поддержка нескольких языков
Подход к реализации i18n
Распространённые библиотеки:
i18next: Поддержка языковых пакетов JSON/YAML, динамическое переключениеvue-i18n/react-i18nextИнтеграция с фронтенд-фреймворками:
Структура файлов:
locales/ en.json zh.json
Переключение языка:
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
Можно динамически изменятьlng, что обеспечивает переключение языка в реальном времени.
Динамическая загрузка языковых пакетов
- Для больших проектов языковые пакеты можно загружать по требованию:
async function setLanguage(lang) { const resources = await import(`./locales/${lang}.json`) i18next.addResources(lang, 'translation', resources.default) i18next.changeLanguage(lang) } - Оптимизировать размер пакета, сократить время загрузки при запуске
Пользовательский протокол
Electron поддерживает регистрацию пользовательских протоколов, позволяя приложению вызывать внутренние функции или реализовывать глубокие ссылки через определённые схемы URL.
Зарегистрировать пользовательский протокол
- Использование
protocolМодуль регистрирует пользовательский протокол - Может использоваться для загрузки внутренних ресурсов приложения или ответа на определённые URL
const { app, protocol } = require('electron')
app.whenReady().then(() => {
protocol.registerFileProtocol('myapp', (request, callback) => {
const url = request.url.substr(7) // 去掉 'myapp://'
callback({ path: `${__dirname}/${url}` })
})
})
Описание:
'myapp': Имя пользовательского протоколаrequest.url: Полный переданный URLcallback({ path }): Указывает на локальный путь к файлу, может использоваться для загрузки HTML, изображений и т. д.
Глубокие ссылки
- Глубокие ссылки позволяют пользователям напрямую открывать определённые страницы или функции приложения через URL
- Зарегистрировать системный протокол:
if (!app.isDefaultProtocolClient('myapp')) { app.setAsDefaultProtocolClient('myapp') } - На macOS / Windows нажмите
myapp://note/123Может вызывать события приложения - Обработка глубоких ссылок:
app.on('open-url', (event, url) => { event.preventDefault() console.log('接收到深度链接:', url) // 可解析 URL 跳转到应用内部页面 }) - Обработка событий Windows:
app.on('second-instance', (event, argv) => { const url = argv.find(arg => arg.startsWith('myapp://')) if (url) { console.log('接收到深度链接:', url) } })
Обработка протоколов
-
Безопасность:
- Проверяйте содержимое URL, чтобы предотвратить несанкционированные операции
- Избегайте загрузки вредоносных файлов или выполнения произвольных команд
-
сценарии применения:
- Открыть конкретную заметку, документ или страницу
- Взаимодействие с веб-страницами, вызов локальных функций
- Взаимодействие между приложениями или платформами
-
Примечания:
- macOS требует настройки в Info.plist
CFBundleURLTypes - Windows требует регистрации протокола в реестре
- Логику обработки протоколов следует размещать в основном процессе; процесс рендеринга только получает события
- macOS требует настройки в Info.plist