Инструкции по сборке (Windows)

Следуйте приведенным ниже рекомендациям для сборки Electron самого по себе на Windows в целях создания пользовательских бинарников Electron. Для объединения и распространения кода вашего приложения с предварительно собранными бинарниками Electron см. руководство по распространению приложений.

Предварительные требования​

• Windows 10 / Server 2012 R2 или выше
• Visual Studio 2017 15.7.2 или выше - скачать VS 2019 Community Edition бесплатно
  • Для получения более подробной информации о необходимых компонентах Visual Studio см. документацию по сборке Chromium.
  • Если Visual Studio установлена не по умолчанию, вам необходимо задать несколько переменных среды, чтобы указать инструментарию пути к вашей установке.
    • vs2019_install = DRIVE:\path\to\Microsoft Visual Studio\2019\Community, заменив 2019 и Community на ваши установленные версии и заменив DRIVE: на диск, на котором установлена Visual Studio. Часто это C:.
    • WINDOWSSDKDIR = DRIVE:\path\to\Windows Kits\10, заменив DRIVE: на диск, на котором установлены Windows Kits. Часто это C:.
• Node.js
• Git
• Инструменты отладки для Windows из Windows SDK 10.0.15063.468, если вы планируете создавать полное дистрибутив, поскольку symstore.exe используется для создания хранилища символов из файлов .pdb.
  • Разные версии SDK могут быть установлены параллельно. Для установки SDK откройте установщик Visual Studio, выберите Modify → Individual Components, прокрутите вниз и выберите соответствующий Windows SDK для установки. Еще один вариант — посмотреть в архив Windows SDK и эмулятора и скачать автономную версию SDK соответственно.
  • Инструменты отладки SDK также должны быть установлены. Если Windows 10 SDK был установлен через установщик Visual Studio, то их можно установить, перейдя по пути: Control Panel → Programs → Programs and Features → Выберите "Windows Software Development Kit" → Change → Change → Установите флажок "Инструменты отладки для Windows" → Change. Или вы можете скачать автономный установщик SDK и использовать его для установки инструментов отладки.

Если у вас пока нет установки Windows, на dev.microsoftedge.com есть временные версии Windows, которые вы можете использовать для сборки Electron.

Сборка Electron выполняется исключительно с помощью скриптов командной строки и не может быть выполнена с помощью Visual Studio. Вы можете разрабатывать Electron с любым редактором, но поддержка сборки с Visual Studio появится в будущем.

Примечание: Несмотря на то, что Visual Studio не используется для сборки, она всё же необходима, потому что нам нужны предоставляемые ею инструменты сборки.

Исключение исходного дерева из Windows Security​

Windows Security не нравится один из файлов в исходном коде Chromium (см. https://crbug.com/441184), поэтому он постоянно удаляет его, вызывая gclient sync проблемы. Вы можете исключить исходное дерево из мониторинга Windows Security, следуя этим инструкциям.

Сборка​

См. Инструкции по сборке: GN

Сборка 32-битных библиотек​

Чтобы собрать для 32-битной цели, вам нужно передать target_cpu = "x86" в качестве аргумента GN. Вы можете собрать 32-битную цель вместе с 64-битной, используя для GN другой каталог вывода, например out/Release-x86, с разными аргументами.

$ gn gen out/Release-x86 --args="import(\"//electron/build/args/release.gn\") target_cpu=\"x86\""

Остальные шаги сборки точно такие же.

Проект Visual Studio​

Чтобы сгенерировать проект Visual Studio, вы можете передать параметр --ide=vs2017 в gn gen:

$ gn gen out/Testing --ide=vs2017

Поиск и устранение неполадок​

Команда xxxx не найдена​

Если вы столкнулись с ошибкой, подобной Command xxxx not found, попробуйте использовать консоль VS2015 Command Prompt для выполнения скриптов сборки.

Критическая внутренняя ошибка компилятора: C1001​

Убедитесь, что у вас установлено последнее обновление Visual Studio.

LNK1181: не удаётся открыть входной файл 'kernel32.lib'​

Попробуйте переустановить 32-битную версию Node.js.

Ошибка: ENOENT, stat 'C:\Users\USERNAME\AppData\Roaming\npm'​

Создание этой папки должно исправить проблему:

$ mkdir ~\AppData\Roaming\npm

node-gyp не распознаётся как внутренняя или внешняя команда​

Вы можете получить эту ошибку, если используете Git Bash для сборки. Используйте PowerShell или командную строку VS2015 вместо этого.

Не удаётся создать каталог по адресу ...: Слишком длинное имя файла​

node.js имеет некоторые чрезвычайно длинные пути, и по умолчанию git в Windows не обрабатывает длинные пути должным образом (хотя Windows их поддерживает). Это должно исправить проблему:

$ git config --system core.longpaths true

ошибка: использование не объявленного идентификатора 'DefaultDelegateCheckMode'​

Это может произойти во время сборки, когда инструменты отладки для Windows были установлены с Windows Driver Kit. Удалите Windows Driver Kit и установите инструменты отладки, следуя описанным выше инструкциям.

ImportError: Модуль win32file не найден​

Убедитесь, что вы установили pywin32 с pip install pywin32.

Сценарии сборки зависают до нажатия клавиши​

Эта ошибка является "особенностью" командной строки Windows. Она возникает, когда щелкают внутри окна командной строки с включённой функцией QuickEdit и предназначена для удобного выделения и копирования текста вывода. Так как каждое случайное нажатие приостановит процесс сборки, вы можете отключить эту функцию в свойствах командной строки.