hermes README

The project's README from github.com/facebook/hermes. As one markdown file: README.md.

Hermes JS Engine

MIT license npm version PRs Welcome Hermes logo - large H with wings

Hermes is a JavaScript engine optimized for fast start-up of React Native apps. It features ahead-of-time static optimization and compact bytecode.

If you're only interested in using pre-built Hermes in a new or existing React Native app, you do not need to follow this guide or have direct access to the Hermes source. Instead, just follow these instructions to enable Hermes.

Noted that each Hermes release is aimed at a specific RN version. The rule of thumb is to always follow Hermes releases strictly. Version mismatch can result in instant crash of your apps in the worst case scenario.

If you want to know how to build and hack on Hermes directly, and/or integrate Hermes built from source into a React Native app then read on.

Hermes Blog - Technical articles and deep dives into Hermes internals.

The instructions here very briefly cover steps to build the Hermes CLI. They assume you have typical native development tools setup for your OS, and support for cmake and Ninja. For more details of required dependencies, building Hermes with different options, etc. follow these links instead:

To build a local debug version of the Hermes CLI tools the following steps should get you started on macOS/Linux:

mkdir hermes_workingdir
cd hermes_workingdir
git clone https://github.com/facebook/hermes.git
cmake -S hermes -B build -G Ninja -DCMAKE_BUILD_TYPE=Debug
cmake --build ./build

Or if you're using Windows, the following should get you going in a Git Bash shell:

mkdir hermes_workingdir
cd hermes_workingdir
git -c core.autocrlf=false clone https://github.com/facebook/hermes.git
cmake -S hermes -B build -G 'Visual Studio 16 2019' -A x64
cmake --build ./build

You will now be in a directory with the output of building Hermes into CLI tools. From here you can run a piece of JavaScript as follows:

echo "'use strict'; function hello() { print('Hello World'); } hello();" | ./bin/hermes

Contributing

The main purpose of this repository is to continue to evolve Hermes, making it faster and more efficient. We are grateful to the community for contributing bugfixes and improvements. Read below to learn how you can take part in improving Hermes.

Code of Conduct

Facebook has adopted a Code of Conduct that we expect project participants to adhere to. Please read the full text so that you can understand what actions will and will not be tolerated.

Contributing Guide

Read our contributing guide to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to Hermes.

License

Hermes is MIT licensed.

hermes (facebook/hermes)

Searching Database…

11.4K ·GitHub
Hermes
Что это такое?Hermes — это JavaScript-движок, оптимизированный для быстрого запуска приложений на React Native. Он использует статическую оптимизацию заранее (ahead-of-time) и компактный байт-код вместо разбора исходного JS во время работы.
Hermes — это библиотека, которую я встраиваю, или отдельная программа?В основном это библиотека JS-движка, которая встраивается внутрь приложений на React Native. Но в репозитории также собираются отдельные CLI-утилиты, с помощью которых можно запустить JavaScript-код напрямую из командной строки.
Как добавить Hermes в приложение на React Native?Если вам нужен только готовый движок, этот исходный репозиторий вам вообще не нужен — достаточно следовать инструкциям React Native, чтобы включить Hermes в новом или уже существующем приложении.
Работает ли любая версия Hermes с любой версией React Native?Нет — каждый релиз Hermes рассчитан на конкретную версию React Native, и в README прямо предупреждается, что эту связку нужно строго соблюдать, поскольку несовпадение версий может полностью обрушить приложение.
На каких платформах Hermes собирается и работает?CI покрывает сборки для Android, платформ Apple (включая срезы для iOS), macOS, Linux и Windows, так что Hermes поддерживает весь набор платформ, на которых работает сам React Native.
Зачем вообще нужен Hermes, почему не использовать системный JS-движок?Он создан специально для ускорения запуска приложений на мобильных устройствах: JavaScript предварительно компилируется заранее в компактный байт-код, а не разбирается и не компилируется в JIT-режиме при запуске.
Можно ли попробовать CLI Hermes, не трогая React Native?Да — после сборки проекта с помощью cmake и Ninja в выходной директории появятся отдельные CLI-утилиты, которые могут выполнить JavaScript-файл напрямую.
Где найти более подробные сведения о параметрах сборки и внутреннем устройстве?В README есть ссылки на отдельное руководство «Building and Running Hermes» и на блог Hermes с техническими разборами — для всего, что выходит за рамки быстрого старта.
What are similar projects?mquickjs, flipper, bgfx, goldie, matrix, porffor, react-native, Detox
Which topics is it in?bytecode, engine, interpreter, react-native, compiler, apple, mobile-app, cpp, mobile, ios, performance, android
Creator
facebook
Size
112 MB
Stars
11.4K
Updated
CommitOct 15Releasev0.13.0Aug 16
Age
7y
Commits · 90 Days