From 26bd52f38eddb4fd8396dd7c6ed12393bb3cce6f Mon Sep 17 00:00:00 2001
From: gxzmf <279822581@qq.com>
Date: Fri, 20 Sep 2024 19:58:11 +0800
Subject: [PATCH] =?UTF-8?q?=E6=8F=90=E4=BA=A4=E8=8B=B1=E6=96=87=E6=96=87?=
 =?UTF-8?q?=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: gxzmf <279822581@qq.com>
---
 OAT.xml      |   4 +-
 README.en.md | 139 +++++++++++++++++++++++++--------------------------
 2 files changed, 70 insertions(+), 73 deletions(-)

diff --git a/OAT.xml b/OAT.xml
index 37b7254e6c..a1e1a7950d 100644
--- a/OAT.xml
+++ b/OAT.xml
@@ -143,11 +143,11 @@ used to filter file path.
             <filefilter name="licenseFileNamePolicyFilter" desc="Filters for LICENSE file policies">
             </filefilter>
             <filefilter name="readmeFileNamePolicyFilter" desc="Filters for README file policies">
-                <filteritem type="filepath" name="*README.md|*README.en.md" desc="README文件，不参与编译"/>
+                <filteritem type="filename" name="*README.md|*README.en.md" desc="README文件，不参与编译"/>
             </filefilter>
             <filefilter name="readmeOpenSourcefileNamePolicyFilter"
                 desc="Filters for README.OpenSource file policies">
-                <filteritem type="filepath" name="*README.md|*README.en.md" desc="README文件，不参与编译"/>
+                <filteritem type="filename" name="*README.md|*README.en.md" desc="README文件，不参与编译"/>
             </filefilter>
             <filefilter name="binaryFileTypePolicyFilter" desc="Filters for binary file policies">
                 <filteritem type="filename" name="*.iml|*.json|*.txt" desc="desc files" />
diff --git a/README.en.md b/README.en.md
index 05c88e755f..12a823f553 100644
--- a/README.en.md
+++ b/README.en.md
@@ -1,124 +1,121 @@
 Flutter Engine
 ==============
 
-Original warehouse source: https://github.com/flutter/engine
+Source of the original repository: https://github.com/flutter/engine
 
-## Warehouse description:
-This warehouse is based on the extension of Flutter's official engine warehouse and can build a Flutter engine program that supports running on OpenHarmony devices.
+## Repository Description
+This repository is an extension of the Flutter engine repository. It enables Flutter engine to run on OpenHarmony devices.
 
-## Build instructions:
+## How to Build
 
 * Build environment:
-1. Supports building in Linux and Mac, mainly building gen_snapshot for Window environment;
+1. Linux or macOS that support Flutter engine; Windows that supports **gen_snapshot**.
+2. Access to the **allowed_hosts** field in the DEPS file.
 
