Merge pull request 'develop' (#5) from develop into main

Reviewed-on: #5

.gitea/workflows/release.yml

@@ -0,0 +1,128 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-builder
+    strategy:
+      fail-fast: false
+      matrix:
+        target:
+          - name: linux-amd64
+            toolchain: ""
+            cmake_extra: ""
+          - name: linux-arm64
+            toolchain: -DCMAKE_TOOLCHAIN_FILE=cmake/toolchain-linux-arm64.cmake
+            cmake_extra: ""
+          - name: linux-armhf
+            toolchain: -DCMAKE_TOOLCHAIN_FILE=cmake/toolchain-linux-armhf.cmake
+            cmake_extra: ""
+          - name: windows-amd64
+            toolchain: -DCMAKE_TOOLCHAIN_FILE=cmake/toolchain-windows-amd64.cmake
+            cmake_extra: -DBUILD_EXAMPLES=OFF -DBUILD_TESTING=OFF
+          - name: baremetal-arm32
+            toolchain: -DCMAKE_TOOLCHAIN_FILE=cmake/toolchain-baremetal-arm32.cmake
+            cmake_extra: -DBUILD_EXAMPLES=OFF -DBUILD_TESTING=OFF -DBUILD_SHARED=OFF
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install cross-compilers
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            gcc-arm-linux-gnueabihf \
+            gcc-aarch64-linux-gnu \
+            gcc-mingw-w64-x86-64 \
+            gcc-arm-none-eabi
+
+      - name: Configure
+        run: cmake -S . -B build -DBUILD_TESTING=OFF ${{ matrix.target.toolchain }} ${{ matrix.target.cmake_extra }}
+
+      - name: Build
+        run: cmake --build build
+
+      - name: Run tests
+        if: matrix.target.name == 'linux-amd64'
+        run: ctest --test-dir build
+
+      - name: Package
+        run: |
+          PKG="datarouter-${{ matrix.target.name }}"
+          mkdir -p "dist/$PKG"
+          cp datarouter.h datarouter_config_template.h LICENSE README.md "dist/$PKG/"
+          cp build/libDataRouter.a      "dist/$PKG/" 2>/dev/null || true
+          cp build/libDataRouter.so     "dist/$PKG/" 2>/dev/null || true
+          cp build/libDataRouter.dll    "dist/$PKG/" 2>/dev/null || true
+          cp build/libDataRouter.dll.a  "dist/$PKG/" 2>/dev/null || true
+          cp build/example              "dist/$PKG/" 2>/dev/null || true
+          cp build/example.exe          "dist/$PKG/" 2>/dev/null || true
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: datarouter-${{ matrix.target.name }}
+          path: dist/datarouter-${{ matrix.target.name }}
+
+  release:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Verify merge commit
+        run: |
+          PARENTS=$(git log --format="%P" -1 | wc -w)
+          if [ "$PARENTS" -lt 2 ]; then
+            echo "Not a merge commit. Skipping release."
+            exit 78
+          fi
+
+      - name: Read tag from HEAD
+        id: tag
+        run: |
+          TAG=$(git tag --points-at HEAD | grep '^v' | head -n1)
+          if [ -z "$TAG" ]; then
+            echo "No v* tag on HEAD. Create a tag manually, then merge."
+            exit 78
+          fi
+          echo "tag=$TAG" >> "$GITHUB_OUTPUT"
+
+      - uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+
+      - name: Create release & upload assets via Gitea API
+        env:
+          GITEA_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          TAG="${{ steps.tag.outputs.tag }}"
+          SERVER="${GITHUB_SERVER_URL:-https://git.7iwind.cn}"
+          GITEA_API="${SERVER}/api/v1/repos/${GITHUB_REPOSITORY}/releases"
+
+          echo "=== Create release for tag ${TAG} ==="
+          RESP=$(curl -s -X POST \
+            -H "Authorization: token ${GITEA_TOKEN}" \
+            -H "Content-Type: application/json" \
+            -d "{\"tag_name\":\"${TAG}\",\"name\":\"DataRouter ${TAG}\",\"body\":\"## DataRouter ${TAG}\\n\\n合并 develop → main 后自动构建发布。\"}" \
+            "${GITEA_API}")
+
+          ID=$(echo "$RESP" | python3 -c "import sys,json;print(json.load(sys.stdin)['id'])")
+          echo "Release ID: ${ID}"
+
+          for dir in artifacts/*/; do
+            name="$(basename "$dir").tar.gz"
+            tar czf "/tmp/${name}" -C "$dir" .
+            echo "Uploading ${name} ..."
+            curl -s -X POST \
+              -H "Authorization: token ${GITEA_TOKEN}" \
+              -H "Content-Type: application/octet-stream" \
+              --data-binary @"/tmp/${name}" \
+              "${GITEA_API}/${ID}/assets?name=${name}"
+          done

CMakeLists.txt

@@ -3,17 +3,25 @@ project(DataRouter C)
 
 set(CMAKE_C_STANDARD 11)
 
+# ======== 静态库 ========
 add_library(DataRouter STATIC datarouter.c)
-
-# 将库源码目录暴露给使用者，使其可通过 #include <datarouter_config.h>
-# 从自身 include path 覆盖默认配置。如果使用者未提供，则回退到库自带版本。
 target_include_directories(DataRouter PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})
 
+# ======== 共享库（可选，通过 BUILD_SHARED 控制） ========
+option(BUILD_SHARED "Build shared library" ON)
+if(BUILD_SHARED)
+    add_library(DataRouter_shared SHARED datarouter.c)
+    target_include_directories(DataRouter_shared PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})
+    set_target_properties(DataRouter_shared PROPERTIES OUTPUT_NAME DataRouter)
+endif()
+
+# ======== 示例程序 ========
 if(BUILD_EXAMPLES OR NOT DEFINED BUILD_EXAMPLES)
     add_executable(example example.c)
     target_link_libraries(example DataRouter)
 endif()
 
+# ======== 测试 ========
 if(BUILD_TESTING OR NOT DEFINED BUILD_TESTING)
     enable_testing()
     add_executable(test_datarouter tests/test_datarouter.c)

cmake/toolchain-baremetal-arm32.cmake

@@ -0,0 +1,7 @@
+set(CMAKE_SYSTEM_NAME Generic)
+set(CMAKE_SYSTEM_PROCESSOR arm)
+set(CMAKE_C_COMPILER arm-none-eabi-gcc)
+set(CMAKE_TRY_COMPILE_TARGET_TYPE STATIC_LIBRARY)
+set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
+set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
+set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)

cmake/toolchain-linux-arm64.cmake

@@ -0,0 +1,6 @@
+set(CMAKE_SYSTEM_NAME Linux)
+set(CMAKE_SYSTEM_PROCESSOR aarch64)
+set(CMAKE_C_COMPILER aarch64-linux-gnu-gcc)
+set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
+set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
+set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)

cmake/toolchain-linux-armhf.cmake

@@ -0,0 +1,6 @@
+set(CMAKE_SYSTEM_NAME Linux)
+set(CMAKE_SYSTEM_PROCESSOR arm)
+set(CMAKE_C_COMPILER arm-linux-gnueabihf-gcc)
+set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
+set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
+set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)

cmake/toolchain-windows-amd64.cmake

@@ -0,0 +1,6 @@
+set(CMAKE_SYSTEM_NAME Windows)
+set(CMAKE_SYSTEM_PROCESSOR amd64)
+set(CMAKE_C_COMPILER x86_64-w64-mingw32-gcc)
+set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
+set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
+set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)