Add support for NEON instruction acceleration, optimize the iOS demo, and enable frame rate and resolution switching settings.

.github/workflows/linux-build.yml

@@ -93,8 +93,8 @@ jobs:
   build-ubuntu-clang:
     name: "Build (${{ matrix.build_type }}-clang)"
     runs-on: ubuntu-latest
-    # Only run clang builds on push to main branch
-    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+  # Run clang builds on push to main and on pull requests
+  if: github.event_name == 'pull_request' || (github.event_name == 'push' && github.ref == 'refs/heads/main')
 
     strategy:
       matrix:
@@ -183,11 +183,41 @@ jobs:
               -DCMAKE_SYSTEM_PROCESSOR=aarch64 \
               -DCMAKE_CROSSCOMPILING=ON \
               -DCCAP_BUILD_EXAMPLES=ON \
-              -DCCAP_BUILD_TESTS=OFF
-    
+              -DCCAP_BUILD_TESTS=ON
+
     - name: Build ARM64
       run: cmake --build build/arm64/${{ matrix.build_type }} --config ${{ matrix.build_type }} --parallel $(nproc)
-
+
+    - name: Build ARM64 test target (Release only)
+      if: matrix.build_type == 'Release'
+      run: |
+        cmake --build build/arm64/${{ matrix.build_type }} --config ${{ matrix.build_type }} --target ccap_convert_test --parallel $(nproc)
+
+    - name: Install QEMU for ARM64 test emulation (PRs and main push, Release only)
+      if: (github.event_name == 'pull_request' || (github.event_name == 'push' && github.ref == 'refs/heads/main')) && matrix.build_type == 'Release'
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y qemu-user qemu-user-static
+        qemu-aarch64 --version
+
+    - name: Run ARM64 Unit Tests (PRs and main push, Release only)
+      if: (github.event_name == 'pull_request' || (github.event_name == 'push' && github.ref == 'refs/heads/main')) && matrix.build_type == 'Release'
+      run: |
+        TEST_BIN="build/arm64/${{ matrix.build_type }}/tests/ccap_convert_test"
+        if [ ! -x "$TEST_BIN" ]; then
+          echo "Test binary not found: $TEST_BIN" >&2
+          ls -la "build/arm64/${{ matrix.build_type }}" || true
+          exit 1
+        fi
+        echo "Verifying test binary architecture:"
+        file "$TEST_BIN" || true
+        echo "Running ARM64 unit tests via QEMU..."
+        # Use the ARM64 sysroot provided by the cross toolchain for dynamic libs
+        qemu-aarch64 -L /usr/aarch64-linux-gnu "$TEST_BIN" \
+          --gtest_fail_fast \
+          --gtest_output=xml:build/arm64/${{ matrix.build_type }}/arm64_results.xml
+        echo "✓ ARM64 unit tests finished"
+
     - name: Verify build outputs
       working-directory: build/arm64/${{ matrix.build_type }}
       run: |
@@ -252,7 +282,7 @@ jobs:
       run: |
         cd scripts
         ./run_tests.sh --functional --exit-when-failed
-
+    
     - name: Upload artifacts
       uses: actions/upload-artifact@v4
       with:

.github/workflows/release.yml

@@ -21,7 +21,94 @@ on:
         default: false
 
 jobs:
