Ubuntu 22.04上编译安装C++ libconfig库

一、前言

libconfig是一个C/C++配置文件解析库，支持读取和写入配置文件。它使用了一种简单易懂的语法，非常适合用于各种项目的配置管理。本文将详细介绍如何在Ubuntu 22.04上编译和安装libconfig库。

二、环境准备

在开始编译安装libconfig之前，需要确保系统已经安装了必要的开发工具和依赖库。

1. 更新系统

首先，更新系统的软件包列表：

sudo apt update
​

 

 

2. 安装开发工具

确保系统安装了编译工具和必要的依赖：

sudo apt install build-essential autoconf automake libtool
​

 

 

3. 安装libconfig依赖

libconfig库本身没有特别的依赖，但为了确保编译过程顺利，可以安装一些常用的开发库：

sudo apt install libexpat1-dev
​

 

 

三、下载libconfig源码

前往libconfig的官方GitHub仓库下载最新的源码，也可以使用git命令直接克隆仓库：

git clone https://github.com/hyperrealm/libconfig.git
cd libconfig
​

 

 

四、编译和安装libconfig

1. 生成配置文件

在开始编译之前，需要生成配置文件。运行以下命令：

./autogen.sh
​

 

 

2. 配置编译选项

运行 configure脚本，检查系统环境并生成Makefile文件：

./configure
​

 

 

可以使用 --prefix选项指定安装目录，例如安装到 /usr/local：

./configure --prefix=/usr/local
​

 

 

3. 编译libconfig

运行 make命令编译libconfig：

make
​

 

 

4. 安装libconfig

编译完成后，运行以下命令安装libconfig库：

sudo make install
​

 

 

五、验证安装

1. 检查库文件

安装完成后，可以检查libconfig库文件是否正确安装到指定目录：

ls /usr/local/lib | grep libconfig
​

 

 

应该能看到如下输出：

libconfig++.a
libconfig++.so
libconfig++.so.11
libconfig++.so.11.0.0
libconfig.a
libconfig.so
libconfig.so.11
libconfig.so.11.0.0
​

 

 

2. 检查头文件

确保头文件也正确安装：

ls /usr/local/include | grep libconfig
​

 

 

应该能看到如下输出：

libconfig.h
libconfig.hh
​

 

 

3. 编写测试代码

为了验证libconfig库是否正常工作，可以编写一个简单的测试程序：

#include <iostream>
#include <libconfig.h++>

using namespace std;
using namespace libconfig;

int main() {
    Config cfg;

    try {
        cfg.readFile("example.cfg");
    } catch (const FileIOException &fioex) {
        cerr << "I/O error while reading file." << endl;
        return(EXIT_FAILURE);
    } catch (const ParseException &pex) {
        cerr << "Parse error at " << pex.getFile() << ":" << pex.getLine() << " - " << pex.getError() << endl;
        return(EXIT_FAILURE);
    }

    const Setting &root = cfg.getRoot();
    try {
        string name;
        if (root.lookupValue("name", name))
            cout << "Name: " << name << endl;
    } catch (const SettingNotFoundException &nfex) {
        cerr << "No 'name' setting in configuration file." << endl;
    }

    return(EXIT_SUCCESS);
}
​

 

 

4. 编译测试代码

将上述代码保存为 test.cpp，然后使用g++编译：

g++ test.cpp -o test -lconfig++
​

 

 

5. 创建配置文件

创建一个简单的配置文件 example.cfg：

name = "Ubuntu User";
​

 

 

6. 运行测试程序

执行编译生成的测试程序：

./test
​

 

 

输出应该为：

Name: Ubuntu User
​

 

 

六、总结

通过本文的介绍，我们详细讲解了如何在Ubuntu 22.04上编译和安装libconfig库，并通过编写和运行一个简单的测试程序来验证安装是否成功。libconfig库的安装过程相对简单，主要包括环境准备、下载源码、编译和安装几个步骤。希望本文对您在项目中使用libconfig库有所帮助。