Учебник по Electron.js

Первые шаги

Установка Node.js

Для установки Node.js переходим на сайт nodejs.org и скачиваем программу установки. В моем случае она имеет название node-v21.4.0-x64.msi. Запускаем программу установки и на первом шаге нажимаем кнопку Next. На втором шаге соглашаемся с лицензионным соглашением и нажимаем кнопку Next. На следующем шаге нужно выбрать каталог для установки Node.js. Можно оставить путь по умолчанию, но я устанавливаю Node.js в каталог C:\nodejs\node12, чтобы в пути не было пробелов. Выбираем каталог и нажимаем кнопку Next. На следующем шаге можно выбрать устанавливаемые компоненты. Оставляем настройки по умолчанию и нажимаем кнопку Next. На следующем шаге также ничего не меняем и нажимаем кнопку Next. Далее нажимаем кнопку Install для запуска процесса установки. Для установки требуются права администратора, поэтому в следующем окне нужно разрешить установку. Нажимаем кнопку Finish для завершения работы программы установки.

Работа с командной строкой

Для проверки правильности установки Node.js и для дальнейшей работы нам понадобится приложение Командная строка. Вполне возможно, что вы никогда не пользовались командной строкой и не знаете, как запустить это приложение. Давайте рассмотрим некоторые способы его запуска в Windows:

В некоторых случаях для выполнения различных команд могут потребоваться права администратора. Чтобы запустить командную строку с правами администратора через поиск находим приложение Командная строка, щелкаем на значке правой кнопкой мыши и затем выбираем пункт Запуск от имени администратора.

Запомните способы запуска командной строки наизусть. В дальнейшем мы просто будем говорить "запустите командную строку" без уточнения как это сделать.

Итак, в результате установки Node.js требуемые файлы были загружены в каталог, указанный на третьем шаге мастера. Кроме того, если вы ничего не меняли на четвертом шаге, путь к Node.js был автоматически добавлен в переменную окружения PATH. Поэтому в командной строке можно просто указать название программы без явного добавления пути к ней. Давайте проверим работоспособность Node.js. Запускаем командную строку и выполняем команду node --version:

C:\book>node --version
v12.18.3

Можно также воспользоваться командой node -v:

C:\book\p1>node -v
v12.18.3

Фрагмент C:\book> перед командой означает приглашение для ввода команды с указанием текущего рабочего каталога. Текст после команды является результатом ее выполнения. В нашем примере мы получили версию Node.js.

Если вы получили следующий результат:

C:\book>node --version
"node" не является внутренней или внешней
командой, исполняемой программой или пакетным файлом.

то программа Node.js не найдена. Вполне возможно, что путь не был добавлен в переменную окружения PATH. Выведите значение этой переменной с помощью команды:

echo %Path%

Если путь не прописан, то его нужно добавить вручную. Чтобы изменить системную переменную PATH в Windows, переходим в Параметры | Панель управления | Система и безопасность | Система | Дополнительные параметры системы. В результате откроется окно Свойства системы. На вкладке Дополнительно нажимаем кнопку Переменные среды. В открывшемся окне в списке Системные переменные выделяем строку с переменной Path и нажимаем кнопку Изменить.

Внимание!

Случайно не удалите существующее значение переменной PATH, иначе другие приложения перестанут запускаться.

Значение системной переменной можно временно изменить для текущего сеанса, т. е. до момента закрытия приложения Командная строка. Для этого перед работой с Node.js нужно выполнить следующую команду:

set Path=<Путь до Node.js>;%Path%

Таким же способом можно запускать другие версии Node.js без переустановки. Путь добавляется в самое начало системной переменной PATH, поэтому будет использоваться именно этот путь. У меня на компьютере уставлено несколько версий Node.js, поэтому этим способом могу запустить, например, Node.js версии 13:

C:\book>set Path=C:\nodejs\node13;%Path%
C:\book>node --version
v13.11.0

Если в пути есть пробелы, то в командной строке такой путь нужно обязательно указывать в кавычках, иначе он будет обрезан до первого пробела. Поэтому, чтобы избежать проблем, на третьем шаге при установке лучше указывать путь без пробелов. Кроме того, имена каталогов и файлов в пути не должны содержать русских букв. Допустимы только латинские буквы, цифры, дефис, подчеркивание и некоторые другие символы.

Советую также убедиться, что имя пользователя компьютера содержит только латинские буквы и цифры. Никаких русских букв и пробелов, т. к. многие программы, включая Node.js, сохраняют различные настройки и временные файлы в каталоге C:\Users\<Имя пользователя>. Если имя пользователя содержит русские буквы, то они могут быть искажены до неузнаваемости из-за неправильного преобразования кодировок и программа не сможет сохранить настройки. Помните, что в разных кодировках русские буквы могут иметь разный код. Разработчики программ в основном работают с английским языком и ничего не знают о проблемах с кодировками, т. к. во всех однобайтовых кодировках и в кодировке UTF-8 коды латинских букв одинаковы. Так что, если хотите без проблем заниматься программированием, то от использования русских букв в имени пользователя лучше отказаться.