+  # Run comprehensive tests before building release packages
+  test:
+    name: Run Full Test Suite
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: true  # Stop all jobs if any test fails
+      matrix:
+        include:
+          - os: windows-latest
+            name: Windows Tests
+            test_type: both
+
+          - os: ubuntu-latest  
+            name: Linux Tests
+            test_type: both
+
+          - os: ubuntu-latest
+            name: Linux ARM64 Tests
+            test_type: functional
+            arch: arm64
+
+          - os: macos-latest
+            name: macOS Tests
+            test_type: both
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      with:
+        submodules: recursive
+
+    - name: Setup cross-compilation for ARM64
+      if: matrix.arch == 'arm64'
+      shell: bash
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y gcc-aarch64-linux-gnu g++-aarch64-linux-gnu qemu-user qemu-user-static
+
+    - name: Setup Visual Studio (Windows)
+      if: matrix.os == 'windows-latest'
+      uses: microsoft/setup-msbuild@v1.1
+
+    - name: Install Linux dependencies
+      if: matrix.os == 'ubuntu-latest'
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y cmake build-essential gcc
+        if [ "${{ matrix.test_type }}" = "both" ]; then
+          sudo apt-get install -y libglfw3-dev
+        fi
+
+    - name: Run Tests
+      shell: bash
+      run: |
+        cd scripts
+        echo "=== Running ${{ matrix.name }} ==="
+
+        if [ "${{ matrix.arch }}" = "arm64" ]; then
+          # ARM64 cross-compilation tests
+          echo "Running ARM64 functional tests..."
+          ./run_tests.sh --functional --exit-when-failed
+        elif [ "${{ matrix.test_type }}" = "both" ]; then
+          # Full test suite (functional + performance)
+          echo "Running full test suite..."
+          ./run_tests.sh --functional --exit-when-failed
+          ./run_tests.sh --performance --exit-when-failed  
+        else
+          # Functional tests only
+          echo "Running functional tests..."
+          ./run_tests.sh --functional --exit-when-failed
+        fi
+
+        echo "✅ ${{ matrix.name }} completed successfully!"
+
+    - name: Upload test results
+      if: always()
+      uses: actions/upload-artifact@v4
+      with:
+        name: test-results-${{ matrix.name }}-${{ github.run_id }}
+        path: |
+          build/**/test_results.xml
+          build/**/*_results.xml
+        retention-days: 7
+        if-no-files-found: ignore
+
   build:
+    name: Build Release Packages  
+    needs: test
     strategy:
       fail-fast: false
       matrix:
@@ -34,6 +121,7 @@ jobs:
           - os: windows-latest
             name: Windows
             artifact_name: ccap-msvc-x86_64
+            build_type: Release
 
           - os: ubuntu-latest
             name: Linux
@@ -238,7 +326,7 @@ jobs:
         retention-days: 5
 
   release:
-    needs: build
+    needs: [test, build]
     runs-on: ubuntu-latest
     permissions:
       contents: write
@@ -296,6 +384,16 @@ jobs:
         cat > release_notes.md << 'EOF'
         ## 🚀 ccap ${{ steps.release_type.outputs.tag_name }}
 
+        ### ✅ Quality Assurance
+
+        **All packages have passed comprehensive unit tests before release:**
+        - ✅ **Windows Tests**: Functional and performance tests on Windows platform
+        - ✅ **Linux x86_64 Tests**: Functional and performance tests on Linux
+        - ✅ **Linux ARM64 Tests**: Cross-compiled functional tests with QEMU validation  
+        - ✅ **macOS Tests**: Functional and performance tests on macOS platform
+
+        > **Note**: This release was only created after ALL platform tests passed successfully. Any test failure would have prevented the release.
+
         ### 📦 Downloads
 
         **Supported Platforms:**
@@ -369,13 +467,21 @@ jobs:
         echo "## 🎉 Release Created Successfully!" >> $GITHUB_STEP_SUMMARY
         echo "" >> $GITHUB_STEP_SUMMARY
         echo "**Release**: ${{ steps.release_type.outputs.release_name }}" >> $GITHUB_STEP_SUMMARY
-        echo "**Tag**: ${{ github.ref_name }}" >> $GITHUB_STEP_SUMMARY
+        echo "**Tag**: ${{ steps.release_type.outputs.tag_name }}" >> $GITHUB_STEP_SUMMARY
         echo "**Prerelease**: ${{ steps.release_type.outputs.prerelease }}" >> $GITHUB_STEP_SUMMARY
         echo "" >> $GITHUB_STEP_SUMMARY
