sea

Эта функция позволяет удобно распространять приложение Node.js в системе, где Node.js не установлен.

Node.js поддерживает создание автономных исполняемых приложений, позволяя внедрять подготовленный Node.js блок данных, который может содержать объединённый скрипт, в двоичный файл node. При запуске программа проверяет, были ли внедрены какие-либо данные. Если блок данных найден, выполняется содержащийся в нём скрипт. В противном случае Node.js работает как обычно.

В настоящее время функция автономных исполняемых приложений поддерживает запуск только одного встроенного скрипта с использованием системы модулей CommonJS.

Пользователи могут создать автономное исполняемое приложение из объединённого скрипта с помощью самого двоичного файла node и любого инструмента, способного внедрять ресурсы в двоичный файл.

Ниже приведены шаги по созданию автономного исполняемого приложения с помощью одного из таких инструментов — postject:

1. Создайте файл JavaScript:

echo 'console.log(`Hello, ${process.argv[2]}!`);' > hello.js

2. Создайте файл конфигурации для сборки блока данных, который можно внедрить в автономное исполняемое приложение (подробности см. в Generating single executable preparation blobs):

echo '{ "main": "hello.js", "output": "sea-prep.blob" }' > sea-config.json

3. Создайте блок данных для внедрения:

node --experimental-sea-config sea-config.json

4. Создайте копию исполняемого файла node и назовите её по своему усмотрению:
   • В системах, отличных от Windows:

cp $(command -v node) hello

• В Windows:

node -e "require('fs').copyFileSync(process.execPath, 'hello.exe')"

Необходимо расширение .exe. 5. Удалите подпись двоичного файла (только для macOS и Windows):

• В macOS:

codesign --remove-signature hello

• В Windows (необязательно): можно использовать signtool из установленного Windows SDK. Если этот шаг пропущен, проигнорируйте предупреждения postject, связанные с подписью.

signtool remove /s hello.exe

6. Внедрите блок данных в скопированный двоичный файл, выполнив postject со следующими параметрами:
   • hello / hello.exe — имя копии исполняемого файла node, созданной на шаге 4.
   • NODE_SEA_BLOB — имя ресурса / заметки / секции в двоичном файле, где будет храниться содержимое блока данных.
   • sea-prep.blob — имя блока данных, созданного на шаге 1.
   • --sentinel-fuse NODE_SEA_FUSE_fce680ab2cc467b6e072b8b5df1996b2 — предохранитель, используемый проектом Node.js для определения факта внедрения данных в файл.
   • --macho-segment-name NODE_SEA (требуется только в macOS) — имя сегмента в двоичном файле, где будет храниться содержимое блока данных. Итак, необходимые команды для каждой платформы:
   • В Linux:

   npx postject hello NODE_SEA_BLOB sea-prep.blob \
       --sentinel-fuse NODE_SEA_FUSE_fce680ab2cc467b6e072b8b5df1996b2
   

   • В Windows — PowerShell:

   npx postject hello.exe NODE_SEA_BLOB sea-prep.blob `
       --sentinel-fuse NODE_SEA_FUSE_fce680ab2cc467b6e072b8b5df1996b2
   

   • В Windows — командная строка:

   npx postject hello.exe NODE_SEA_BLOB sea-prep.blob ^
       --sentinel-fuse NODE_SEA_FUSE_fce680ab2cc467b6e072b8b5df1996b2
   

   • В macOS:

   npx postject hello NODE_SEA_BLOB sea-prep.blob \
       --sentinel-fuse NODE_SEA_FUSE_fce680ab2cc467b6e072b8b5df1996b2 \
       --macho-segment-name NODE_SEA
   

7. Подпишите двоичный файл (только для macOS и Windows):
   • В macOS:

codesign --sign - hello

• В Windows (необязательно): для этого требуется сертификат. Однако двоичный файл без подписи всё равно можно будет запустить.

signtool sign /fd SHA256 hello.exe

8. Запустите двоичный файл:
   • В системах, отличных от Windows

$ ./hello world
Hello, world!

• В Windows

$ .\hello.exe world
Hello, world!