core: Add HarmonyOS platform

.bazelignore

@@ -4,6 +4,7 @@ bazel-out
 bazel-bin
 bazel-testlogs
 .cache
+.pixi
 .idea
 .vscode
 .cxx

.github/workflows/ohos-ci.yml

@@ -0,0 +1,120 @@
+name: ohos-ci
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+      - ohos-*.*.x
+    paths:
+      - CMakeLists.txt
+      - CMakePresets.json
+      - "platform/default/**"
+      - "platform/linux/**"
+      - "platform/ohos/**"
+      - ".github/workflows/ohos-ci.yml"
+      - "bin/**"
+      - "expression-test/**"
+      - "include/**"
+      - "metrics/**"
+      - "render-test/**"
+      - "scripts/**"
+      - "src/**"
+      - "test/**"
+      - "vendor/**"
+      - ".gitmodules"
+      - "!**/*.md"
+
+  pull_request:
+    branches:
+      - "*"
+    paths:
+      - CMakeLists.txt
+      - CMakePresets.json
+      - "platform/default/**"
+      - "platform/linux/**"
+      - "platform/ohos/**"
+      - ".github/workflows/ohos-ci.yml"
+      - "bin/**"
+      - "expression-test/**"
+      - "include/**"
+      - "metrics/**"
+      - "render-test/**"
+      - "scripts/**"
+      - "src/**"
+      - "test/**"
+      - "vendor/**"
+      - ".gitmodules"
+      - "!**/*.md"
+
+concurrency:
+  # cancel jobs on PRs only
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.ref != 'refs/heads/main' }}
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - name: OpenGL
+            preset: harmonyos-opengl
+          - name: Vulkan
+            preset: harmonyos-vulkan
+    name: ${{ matrix.name }}
+    env:
+      OHOS_SDK_VERSION: "6.1"
+
+    defaults:
+      run:
+        working-directory: ./
+        shell: bash
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v4
+        with:
+          submodules: recursive
+          persist-credentials: false
+
+      - name: Install dependencies
+        env:
+          DEBIAN_FRONTEND: noninteractive
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            ccache \
+            ninja-build
+          /usr/sbin/update-ccache-symlinks
+
+      - name: Set up OpenHarmony SDK
+        uses: openharmony-rs/setup-ohos-sdk@eb82b94ef522b07269679195c2512f22e922ef3b # v1.0.0
+        with:
+          version: ${{ env.OHOS_SDK_VERSION }}
+          components: native
+
+      - name: Set up ccache
+        uses: hendrikmuhs/ccache-action@33522472633dbd32578e909b315f5ee43ba878ce # v1.2.22
+        with:
+          key: OHOS_${{ matrix.preset }}_${{ env.OHOS_SDK_VERSION }}_${{ github.sha }}
+          restore-keys: |
+            OHOS_${{ matrix.preset }}_${{ env.OHOS_SDK_VERSION }}_${{ github.ref }}
+            OHOS_${{ matrix.preset }}_${{ env.OHOS_SDK_VERSION }}
+          max-size: 200M
+
+      - name: Print tool versions
+        run: |
+          cmake --version
+          ninja --version
+          "${OHOS_SDK_NATIVE}/llvm/bin/clang" --version
+
+      - name: Configure maplibre-native
+        run: |
+          cmake --preset "${{ matrix.preset }}" \
+            -DCMAKE_C_COMPILER_LAUNCHER="ccache" \
+            -DCMAKE_CXX_COMPILER_LAUNCHER="ccache"
+
+      - name: Build mbgl-core
+        run: cmake --build --preset "${{ matrix.preset }}"

CMakeLists.txt

@@ -35,6 +35,16 @@ endif()
 
 project("MapLibre Native" LANGUAGES CXX C)
 
+if(CMAKE_SYSTEM_NAME STREQUAL OHOS)
+    # The OHOS SDK toolchain injects --gcc-toolchain, which clang reports as unused.
+    # OHOS SDK 6.0.1 ships libc++ ranges algorithms behind -fexperimental-library.
+    add_compile_options(
+        $<$<COMPILE_LANGUAGE:C>:-Wno-unused-command-line-argument>
+        $<$<COMPILE_LANGUAGE:CXX>:-Wno-unused-command-line-argument>
+        $<$<COMPILE_LANGUAGE:CXX>:-fexperimental-library>
+    )
+endif()
+
 set_property(GLOBAL PROPERTY USE_FOLDERS ON)
 set_property(GLOBAL PROPERTY PREDEFINED_TARGETS_FOLDER MapLibre)
 