+        echo "### ✅ Quality Assurance" >> $GITHUB_STEP_SUMMARY
+        echo "- ✅ **Windows Tests**: All functional and performance tests passed" >> $GITHUB_STEP_SUMMARY
+        echo "- ✅ **Linux x86_64 Tests**: All functional and performance tests passed" >> $GITHUB_STEP_SUMMARY  
+        echo "- ✅ **Linux ARM64 Tests**: Cross-compilation and functional tests passed" >> $GITHUB_STEP_SUMMARY
+        echo "- ✅ **macOS Tests**: All functional and performance tests passed" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "> 🛡️ **This release was only created after ALL tests passed successfully!**" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
         echo "### 📦 Included Files:" >> $GITHUB_STEP_SUMMARY
         echo "- ccap-macos-universal.tar.gz" >> $GITHUB_STEP_SUMMARY
         echo "- ccap-msvc-x86_64.zip (includes Debug and Release versions)" >> $GITHUB_STEP_SUMMARY
         echo "- ccap-linux-x86_64.tar.gz" >> $GITHUB_STEP_SUMMARY
         echo "- ccap-linux-arm64.tar.gz" >> $GITHUB_STEP_SUMMARY
         echo "" >> $GITHUB_STEP_SUMMARY
-        echo "Release page: ${{ github.server_url }}/${{ github.repository }}/releases/tag/${{ github.ref_name }}" >> $GITHUB_STEP_SUMMARY
+        echo "Release page: ${{ github.server_url }}/${{ github.repository }}/releases/tag/${{ steps.release_type.outputs.tag_name }}" >> $GITHUB_STEP_SUMMARY

.gitignore

@@ -3,3 +3,4 @@ build/
 .idea/
 dev.cmake
 /install
+build-*

.vscode/tasks.json

@@ -277,6 +277,37 @@
             "group": "build",
             "problemMatcher": "$gcc"
         },
