Update Emscripten's minimum version requirement and related documenta…

…tion. (#312)

.github/workflows/build.yml

@@ -154,7 +154,7 @@ jobs:
           path: |
             web/emsdk
             web/node_modules
-          key: tgfx-environment-web-20231130
+          key: tgfx-environment-web-20241106
           restore-keys: tgfx-environment-web-
 
       - name: Get Third-Party Cache
@@ -171,10 +171,16 @@ jobs:
         run: |
           cd web
           npm install
-          git clone https://github.com/emscripten-core/emsdk.git
+          if [ ! -d "emsdk" ]; then
+            git clone https://github.com/emscripten-core/emsdk.git
+          else
+            cd emsdk
+            git pull
+            cd ..
+          fi
           cd emsdk
-          ./emsdk install 3.1.20
-          ./emsdk activate 3.1.20
+          ./emsdk install 3.1.71
+          ./emsdk activate 3.1.71
         shell: bash
 
       - name: Run depsync
@@ -196,7 +202,7 @@ jobs:
           path: |
             web/emsdk
             web/node_modules
-          key: tgfx-environment-web-20231130
+          key: tgfx-environment-web-20241106
 
       - name: Save Third-Party Cache
         if: ${{ (github.event_name == 'push') && (steps.third-party-cache.outputs.cache-hit != 'true') }}

README.md

@@ -57,7 +57,7 @@ TGFX utilizes the **C++17** features for development. Below are the minimum tool
 - CMake 3.13.0+
 - QT 5.13.0+
 - NDK 19.2+ (**19.2.5345600 recommended**)
-- Emscripten 3.1.20+ (**3.1.20 recommended**)
+- Emscripten 3.1.58+ 
 
 
 Please pay attention to the following additional notices:
@@ -207,12 +207,11 @@ At last, launch XCode and open the `mac/Hello2D.xcworkspace`. You'll be ready to
 ### Web
 
 The web demo project requires the **Emscripten SDK**. You can download and install
-it from the [official website](https://emscripten.org/). We recommend using the **3.1.20** version,
-which has been fully tested with the tgfx library. If you are on macOS, you can also install it
-using the following script:
+it from the [official website](https://emscripten.org/). We recommend using the latest version. 
+If you are on macOS, you can also install it using the following script:
 
 ```
-web/script/install-emscripten.sh
+brew install emscripten
 ```
 
 To begin, navigate to the `web/` directory and execute the following command to install the 
@@ -251,6 +250,14 @@ npm run build:debug
 
 With these steps completed, you will be able to debug C++ files directly within Chrome DevTools.
 
+The above commands will build and run a single-threaded version. To build a multithreaded version, 
+just add the suffix ":mt" to each command. For example:
+```
+npm run build:mt
+npm run build:mt:debug
+npm run serser:mt
+``` 
+
 To build the demo project in CLion, please Open the `Settings` panel in CLion and go to 
 `Build, Execution, Deployment` > `CMake`. Create a new build target. And then set the `CMake options`
 to the following value:

src/layers/Layer.cpp

@@ -268,6 +268,9 @@ std::shared_ptr<Layer> Layer::removeChildAt(int index) {
 }
 
 void Layer::removeChildren(int beginIndex, int endIndex) {
+  if (_children.empty()) {
+    return;
+  }
   if (beginIndex < 0 || static_cast<size_t>(beginIndex) >= _children.size()) {
     LOGE("The supplied beginIndex is out of bounds.");
     return;

sync_deps.sh

@@ -6,7 +6,7 @@ cd $(dirname $0)
 if [[ `uname` == 'Darwin' ]]; then
   if [ ! $(which emcc) ]; then
       echo "emscripten not found. Trying to install..."
-      ./web/script/install-emscripten.sh
+      brew install emscripten
   fi
 fi
 

web/.gitignore

@@ -4,8 +4,10 @@ types
 *.js.map
 demo/*.js
 demo/wasm
+demo/wasm-mt
 demo/build-hello2d
 demo/.hello2d.wasm.md5
+demo/.hello2d.wasm-mt.md5
 src/wasm
 emsdk/
 

web/package.json

@@ -8,7 +8,7 @@
   "typings": "types/tgfx.d.ts",
   "scripts": {
     "clean:tgfx": "rimraf lib/ types/",
-    "clean": "npm run clean:tgfx && rimraf demo/build demo/wasm demo/*.md5 demo/*.js demo/*.map demo/cmake-build-*",
+    "clean": "npm run clean:tgfx && rimraf demo/build demo/wasm demo/wasm-mt demo/.*.md5 demo/*.js demo/*.map demo/cmake-build-*",
     "build:tgfx": "npm run clean:tgfx && tsc -p ./tsconfig.type.json && rollup -c ./script/rollup.tgfx.js",
     "build": "node script/cmake.demo.js -a wasm && npm run build:tgfx && rollup -c ./script/rollup.demo.js",
     "build:debug": "node script/cmake.demo.js -a wasm --debug && npm run build:tgfx && rollup -c ./script/rollup.demo.js",