JsonUtils

C/C++ Json工具类, 基于腾讯RapidJson封装(https://github.com/Tencent/rapidjson)

cpp项目工程目录结构(私人用)

C++ 顶层目录结构

 project_name
  ├── deploy
  ├── build
  ├── doc
  ├── 3rdparty
  ├── include
  │   └── project_name
  ├── project_name
  ├── tools
  ├── scripts
  ├── platforms
  ├── test
  ├── LICENSE
  ├── CMakeLists.txt
  ├── build.sh
  ├── toolchain.cmake
  ├── .gitignore
  ├── readme.md
  └── sample

• deploy : 用于存放部署、交付的文件，其包含子目录bin、lib、include分别存放本项目最总生成的可执行文件、库文件以及对外所提供的头文件。
• build : 用于存放build时cmake产生的中间文件，其包含子目录release和debug。
• doc : 用于存放项目的相关文档。
• 3rdparty : 用于存放第三方库，每个第三库以单独目录的形式组织在3rdparty目录下。其中每个第三方目录下又有 include 和 lib 分别存放第三方库的头文件和库文件。
• include/project_name : 用于存放每个模块以及整个工程对外的头文件。具体格式如下文。
• project_name : 存放源码文件，以及内部头文件。具体格式如下文。
• tools : 包含一些支持项目构建的工具，如编译器等，一般情况下使用软链接。
• scripts : 包含一些脚本文件，如使用Jenkins进行自动化构建时所需要的脚本文件，以及一些用于预处理的脚本文件。
• platforms : 用于一些交叉编译时所需要的工具链等文件，按照平台进行划分来组织子目录。每个子目录下存放 toolchain.cmake 等用于指定平台的文件。
• test : 分模块存放测试代码。
• LICENSE : 版权信息说明。
• CMakeLists.txt : cmake文件。
• build.sh : build脚本文件。
• .gitignore : 指明git忽略规则。
• readme.md : 存放工程说明文件。
• sample : 存放示例代码。

源文件目录结构说明

结构示例

# example modules tree
project_name
├── module_1
│   ├── dir_1
│   │   ├── something.cc
│   │   └── something.h
│   ├── dir_2
│   ├── module_1.cc
│   ├── CMakeLists.txt
│   └── README.md
├── module_2
│   ├── dir_1
│   ├── dir_2
│   ├── module_2.cc
│   ├── CMakeLists.txt
│   └── README.md
├── module_3
├── main.cc
└── CMakeLists.txt

1. 总源码文件目录以 project_name 命名，即与项目同名，存放在项目根目录下。
2. 源码文件分模块进行组织，分别以各个模块进行命名存放在 project_name 目录下，如示例中的 module_1 、module_2。
3. 在每个子模块目录下，只包含源文件以及该模块内部所调用的头文件。
4. 每个子模块的根目录下存放该模块的主要功能逻辑代码，如 module_1.cc。另外，可按照功能再划分子目录进行源码组织，但不可以出现模块嵌套的情况。
5. 若要包含内部头文件时，包含路径要从 project_name 开始路径要完整，如#include "project_name/module1/dir_1/somthing.h"，以防止头文件名称冲突的情况，同时遵循了Google C++编码规范。

头文件目录结构说明

# example include tree
include
└── project_name
    ├── module_1
    │   ├── module_1_header_1.h
    │   └── module_1_header_2.h
    ├── module_2
    │   └── module_2.h
    └── project_name.h

1. （公共）头文件目录以 include/project_name 命名，即文件目录为两级，存放在项目根目录下。该目录只包含所有对外的头文件。
2. 头文件同样分模块进行组织，分别以各个模块进行命名存放在 include/project_name 目录下，如示例中的 module_1 、module_1。
3. include/project_name 目录下最多只包含一级子目录，即最多按照模块再划分一级，模块内的功能头文件不再以功能进行划分。
4. 若要包含外部头文件时，包含路径同样要从 project_name 开始路径要完整，如#include "project_name/module_2/module_2.h"。

其他

1. 针对头文件的包含，顶层 CMakeLists.txt 只指定 ${CMAKE_SOURCE_DIR}\include 和 ${CMAKE_SOURCE_DIR}，以保证所有的包含规则都是从工程根目录开始包含。
2. 添加 include 目录使得公共头文件和对内部文件可以分离开，使多个模块之间合作开发时项目内部结构更加清晰。
3. （暂时）在 3rdparty 下存放的工程中用到的第三方库和第三方源码。第三方库尽量不要直接把静态连接库直接放到git仓库中，应该另外提供链接以便下载，或者提供文档说明库的名称和版本自行安装下载，或者提供git仓库自行编译。第三方源码一般为开源的，只提供git链接。

参考

大型项目CMakeLIsts.txt的编写规范 https://blog.csdn.net/dongfang1984/article/details/55105537

CmakeLists.txt书写规范 https://blog.csdn.net/csdnhuaong/article/details/80895679

cmake简介与编写规范 http://675816156.github.io/2016/06/26/cmake%E7%AE%80%E4%BB%8B%E4%B8%8E%E7%BC%96%E5%86%99%E8%A7%84%E8%8C%83/

C++工程目录架构推荐 https://www.cnblogs.com/kuliuheng/p/5729559.html