@@ -954,6 +964,7 @@ list(APPEND SRC_FILES
     ${PROJECT_SOURCE_DIR}/src/mbgl/util/quaternion.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/util/rapidjson.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/util/rapidjson.hpp
+    ${PROJECT_SOURCE_DIR}/src/mbgl/util/source_location.hpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/util/std.hpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/util/stopwatch.cpp
     ${PROJECT_SOURCE_DIR}/src/mbgl/util/stopwatch.hpp
@@ -1275,6 +1286,8 @@ elseif(CMAKE_SYSTEM_NAME STREQUAL Android)
     include(${PROJECT_SOURCE_DIR}/platform/android/android.cmake)
 elseif(CMAKE_SYSTEM_NAME STREQUAL Linux)
     include(${PROJECT_SOURCE_DIR}/platform/linux/linux.cmake)
+elseif(CMAKE_SYSTEM_NAME STREQUAL OHOS)
+    include(${PROJECT_SOURCE_DIR}/platform/ohos/ohos.cmake)
 elseif(CMAKE_SYSTEM_NAME STREQUAL Darwin)
     include(${PROJECT_SOURCE_DIR}/platform/darwin/darwin.cmake)
     include(${PROJECT_SOURCE_DIR}/platform/macos/macos.cmake)

CMakePresets.json

@@ -249,6 +249,46 @@
         "CMAKE_CXX_COMPILER_LAUNCHER": "ccache"
       }
     },
+    {
+      "name": "harmonyos",
+      "hidden": true,
+      "generator": "Ninja",
+      "binaryDir": "${sourceDir}/build-harmonyos",
+      "condition": {
+        "type": "notEquals",
+        "lhs": "$env{OHOS_SDK_NATIVE}",
+        "rhs": ""
+      },
+      "cacheVariables": {
+        "CMAKE_TOOLCHAIN_FILE": "$env{OHOS_SDK_NATIVE}/build/cmake/ohos.toolchain.cmake",
+        "OHOS_SDK_NATIVE": "$env{OHOS_SDK_NATIVE}",
+        "OHOS_ARCH": "arm64-v8a",
+        "OHOS_STL": "c++_shared",
+        "CMAKE_BUILD_TYPE": "RelWithDebInfo",
+        "MLN_WITH_GLFW": "OFF",
+        "MLN_WITH_OPENGL": "ON",
+        "MLN_WITH_EGL": "ON"
+      }
+    },
+    {
+      "name": "harmonyos-opengl",
+      "inherits": "harmonyos",
+      "binaryDir": "${sourceDir}/build-harmonyos-opengl",
+      "displayName": "HarmonyOS OpenGL",
+      "description": "OpenHarmony GLES/EGL and NetworkKit HTTP build"
+    },
+    {
+      "name": "harmonyos-vulkan",
+      "inherits": "harmonyos",
+      "binaryDir": "${sourceDir}/build-harmonyos-vulkan",
+      "displayName": "HarmonyOS Vulkan",
+      "description": "OpenHarmony Vulkan and NetworkKit HTTP build",
+      "cacheVariables": {
+        "MLN_WITH_OPENGL": "OFF",
+        "MLN_WITH_EGL": "OFF",
+        "MLN_WITH_VULKAN": "ON"
+      }
+    },
     {
       "name": "windows",
       "hidden": true,
@@ -377,6 +417,27 @@
       "configurePreset": "linux-vulkan",
       "targets": ["mbgl-core"]
     },
+    {
+      "name": "harmonyos-build",
+      "hidden": true,
+      "condition": {
+        "type": "notEquals",
+        "lhs": "$env{OHOS_SDK_NATIVE}",
+        "rhs": ""
+      }
+    },
+    {
+      "name": "harmonyos-opengl",
+      "inherits": "harmonyos-build",
+      "configurePreset": "harmonyos-opengl",
+      "targets": ["mbgl-core"]
+    },
+    {
+      "name": "harmonyos-vulkan",
+      "inherits": "harmonyos-build",
+      "configurePreset": "harmonyos-vulkan",
+      "targets": ["mbgl-core"]
+    },
     {
       "name": "windows-opengl-core",
       "configurePreset": "windows-opengl",

platform/linux/src/gl_functions.cpp

@@ -3,7 +3,6 @@
 #define GL_GLEXT_PROTOTYPES
 
 #include <GLES3/gl3.h>
-#include <GLES3/gl3ext.h>
 
 namespace mbgl {
 namespace platform {

platform/ohos/README.md

@@ -0,0 +1,32 @@
+# OpenHarmony
+
+This platform support is experimental. It targets the
+[OpenHarmony](https://en.wikipedia.org/wiki/OpenHarmony) family of operating
+systems, including [HarmonyOS](https://en.wikipedia.org/wiki/HarmonyOS).
+
+Public OpenHarmony platform documentation is available in the
+[OpenHarmony docs repository](https://github.com/openharmony/docs).
+
+See [the sample readme](./sample/README.md) to build and run the NAPI/XComponent
+integration example in DevEco Studio.
+
+## CMake Build
+
+When invoking CMake directly from this repository root, set the native SDK paths
+before using the HarmonyOS presets:
+
+```sh
+export OHOS_SDK_NATIVE=/path/to/openharmony/native
+
+cmake --preset harmonyos-opengl
+cmake --build --preset harmonyos-opengl
+
+cmake --preset harmonyos-vulkan
+cmake --build --preset harmonyos-vulkan
+```
+
+The presets use the OpenHarmony SDK from `OHOS_SDK_NATIVE`. They are disabled
+until that variable is set.
+
+DevEco Studio and Hvigor provide the native SDK path from the configured SDK
+when building `platform/ohos/sample`.