TsFile Reader/Writer Integration Guide

1. Building TSFile Shared Library

Build Methods (Choose either approach)

Method 1: Maven Build

Execute from the project root directory:

mvn clean package verify -P with-cpp

Output location: cpp/target/build/lib

If maven is not installed, may use ‘mvnw’ in linux/macos or ‘mvnw.cmd’ in win instead"

Method 2: Script Build

Run the build script:

bash build.sh

Output location: cpp/build/Release/lib

Project Configuration

CMake Integration

Add to your CMakeLists.txt:

find_library(TSFILE_LIB NAMES tsfile PATHS ${SDK_LIB} REQUIRED)
target_link_libraries(your_target ${TSFILE_LIB})

Note: Set ${SDK_LIB} to your TSFile library directory.

3. Implementation Examples

Directory Structure

   ├── CMakeLists.txt
   ├── c_examples/
   │   ├── demo_write.c    # C write implementation
   │   └── demo_read.c     # C read implementation
   ├── cpp_examples/
   │   ├── demo_write.cpp  # C++ write implementation
   │   └── demo_read.cpp   # C++ read implementation
   └── examples.cc         # Combined use cases

Code References

Writing TSFiles:
C: c_examples/demo_write.c
C++: cpp_examples/demo_write.cpp

Reading TSFiles:
C: c_examples/demo_read.c
C++: cpp_examples/demo_read.cpp