1. Follow the instructions in the Prerequisites section
2. Copy tester/.npmrc to your project
3. Create access token and set RNOH_NPM_TOKEN by following instructions above
4. Install react-native-harmony: npm i react-native-harmony@npm:@rnoh/react-native-harmony
5. Copy metro.config.js to your project
6. Create a new Harmony project in <YOUR_PROJECT>/harmony
7. Copy tester/harmony/entry module to <YOUR_PROJECT>/harmony/entry
8. Run ./node_modules/.bin/react-native unpack-harmony - it may take a while
9. Add "postinstall": "react-native unpack-harmony" to package.json's script section
10. Update tester/harmony/entry/src/main/ets/pages/Index.ets
    1. Unregister SampleView and SamplePackage
    2. Update "app_name" to match the name specified in <YOUR_PROJECT>/app.json::name
11. Update tester/harmony/entry/src/main/cpp/CMakeLists.txt
    1. Update RNOH_CPP_DIR - set(RNOH_CPP_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../node_modules/react-native-harmony/harmony/cpp")
    2. Unregister SamplePackage
12. Open harmony project in DevEcoStudio and run the project

Note: native code lives in the /tester/harmony/rnoh directory (native code must be in the project directory).

This project uses unreleased DevEco Studio 4.0.3.700 and Open Harmony SDK shipped with DevEco. Follow steps below to install the IDE and required SDKs.

Before starting the development you have to install required SDKs.

1. Download SDK from internal channel or download unreleased DevEcoStudio (unreleased SDK should be included)
2. Change path to SDK in Dev Eco Studio: Tools -> SDK Manager
3. Update your buildProfile.json5 based on buildProfile.template.json5
4. Update hvigor
   1. Copy contents of plugins from internal DevEcoStudio release directory to tester/harmony/hvigor
   2. Open tester/harmony/hvigor/hvigor-config.json5 in DevEcoStudio
   3. DevEcoStudio should show yellow pop ups which should allow you to install dependencies and sync the project
5. DevEcoStudio: Build -> Clean Project
6. Remove .cxx directory from entry module
7. Build and run the tester app
8. On Mac, gatekeeper may complain about running unsigned apps. In such case disable gatekeeper completely or
   1. Press the Cancel button
   2. Open Mac Settings and search for Gatekeeper
   3. Click the button that allows running the cancelled application
   4. Try building the app again, this time you should be able to click Open button instead of Move to bin
   5. Repeat this process until Gatekeeper stops complaining (~20 apps/libs)

Before you begin, you have to install the git client on your computer. Refer to the git documentation for more details about installation.

In order to download project dependencies from the git repository, you will have to create the access token and save it in environment variables:

1. Press the Edit profile button on GitLab (press on your avatar on the navbar and then on the button)
2. Select Access Tokens tab in the menu on the left side
3. Fill the Token name field (e.g. it can be rnoh) and select the api scope in the Select scopes form
4. Press the Create personal access token button to create the token
5. Copy the token

1. Press Win + R to open the Windows Run prompt
2. Type in sysdm.cpl and click Ok
3. Go to the Advanced tab
4. Press on the Environment Variables button
5. Add the new user variable by pressing the New button under the User variables section
6. Set variable name to RNOH_NPM_TOKEN and paste your access token in the variable value field

More details about GitLab access tokens can be found in the docs

1. On the project repository page press the clone button and copy the url to clone the project
2. In your terminal go to the directory where you want to store project files
3. Run the git clone --recurse-submodules <url> command to clone the repository with all submodules (replace the <url> with the copied url from the repository page on GitLab)

1. Go to the react-native-harmony directory
2. Create the package by running the npm pack command
3. Go to the ../tester directory
4. Run the npm i command to install dependencies and setup build-profile
5. Open the /tester/harmony/entry/oh_package.json5 in the DevEco Studio
6. Click "Sync" on the pop-up at the top

Before you start the project, you have to setup the device on which you will be able to run the application. Up to 3.1.0 version of the DevEco Studio IDE, you can create the Local Emulator to test the app on your computer.

1. Open the Device Manager (press the dropdown near the run button (green triangle) on the top ribbon)
2. Press on the Device Manger option on the list
3. Press the Install button to install the emulator SDK
4. Click on the Finish button after installation
5. Press the New emulator button in the bottom right corner
6. Go through the emulator setup. You can customize the emulator settings
7. You will see the success message popup if the emulator is successfully created

1. Open the Device Manager and start the emulator
2. Press the Run entry button in the top ribbon to build the project and run on the emulator
3. Wait for the build to finish

1. Go to the /tester
2. Run npm i
3. Run npm run dev
4. Open /tester/harmony in DevEco Studio
5. Start the HarmonyOS emulator
6. Run hdc rport tcp:8081 tcp:8081 If hdc is not in your PATH, it can be found under <OPEN_HARMONY_SDK>/X86SDK/openharmony/10/toolchains
7. Start metro by running npm run start
8. Build and run entry module

Frame times can be measured using node ./scripts/get-frame-times. It runs hdc hitrace and returns an array (frame times) which contains the time gap between repaints. You can also use it to get the frame times from manually captured traces.

You can use node ./scripts/create-fps-stats to get a performance report based on the measured frame times. node ./scripts/create-fps-stats-flipper file1.csv file2.csv generates the performance report based on one or more .csv files exported from flippers rnperfmonitor plugin, allowing to compare performance to react-native-android.

1. Go to the /react-native-harmony
2. Run npm run pack:prod