+        {
+            "label": "Run Shuffle Tests",
+            "type": "shell",
+            "command": "bash",
+            "args": [
+                "-l",
+                "run_tests.sh",
+                "--shuffle"
+            ],
+            "options": {
+                "cwd": "${workspaceFolder}/scripts"
+            },
+            "group": "build",
+            "problemMatcher": "$gcc"
+        },
+        {
+            "label": "Run Shuffle Tests (Fast)",
+            "type": "shell",
+            "command": "bash",
+            "args": [
+                "-l",
+                "run_tests.sh",
+                "--shuffle",
+                "--exit-when-failed"
+            ],
+            "options": {
+                "cwd": "${workspaceFolder}/scripts"
+            },
+            "group": "build",
+            "problemMatcher": "$gcc"
+        },
         {
             "label": "Run All Tests",
             "type": "shell",

CMakeLists.txt

@@ -36,6 +36,45 @@ set(CMAKE_INCLUDE_CURRENT_DIR ON)
 
 set(CMAKE_OSX_DEPLOYMENT_TARGET "10.13" CACHE STRING "Minimum OS X deployment version")
 
+# Unified ARM64 force compilation option, supports both macOS and Windows
+option(CCAP_FORCE_ARM64 "Force ARM64 architecture compilation" OFF)
+
+if(CCAP_FORCE_ARM64)
+    if(APPLE)
+        set(CMAKE_OSX_ARCHITECTURES "arm64" CACHE STRING "Build architectures for Mac OS X" FORCE)
+        message(STATUS "ccap: Forcing ARM64 architecture compilation for macOS")
+    elseif(WIN32)
+        set(CMAKE_GENERATOR_PLATFORM "ARM64" CACHE STRING "Generator platform for Windows" FORCE)
+        message(STATUS "ccap: Forcing ARM64 architecture compilation for Windows")
+    endif()
+endif()
+
+# Detect ARM64 architecture and set corresponding compile flags
+if(CMAKE_SYSTEM_PROCESSOR MATCHES "[Aa][Rr][Mm]64|[Aa][Aa][Rr][Cc]h64" OR
+   CMAKE_GENERATOR_PLATFORM MATCHES "[Aa][Rr][Mm]64" OR
+   CMAKE_OSX_ARCHITECTURES MATCHES "[Aa][Rr][Mm]64" OR
+   CCAP_FORCE_ARM64)
+
+    message(STATUS "ccap: Building for ARM64 architecture")
+
+    # Windows ARM64 特定设置
+    if(WIN32 AND MSVC)
+        # MSVC 在 ARM64 上自动启用 NEON，添加预处理器定义
+        add_compile_definitions(_M_ARM64=1)
+        message(STATUS "ccap: NEON support enabled for Windows ARM64")
+    endif()
+
+    # macOS ARM64 特定设置
+    if(APPLE)
+        # Ensure a valid deployment target for macOS arm64
+        if(CMAKE_OSX_DEPLOYMENT_TARGET VERSION_LESS "11.0")
+            set(CMAKE_OSX_DEPLOYMENT_TARGET "11.0" CACHE STRING "Minimum OS X deployment version" FORCE)
+            message(STATUS "ccap: Bumping macOS deployment target to 11.0 for ARM64")
+        endif()
+        message(STATUS "ccap: NEON support enabled for macOS ARM64")
+    endif()
+endif()
+
 if(NOT MSVC)
     set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++17")
 endif()

examples/desktop.cmake

@@ -36,6 +36,10 @@ endif()
 
 message(STATUS "ccap: GLFW available: ${GLFW_AVAILABLE}")
 
+add_library(common_utils STATIC ${DESKTOP_EXAMPLES_DIR}/utils/helper.cpp)
+target_include_directories(common_utils PRIVATE ${DESKTOP_EXAMPLES_DIR}/utils)
+target_link_libraries(common_utils PUBLIC ccap)
+
 file(GLOB EXAMPLE_SOURCE ${DESKTOP_EXAMPLES_DIR}/*.cpp ${DESKTOP_EXAMPLES_DIR}/*.c)
 
 foreach(EXAMPLE ${EXAMPLE_SOURCE})
@@ -48,7 +52,8 @@ foreach(EXAMPLE ${EXAMPLE_SOURCE})
     endif()
 
     add_executable(${EXAMPLE_NAME} ${EXAMPLE})
-    target_link_libraries(${EXAMPLE_NAME} PRIVATE ccap)
+    target_compile_definitions(${EXAMPLE_NAME} PRIVATE _CRT_SECURE_NO_WARNINGS=1)
+    target_link_libraries(${EXAMPLE_NAME} PRIVATE common_utils)
 
     if(APPLE)
         target_link_options(${EXAMPLE_NAME} PRIVATE

examples/desktop/1-minimal_example.cpp

@@ -6,30 +6,11 @@
  *
  */
 
+#include "utils/helper.h"
+
 #include <ccap.h>
 #include <iostream>
 
-int selectCamera(ccap::Provider& provider) {
-    if (auto names = provider.findDeviceNames(); names.size() > 1) {
-        std::cout << "Multiple devices found, please select one:" << std::endl;
-        for (size_t i = 0; i < names.size(); ++i) {
-            std::cout << "  " << i << ": " << names[i] << std::endl;
-        }
-        int selectedIndex;
-        std::cout << "Enter the index of the device you want to use: ";
-        std::cin >> selectedIndex;
-        if (selectedIndex < 0 || selectedIndex >= static_cast<int>(names.size())) {
-            selectedIndex = 0;
-            std::cerr << "Invalid index, using the first device:" << names[0] << std::endl;
-        } else {
-            std::cout << "Using device: " << names[selectedIndex] << std::endl;
-        }
-        return selectedIndex;
-    }
-
-    return -1; // One or no device, use default.
-}
-
 int main() {
     ccap::Provider cameraProvider;
     cameraProvider.open(selectCamera(cameraProvider), true);