From 3822d8169a57b9ef76f2c83157524c92f51c97e9 Mon Sep 17 00:00:00 2001
From: BZLZHH <admin@bzlzhh.top>
Date: Fri, 2 Jan 2026 18:27:24 +0800
Subject: [PATCH] [Docs] (README): Better build instructions.

---
 README.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/README.md b/README.md
index d602dc5c..43af99b4 100644
--- a/README.md
+++ b/README.md
@@ -76,8 +76,30 @@ If you want to try the project right now, you’ll need to build it yourself:
    cmake --build build
    ```
    
+   or do it in a modern way:
+   
+   ```sh
+   cmake -S . -B build -G Ninja -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++
+   cmake --build build
+   ```
+   
    Alternatively, you can use platform-specific build commands as needed.
 
+## Build Options
+
+| Option                       | Description                                           | Default |
+| ---------------------------- | ----------------------------------------------------- | ------- |
+| `MOBILEGL_BUILD_TEST`        | Build MobileGL tests (requires Clang)                 | ON      |
+| `MOBILEGL_BUILD_BENCHMARK`   | Build MobileGL benchmarks (requires Clang)            | ON      |
+| `MOBILEGL_FORCE_RELEASE_OPT` | Enable O3 and LTO in Debug build                      | ON      |
+| `MOBILEGL_ENABLE_TRANCY`     | Enable Tracy profiler for performance analysis        | OFF     |
+
+   **Notes:**
+
+* The project requires C++23.
+* `MG_Test` and `MG_Benchmark` can only be built with Clang, not GCC. To enforce Clang, use `-DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++`.
+* On Android, tests and benchmarks are always disabled.
+
 ## Notice
 
 * MobileGL is **not** production-ready currently.