LibHaru 开源项目使用教程

1. 项目的目录结构及介绍

LibHaru 是一个用于生成 PDF 文件的开源库。以下是其 GitHub 仓库的主要目录结构及其介绍：

libharu/
├── contrib/
├── demo/
├── include/
│   └── hpdf.h
├── src/
│   ├── hpdf_3dmeasure.c
│   ├── hpdf_annotation.c
│   ├── ...
│   └── hpdf_version.c
├── win32/
├── CMakeLists.txt
├── LICENSE
├── README.md
└── ...

• contrib/: 包含一些贡献者的脚本和工具。
• demo/: 包含一些示例代码，展示如何使用 LibHaru 生成 PDF 文件。
• include/: 包含库的头文件，如 hpdf.h。
• src/: 包含库的源代码文件，如 hpdf_3dmeasure.c, hpdf_annotation.c 等。
• win32/: 包含 Windows 平台特定的文件和配置。
• CMakeLists.txt: CMake 构建脚本。
• LICENSE: 项目的许可证文件。
• README.md: 项目的介绍和使用说明。

2. 项目的启动文件介绍

LibHaru 项目的启动文件主要是 demo 目录下的示例代码。这些示例代码展示了如何使用 LibHaru 库生成 PDF 文件。以下是一些关键的启动文件：

• demo/encoding_list.c: 展示如何使用不同的字符编码。
• demo/font_demo.c: 展示如何嵌入和使用不同的字体。
• demo/image_demo.c: 展示如何嵌入图像。
• demo/text_demo.c: 展示如何添加文本到 PDF 文件。

这些示例代码可以直接编译和运行，以了解 LibHaru 库的基本功能和使用方法。

3. 项目的配置文件介绍

LibHaru 项目的配置文件主要是 CMakeLists.txt 文件，用于配置 CMake 构建系统。以下是一些关键的配置项：

• CMakeLists.txt: 包含项目的构建配置，如源文件列表、头文件路径、编译选项等。

cmake_minimum_required(VERSION 2.8.11)
project(libharu)

set(HPDF_MAJOR_VERSION 2)
set(HPDF_MINOR_VERSION 4)
set(HPDF_BUGFIX_VERSION 0)

set(HPDF_VERSION "${HPDF_MAJOR_VERSION}.${HPDF_MINOR_VERSION}.${HPDF_BUGFIX_VERSION}")

include_directories(${CMAKE_CURRENT_SOURCE_DIR}/include)

file(GLOB HPDF_SOURCES "src/*.c")

add_library(hpdf SHARED ${HPDF_SOURCES})

target_link_libraries(hpdf m)

install(TARGETS hpdf
    LIBRARY DESTINATION lib
    ARCHIVE DESTINATION lib
    RUNTIME DESTINATION bin
)

install(FILES include/hpdf.h DESTINATION include)

通过修改 CMakeLists.txt 文件，可以调整项目的构建配置，如添加新的源文件、修改编译选项等。

以上是 LibHaru 开源项目的目录结构、启动文件和配置文件的介绍。希望这些信息能帮助你更好地理解和使用 LibHaru 库。