feat: Implement unified version management system

- Consolidate version information into ccap_config.h header file
  - Define CCAP_VERSION_MAJOR, CCAP_VERSION_MINOR, CCAP_VERSION_PATCH macros
  - Add CCAP_VERSION_STRING for convenient version reference

- Update CMakeLists.txt for dynamic version detection
  - CMake now reads version directly from header file at configure time
  - Add robust error handling: defaults to 0.0.9999 if version parsing fails
  - Print warnings when version cannot be determined or header is missing

- Create scripts/update_version.sh for one-command version updates
  - Automatically updates all version references across the project
  - Properly handles relative paths by detecting project root
  - Supports X.Y.Z semantic versioning format
  - Updates: ccap_config.h, ccap.podspec, conanfile.py, BUILD_AND_INSTALL.md

- Update src/ccap_c.cpp to use generated version macro
  - ccap_get_version() now returns CCAP_VERSION_STRING from header

- Update configuration files to reflect new version scheme
  - ccap.podspec: version bumped to 1.3.2
  - BUILD_AND_INSTALL.md: current version updated to 1.3.2
  - conanfile.py: version field maintained at 1.3.2

Benefits:
- Single source of truth for version information in header file
- Eliminates manual synchronization errors across multiple files
- CI/CD friendly: version automatically picked up during build
- Fallback mechanism ensures build robustness
- Script provides convenient version bump workflow

Author: wysaid

BUILD_AND_INSTALL.md

@@ -250,6 +250,6 @@ git clean -fdx install/
 
 ## Version Information
 
-Current version: 1.0.0
+Current version: 1.3.2
 
 This is the first official release of the ccap project, including complete CMake configuration and cross-platform build support.

CMakeLists.txt

@@ -22,7 +22,29 @@ if(CCAP_IS_ROOT_PROJECT)
     set(CMAKE_FETCHCONTENT_BASE_DIR "${CMAKE_SOURCE_DIR}/build" CACHE PATH "FetchContent base dir" FORCE)
 endif()
 
-project(ccap VERSION 1.1.0 LANGUAGES C CXX)
+# Read version from header file
+set(CCAP_CONFIG_HEADER "${CMAKE_CURRENT_SOURCE_DIR}/include/ccap_config.h")
+if(EXISTS "${CCAP_CONFIG_HEADER}")
+    file(READ "${CCAP_CONFIG_HEADER}" ver_h)
+    string(REGEX MATCH "#define CCAP_VERSION_MAJOR ([0-9]+)" _ "${ver_h}")
+    set(ver_major ${CMAKE_MATCH_1})
+    string(REGEX MATCH "#define CCAP_VERSION_MINOR ([0-9]+)" _ "${ver_h}")
+    set(ver_minor ${CMAKE_MATCH_1})
+    string(REGEX MATCH "#define CCAP_VERSION_PATCH ([0-9]+)" _ "${ver_h}")
+    set(ver_patch ${CMAKE_MATCH_1})
+
+    if("${ver_major}" STREQUAL "" OR "${ver_minor}" STREQUAL "" OR "${ver_patch}" STREQUAL "")
+        set(PROJECT_VERSION "0.0.9999")
+        message(WARNING "Could not parse version from ${CCAP_CONFIG_HEADER}, using default version ${PROJECT_VERSION}")
+    else()
+        set(PROJECT_VERSION "${ver_major}.${ver_minor}.${ver_patch}")
+    endif()
+else()
+    set(PROJECT_VERSION "0.0.9999")
+    message(WARNING "${CCAP_CONFIG_HEADER} not found, using default version ${PROJECT_VERSION}")
+endif()
+
+project(ccap VERSION ${PROJECT_VERSION} LANGUAGES C CXX)
 
 # Installation options
 option(CCAP_INSTALL "Generate installation target" ${CCAP_IS_ROOT_PROJECT})

ccap.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name         = "ccap"
-  s.version      = "1.0.0"
+  s.version      = "1.3.2"
   s.summary      = "CameraCapture And Player"
   s.description  = <<-DESC
 Pod of https://github.com/wysaid/CameraCapture

include/ccap_config.h

@@ -12,6 +12,13 @@
 #ifndef CCAP_CONFIG_H
 #define CCAP_CONFIG_H
 
+/* ========== Version Information ========== */
+
+#define CCAP_VERSION_MAJOR 1
+#define CCAP_VERSION_MINOR 3
+#define CCAP_VERSION_PATCH 2
+#define CCAP_VERSION_STRING "1.3.2"
+
 /* ========== Export/Import Macro Definitions ========== */
 
 // Define CCAP_EXPORT macro for symbol export/import

scripts/update_version.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+
+# Check if version argument is provided
+if [ -z "$1" ]; then
+    echo "Usage: $0 <new_version>"
+    echo "Example: $0 1.2.0"
+    exit 1
+fi
+
+NEW_VERSION=$1
+
+# Extract major, minor, patch from version string
+IFS='.' read -r -a VERSION_PARTS <<< "$NEW_VERSION"
+MAJOR=${VERSION_PARTS[0]}
+MINOR=${VERSION_PARTS[1]}
+PATCH=${VERSION_PARTS[2]}
+
+if [ -z "$MAJOR" ] || [ -z "$MINOR" ] || [ -z "$PATCH" ]; then
+    echo "Error: Invalid version format. Expected X.Y.Z"
+    exit 1
+fi
+
+echo "Updating version to $NEW_VERSION (Major: $MAJOR, Minor: $MINOR, Patch: $PATCH)..."
+
+# Get the project root directory (assuming script is in scripts/ folder)
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" &> /dev/null && pwd )"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+# 1. Update include/ccap_config.h
+sed -i "" "s/#define CCAP_VERSION_MAJOR .*/#define CCAP_VERSION_MAJOR $MAJOR/" "$PROJECT_ROOT/include/ccap_config.h"
+sed -i "" "s/#define CCAP_VERSION_MINOR .*/#define CCAP_VERSION_MINOR $MINOR/" "$PROJECT_ROOT/include/ccap_config.h"
+sed -i "" "s/#define CCAP_VERSION_PATCH .*/#define CCAP_VERSION_PATCH $PATCH/" "$PROJECT_ROOT/include/ccap_config.h"
+sed -i "" "s/#define CCAP_VERSION_STRING .*/#define CCAP_VERSION_STRING \"$NEW_VERSION\"/" "$PROJECT_ROOT/include/ccap_config.h"
+echo "Updated include/ccap_config.h"
+
+# 2. Update ccap.podspec
+sed -i "" "s/s.version      = \".*\"/s.version      = \"$NEW_VERSION\"/" "$PROJECT_ROOT/ccap.podspec"
+echo "Updated ccap.podspec"
+
+# 3. Update conanfile.py
+sed -i "" "s/version = \".*\"/version = \"$NEW_VERSION\"/" "$PROJECT_ROOT/conanfile.py"
+echo "Updated conanfile.py"
+
+# 4. Update BUILD_AND_INSTALL.md
+sed -i "" "s/Current version: .*/Current version: $NEW_VERSION/" "$PROJECT_ROOT/BUILD_AND_INSTALL.md"
+echo "Updated BUILD_AND_INSTALL.md"
+
+echo "Version update complete!"

src/ccap_c.cpp

@@ -398,8 +398,7 @@ const char* ccap_error_code_to_string(CcapErrorCode errorCode) {
 }
 
 const char* ccap_get_version(void) {
-    // You may want to define this version string elsewhere
-    return "1.0.0";
+    return CCAP_VERSION_STRING;
 }
 
 bool ccap_pixel_format_is_rgb(CcapPixelFormat format) {