add loongarch64 CI (#975)

Author: Xiao-Tao

.github/workflows/ubuntu-loongarch64.yml

@@ -0,0 +1,52 @@
+name: Ubuntu LoongArch64 (GCC 14)
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+    paths-ignore:
+      - '**.md'
+      - 'docs/**'
+  push:
+    branches:
+      - main
+    paths-ignore:
+      - '**.md'
+      - 'docs/**'
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  ubuntu-build:
+    strategy:
+      fail-fast: false
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+      - name: Setup ENV
+        run: |
+          sudo apt-get update -y
+          sudo apt-get install -y cmake curl ninja-build \
+                                  g++-14-loongarch64-linux-gnu \
+                                  gcc-14-loongarch64-linux-gnu-base \
+                                  gcc-14-loongarch64-linux-gnu
+          sudo curl -L https://github.com/loongson/build-tools/releases/download/2025.06.06/qemu-loongarch64 --output /usr/local/bin/qemu-loongarch64
+          sudo chmod +x /usr/local/bin/qemu-loongarch64
+      - name: Build
+        run: |
+          export QEMU_LD_PREFIX="/usr/loongarch64-linux-gnu"
+          export QEMU_CPU="la464"
+          cmake -DCMAKE_TOOLCHAIN_FILE=cmake/toolchains-dev/loongarch64.cmake \
+                -DADA_TESTING=ON \
+                -DADA_USE_SIMDUTF=ON \
+                -DCMAKE_BUILD_TYPE=Release \
+                -G Ninja -B build
+          cmake --build build -j=4
+      - name: Test
+        run: |
+          export QEMU_LD_PREFIX="/usr/loongarch64-linux-gnu"
+          export QEMU_CPU="la464"
+          ctest --output-on-failure --test-dir build

cmake/add-cpp-test.cmake

@@ -41,7 +41,11 @@ function(add_cpp_test TEST_NAME)
     )
     set_target_properties(${TEST_NAME} PROPERTIES EXCLUDE_FROM_ALL TRUE EXCLUDE_FROM_DEFAULT_BUILD TRUE)
   else()
-    add_test(${TEST_NAME} ${TEST_NAME})
+    if (CMAKE_CROSSCOMPILING_EMULATOR)
+      add_test(${TEST_NAME} ${CMAKE_CROSSCOMPILING_EMULATOR} ${TEST_NAME})
+    else()
+      add_test(${TEST_NAME} ${TEST_NAME})
+    endif()
 
     # Add to <label>_tests make targets
     foreach(label ${ARGS_LABELS})

cmake/toolchains-dev/README.md

@@ -0,0 +1,29 @@
+# LoongArch64
+You can now build and run the LoongArch64 code as needed:
+GCC >= 14.1
+Binutils >= 2.41
+QEMU >= 9.2
+
+Note that the compiler may be named `loongarch64-linux-gnu-g++`, without the `unknown` part.
+Please adjust to your system.
+
+```
+$ sudo curl -L https://github.com/loongson/build-tools/releases/download/2025.06.06/qemu-loongarch64 --output /opt/qemu-loongarch64
+$ sudo chmod +x /opt/qemu-loongarch64
+$ export PATH=/opt:$PATH
+
+$ export QEMU_LD_PREFIX="/usr/loongarch64-linux-gnu" # ubuntu 24.04
+$ export QEMU_CPU="la464"
+$ mkdir build && cd build
+$ cmake -DCMAKE_TOOLCHAIN_FILE=cmake/toolchains-dev/loongarch64.cmake -DADA_TESTING=ON ../
+$ make
+```
+
+Running tests with qemu
+```
+$ make test
+or
+$ ctest --output-on-failure --test-dir build
+or
+$ qemu-loongarch64 build/singleheader/cdemo
+```

cmake/toolchains-dev/loongarch64.cmake

@@ -0,0 +1,22 @@
+# Usage:
+# $ cmake -DCMAKE_TOOLCHAIN_FILE=cmake/toolchains-dev/loongarch64.cmake
+set(CMAKE_SYSTEM_NAME Generic)
+
+#set(target       loongarch64-unknown-linux-gnu)
+set(target       loongarch64-linux-gnu)
+set(version      14)
+set(c_compiler   gcc)
+set(cxx_compiler g++)
+
+set(CMAKE_C_COMPILER   "${target}-${c_compiler}-${version}")
+set(CMAKE_CXX_COMPILER "${target}-${cxx_compiler}-${version}")
+
+set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
+
+set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
+set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
+
+set(LOONGARCH64_ISA "loongarch64")
+set(CMAKE_CROSSCOMPILING_EMULATOR "qemu-${LOONGARCH64_ISA}")
+
+set(CMAKE_CXX_FLAGS "-mlsx")

singleheader/CMakeLists.txt

@@ -78,11 +78,19 @@ if (Python3_Interpreter_FOUND)
     endif()
     target_compile_definitions(demo_no_url_pattern PRIVATE ADA_INCLUDE_URL_PATTERN=0)
 
-    add_test(demo_no_url_pattern demo_no_url_pattern)
+    if (CMAKE_CROSSCOMPILING_EMULATOR)
+      add_test(demo_no_url_pattern ${CMAKE_CROSSCOMPILING_EMULATOR} demo_no_url_pattern)
+    else()
+      add_test(demo_no_url_pattern demo_no_url_pattern)
+    endif()
 
     add_executable(cdemo $<BUILD_INTERFACE:${CMAKE_CURRENT_BINARY_DIR}/demo.c>)
     target_link_libraries(cdemo ada-singleheader-lib)
-    add_test(cdemo cdemo)
+    if (CMAKE_CROSSCOMPILING_EMULATOR)
+      add_test(cdemo ${CMAKE_CROSSCOMPILING_EMULATOR} cdemo)
+    else()
+      add_test(cdemo cdemo)
+    endif()
   endif()
 else()
   MESSAGE( STATUS "Python not found, we are unable to test amalgamate.py." )