Что такое Electron?
Electron — это фреймворк для создания настольных приложений с использованием JavaScript, HTML и CSS. Встраивая Chromium и Node.js в свой двоичный файл, Electron позволяет вам поддерживать один JavaScript-код и создавать кроссплатформенные приложения, работающие на Windows, macOS и Linux — без необходимости в опыте разработки нативных приложений.
Начало работы
Мы рекомендуем начать с учебника, который проведет вас через процесс разработки приложения Electron и распространения его пользователям. Примеры и документация API также являются хорошими местами для просмотра и открытия новых возможностей.
Запуск примеров с Electron Fiddle
Electron Fiddle — это приложение-песочница, написанное с использованием Electron и поддерживаемое разработчиками Electron. Мы настоятельно рекомендуем установить его в качестве обучающего инструмента для экспериментов с API Electron или для прототипирования функций во время разработки.
Fiddle также хорошо интегрируется с нашей документацией. При просмотре примеров в наших руководствах вы часто увидите кнопку «Открыть в Electron Fiddle» под блоком кода. Если у вас установлен Fiddle, эта кнопка откроет fiddle.electronjs.org ссылку, которая автоматически загрузит пример в Fiddle, без необходимости копирования-вставки.
- main.js
- preload.js
- index.html
const { app, BrowserWindow } = require('electron')
const path = require('path')
function createWindow () {
const win = new BrowserWindow({
width: 800,
height: 600,
webPreferences: {
preload: path.join(__dirname, 'preload.js')
}
})
win.loadFile('index.html')
}
app.whenReady().then(() => {
createWindow()
app.on('activate', () => {
if (BrowserWindow.getAllWindows().length === 0) {
createWindow()
}
})
})
app.on('window-all-closed', () => {
if (process.platform !== 'darwin') {
app.quit()
}
})
window.addEventListener('DOMContentLoaded', () => {
const replaceText = (selector, text) => {
const element = document.getElementById(selector)
if (element) element.innerText = text
}
for (const type of ['chrome', 'node', 'electron']) {
replaceText(`${type}-version`, process.versions[type])
}
})
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Hello World!</title>
<meta http-equiv="Content-Security-Policy" content="script-src 'self' 'unsafe-inline';" />
</head>
<body>
<h1>Hello World!</h1>
<p>
We are using Node.js <span id="node-version"></span>,
Chromium <span id="chrome-version"></span>,
and Electron <span id="electron-version"></span>.
</p>
</body>
</html>
Что содержится в документации?
Вся официальная документация доступна в боковой панели. Вот различные категории и то, чего вы можете ожидать от каждой:
- Учебник: пошаговое руководство по созданию и публикации вашего первого приложения Electron.
- Процессы в Electron: подробная справка по процессам Electron и работе с ними.
- Рекомендации по лучшим практикам: важные контрольные списки, которые следует учитывать при разработке приложения Electron.
- Примеры: краткие справки для добавления функций в ваше приложение Electron.
- Разработка: различные руководства по разработке.
- Распространение: узнайте, как распространять ваше приложение конечным пользователям.
- Тестирование и отладка: как отлаживать JavaScript, писать тесты и использовать другие инструменты для создания качественных приложений Electron.
- Справочные материалы: полезные ссылки для лучшего понимания работы и структуры проекта Electron.
- Вклад в проект: компиляция Electron и внесение вклада может показаться сложной задачей. Мы стараемся сделать это проще в этом разделе.
Получение помощи
Застряли где-то? Вот несколько ссылок на места, где можно поискать:
- Если вам нужна помощь в разработке приложения, наш сервер сообщества Discord — отличное место для получения советов от других разработчиков приложений Electron.
- Если вы подозреваете, что столкнулись с ошибкой в пакете
electron, проверьте трекер задач GitHub, чтобы увидеть, соответствуют ли какие-либо существующие задачи вашей проблеме. Если нет, не стесняйтесь заполнить шаблон отчета об ошибках и отправить новую задачу.
© GitHub Inc.
Licensed under the MIT license.
https://www.electronjs.org/docs/latest