-2. Please ensure that the current build environment can access the allowed_hosts field configured in the DEPS file.
+* Build steps:
+1. Set up a basic environment. For details, see the [official document](https://github.com/flutter/flutter/wiki/Setting-up-the-Engine-development-environment).
 
-* Building steps:
-1. Build a basic environment: please refer to the [official](https://github.com/flutter/flutter/wiki/Setting-up-the-Engine-development-environment) website;
-
-   Basic libraries that need to be installed:
+   The following libraries need to be installed:
 
    ```
-    sudo apt install python3
-    sudo apt install pkg-config
-    sudo apt install ninja-build
+   sudo apt install python3
+   sudo apt install pkg-config
+   sudo apt install ninja-build
    ```
 
-   Configure node: Download `node` and unzip it, and configure it into environment variables:
+   Configure `node`. Specifically, download `node`, unzip it, and configure it into environment variables.
 
    ```
-    # nodejs
-    export NODE_HOME=/home/<user>/env/node-v14.19.1-linux-x64
-    export PATH=$NODE_HOME/bin:$PATH
+   # nodejs
+   export NODE_HOME=/home/<user>/env/node-v14.19.1-linux-x64
+   export PATH=$NODE_HOME/bin:$PATH
    ```
 
-   for Window environment: 
-   Refer to [official](https://github.com/flutter/flutter/wiki/Compiling-the-engine#compiling-for-windows)
-   The "Compiling for Windows" section sets up the Windows build environment
+   For Windows:
+   Refer to the section "Compiling for Windows"
+   in the [official document](https://github.com/flutter/flutter/wiki/Compiling-the-engine#compiling-for-windows).
+
 
-2. Configuration file: Create an empty folder engine, create a new `.gclient` file in the engine, and edit the file:
+2. Configure the file. Specifically, create an empty folder **engine**, create the **.gclient** file in this folder, and edit the file.
 
    ```
-    solutions = [
-       {
-         "managed": False,
-         "name": "src/flutter",
-         "url": "git@gitee.com:openharmony-sig/flutter_engine.git",
-         "custom_deps": {},
-         "deps_file": "DEPS",
-         "safesync_url": "",
-       },
-    ]
+   solutions = [
+   {
+      "managed": False,
+      "name": "src/flutter",
+      "url": "git@gitee.com:openharmony-sig/flutter_engine.git",
+      "custom_deps": {},
+      "deps_file": "DEPS",
+      "safesync_url": "",
+   },
+   ]
    ```
 
-3. Synchronize code: In the engine directory, execute `gclient sync`; here the engine source code, official packages repository will be synchronized, and the ohos_setup task will be executed;
+3. Synchronize the code. In the **engine** directory, execute `gclient sync`. The engine source code and packages repository will be synchronized, and the **ohos_setup** task will be executed.
 
-4. Download sdk: From [OpenHarmony SDK]（https://developer.huawei.com/consumer/cn/develop）Download the matching development tool,Suites that are not downloaded through this channel are not supported
+4. Download the SDK. Download the supporting development kits from [HarmonyOS SDK](https://developer.huawei.com/consumer/en/develop). Suites downloaded from other platforms are not supported.
 
    ```sh
-    # Environment variables that need to be set: HarmonyOS SDK, ohpm, hvigor, node
-    export TOOL_HOME=/Applications/DevEco-Studio.app/Contents # For mac
-    export DEVECO_SDK_HOME=$TOOL_HOME/sdk # command-line-tools/sdk
-    export PATH=$TOOL_HOME/tools/ohpm/bin:$PATH # command-line-tools/ohpm/bin
-    export PATH=$TOOL_HOME/tools/hvigor/bin:$PATH # command-line-tools/hvigor/bin
-    export PATH=$TOOL_HOME/tools/node/bin:$PATH # command-line-tools/tool/node/bin
+   # Environment variables to set: HarmonyOS SDK, ohpm, hvigor, and node.
+   export TOOL_HOME=/Applications/DevEco-Studio.app/Contents # macOS environment
+   export DEVECO_SDK_HOME=$TOOL_HOME/sdk # command-line-tools/sdk
+   export PATH=$TOOL_HOME/tools/ohpm/bin:$PATH # command-line-tools/ohpm/bin
+   export PATH=$TOOL_HOME/tools/hvigor/bin:$PATH # command-line-tools/ hvigor/bin
+   export PATH=$TOOL_HOME/tools/node/bin:$PATH # command-line-tools/tool/node/bin
    ```
 
-5. Start building: In the engine directory, execute `./ohos` to start building the flutter engine that supports ohos devices.
+5. Start building. In the **engine** directory, execute `./ohos` to start building the Flutter engine that supports ohos devices.
    
-6. Update code: In the engine directory, execute `./ohos -b master`
+6. Update the code. In the **engine** directory, execute `./ohos -b master`.
 
-## Engine Construction product
+## Engine Build Products
 
-  [Construction product](https://docs.qq.com/sheet/DUnljRVBYUWZKZEtF?tab=BB08J2)
+  See [Build Products](https://docs.qq.com/sheet/DUnljRVBYUWZKZEtF?tab=BB08J2).
 
-## FAQ:
-1. When running the project, an error of Member notfound:'isOhos' is reported: Please ensure that all dart patches are applied in the src/third_party/dart directory (the patches are located in the src/flutter/attachment/repos directory, and you can use git apply to apply the patch). Recompile the engine after patching
+## FAQs
+1. The message `Member notfound:'isOhos'` is reported during project running.<br>Install all dart patches in the **src/third_party/dart** directory. (The patches are located in the **src/flutter/attachment/repos** directory, and you can use **git apply** to apply the patches). Recompile the engine after installing the patches.
 
-2. Prompt Permission denied: Execute chmod +x <script file> to add execution permissions
+2. The message `Permission denied` is reported.<br>Execute `chmod +x < script file >` to add the execution permission.
 
-3. Compile the engine in debug/release/profile mode separately: `./ohos -t debug|release|profile`
+3. To compile the engine in debug, release, or profile mode, execute `./ohos -t debug`, `./ohos -t release`, or `./ohos -t profile`, respectively.
 
-4. See help: `./ohos -h`
+4. To find the help, execute `./ohos -h`.
 
-5. Due to the different ways Windows, macOS, and Linux handle line endings, applying Dart patches can result in different Dart VM snapshot hash values. You can obtain the current snapshot hash value using the following method:
+5. Different ways for handling newline characters by Windows, macOS, and Linux will cause different results of **dart vm snapshot hash** when installing the dart patches. You can obtain the value of **snapshot hash** through the following method:
 
    ```shell
-    python xxx/src/third_party/dart/tools/make_version.py --format='{{SNAPSHOT_HASH}}'
+   python xxx/src/third_party/dart/tools/make_version.py --format='{{SNAPSHOT_HASH}}'
    ```
 
-   Here, xxx is the engine path you created yourself.
-
-   If the obtained value is not “8af474944053df1f0a3be6e6165fa7cf”, then you need to check whether the xxx/src/third_party/dart/runtime/vm/dart.cc file and xxx/src/third_party/dart/runtime/vm/image_snapshot.cc file in the end of all lines is not with LF, windows can use notepad++ to view, other system specific methods please inquire
+   Here, **xxx** is the engine path you created.
 
+   If the obtained value is not **8af474944053df1f0a3be6e6165fa7cf**, check whether all lines of the **xxx/src/third_party/dart/runtime/vm/dart.cc** file and the **xxx/src/third_party/dart/runtime/vm/image_snapshot.cc** file end with **LF**. For Windows, you can use **Notepad++** to check; for other systems, consult specific methods on your own.
 
 
-## Embedding layer code construction guide
+## Code Building at the Embedding Layer
 
-1. Edit shell/platform/ohos/flutter_embedding/local.properties:
+1. Edit **shell/platform/ohos/flutter_embedding/local.properties** as follows:
 
    ```
-    sdk.dir=<OpenHarmony sdk directory>
-    nodejs.dir=<nodejs sdk directory>
+   sdk.dir=<OpenHarmony SDK directory>
+   nodejs.dir=<nodejs SDK directory>
    ```
 
-2. You need to copy files from the compiled `engine` directory to `shell/platform/ohos/flutter_embedding/flutter/libs/arm64-v8a/`
-    1. debug/release，copy `libflutter.so`
-    2. profile，copy `libflutter.so` and `libvmservice_snapshot.so`
-
-3. In the shell/platform/ohos/flutter_embedding directory, execute
-
-     ```
-      # The optional values for buildMode are: debug release profile
-      hvigorw --mode module -p module=flutter@default -p product=default -p buildMode=debug assembleHar --no-daemon
-     ```
+2. Copy the file to `shell/platform/ohos/flutter_embedding/flutter/libs/arm64-v8a/` from the built `engine` directory.
+    1. For the debug or release version, copy `libflutter.so`.
+    2. For the profile version, copy `libflutter.so` and `libvmservice_snapshot.so`.
 
+3. In the **shell/platform/ohos/flutter_embedding** directory, execute the following instruction:
 
+    ```
+   # buildMode can be set to debug, release, or profile.
+   hvigorw --mode module -p module=flutter@default -p product=default -p buildMode=debug assembleHar --no-daemon
+    ```
 
-4. The har file output path is: shell/platform/ohos/flutter_embedding/flutter/build/default/outputs/default/flutter.har
+4. Find the HAR file from the path `shell/platform/ohos/flutter_embedding/flutter/build/default/outputs/default/flutter.har`.
 
-5. After obtaining the har file, rename the file according to `flutter.har.BUILD_TYPE.API` format, where `BUILD_TYPE` refers to 'debug', 'release' and 'profile', and 'API' refers to the current SDK version, such as api11 is 11;  For example, if the debug version of api11 is currently built, rename it to `flutter.har.debug.11`.
+5. Rename the HAR file in the `flutter.har.BUILD_TYPE.API` format, where `BUILD_TYPE` indicates `debug`, `release`, or `profile`, and `API` indicates the current SDK version (for example, 11 indicates API version 11). For example, to build a debug version of API version 11, rename the file `flutter.har.debug.11`.
 
-6. Replace the corresponding file in the `flutter_flutter/packages/flutter_tools/templates/app_shared/ohos.tmpl/har/har_product.tmpl/` directory and run the project again to make the project take effect.
+6. Replace the corresponding file in the `flutter_flutter/packages/flutter_tools/templates/app_shared/ohos.tmpl/har/har_product.tmpl/` directory and execute the project again for the modification to take effect.
 
-ps: If you are using the Beta version of DevEco Studio and encounter the error "must have required property 'compatibleSdkVersion', location: build-profile.json5:17:11" when compiling the project, Modify the shell/platform/ohos/flutter_embedding/hvigor/hvigor-config.json5 file by referring to section ‘6 Create the project and run Hello World’ [Configuration Plug-in] in《DevEco Studio Environment configuration guide.docx》.
\ No newline at end of file
+If you are using DevEco Studio of a Beta version and encounter the error message `must have required property 'compatibleSdkVersion', location: build-profile.json5:17:11` when building the project, refer to the section "Configuring Plugins" in chapter 6 "Creating a Project and Runing Hello World" of *DevEco Studio Environment Setup.docx* to modify the **shell/platform/ohos/flutter_embedding/hvigor/hvigor-config.json5** file.
-- 
Gitee