工程应用的SDK封装——linux环境中的.so动态链接库的使用(1)

时间:2024-03-27 15:10:27

linux下生成动态链接库并使用(使用cmake)

2017年04月01日 11:04:44 沧海飞帆 阅读数:12990

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/ktigerhero3/article/details/68941252

使用cmake生成库主要要注意三个文件夹
(1)源文件文件夹
(2)中间文件夹(编译生成的.o等文件的文件夹)
(3)安装文件夹(最终可用的库所在的文件夹)

使用库的步骤
(1)在工程文件中包括库函数的头文件(可为绝对路径,也可配置全局环境变量用相对路径)
(2)在CMakeLists.txt或集成开发环境中指定库函数的动态链接库或者静态链接库所在的文件夹路径
(3)在CMakeLists.txt或集成开发环境中指定头文件的文件夹路径
(4)如果是动态链接库,且库函数不在linux默认查找路径下,运行时要修改环境变量才能使用

下文用最简单的示例来表示这个过程,假设我的库实现的是简单的加法计算。库函数的源文件名字叫hello.c,库函数的头文件名字叫hello.h,生成的动态链接库函数的名称叫libhello.so,目标是在/hello/install文件夹下安装这个库,以便后来调用。设库函数源文件在/home/hello/libhello目录,编译生成的中间文件夹在/home/hello/build

#1.生成库
文件夹结构如下

工程应用的SDK封装——linux环境中的.so动态链接库的使用(1)

##1.1编辑文件
在libhello文件夹下编辑hello.c文件

#include<stdio.h>
#include"hello.h"

void hello()
{
      printf("hello");
}

和hello.h头文件。

#ifndef HELLO_H
#define HELLO_H
#include <stdio.h>
void hello();
#endif

##1.2使用cmake编译和安装
(1)在/home/hello/文件夹下新建CMakeLists.txt,添加以下内容

cmake_minimum_required (VERSION 2.6)

add_library(hello SHARED ${PROJECT_SOURCE_DIR}/libhello/hello.c)
install(TARGETS hello LIBRARY DESTINATION lib)

其中

add_library(hello SHARED ${PROJECT_SOURCE_DIR}/libhello/hello.c)
  •  

PROJECT_SOURCE_DIR 宏的值是后文中cmake gui的where is source code 选项选择的路径值,也就是顶层CMakeList.txt所在文件路径的值。
才采用的是hello.c所在的绝对路径。
(2)打开Cmake图形化工具并配置参数最后生成Makefile
注意(我的顶层CMakeLists.txt在/home/rootroot/workspace/hello路径下)
控制台输入cmake-gui
如图
工程应用的SDK封装——linux环境中的.so动态链接库的使用(1)
a)在where is source code选项选择/home/rootroot/workspace/hello
b)在where to build the binaries选项选择/home/rootroot/workspace/hello/build
c)在CMAKE_INSTALL_PREFIX选择可执行文件安装的路径/home/rootroot/workspace/hello/install
d)选择编译类型CMAKE_BUILD_TYPE 设置为Debug,release
e )点击configure配置,弹出编译器类型选择界面,选择编译器类型
f )点击generate就能在where to build the binaries目录下看到Makefile文件了

在/home/rootroot/workspace/hello/build文件夹下输入make在当前文件夹下生成libhello.so
输入make install
在/home/rootroot/workspace/hello/install即CMAKE_INSTALL_PREFIX路径的看到文件
libhello.so
库的编译和安装已经实现了,为了方便使用,还需要将头文件安装到安装目录下。
##1.3将头文件安装到<prefix>/include/目录下
在顶层文件夹下的CMakeLists.txt加入以下语句安装头文件到
/home/rootroot/workspace/hello/install/include文件夹

INSTALL(FILES ${PROJECT_SOURCE_DIR}/libhello/hello.h
DESTINATION include)

然后在cmake gui中点击configure配置,点击generate
然后在build文件夹make
make install
如图
工程应用的SDK封装——linux环境中的.so动态链接库的使用(1)
#2.使用生成的动态链接库

##2.1 方法1.直接用gcc指定头文件路径和动态链接库路径
步骤如下
###2.1.1在目录/home/rootroot/workspace/下新建工程usehellolib
如图
工程应用的SDK封装——linux环境中的.so动态链接库的使用(1)
###2.1.2编译主函数usehellolib.c 如下

#include <hello.h>
int main()
{
hello();
return 0;
}

###2.1.3使用gcc命令链接并执行生成的可执行文件
在/home/rootroot/workspace/usehellolib 目录下输入命令

gcc usehellolib.c -I/home/rootroot/workspace/hello/install/include -L/home/rootroot/workspace/hello/install/lib -lhello -o usehellolib

语法分析:
gcc 源文件 -I头文件目录 -L动态链接库目录 动态链接库文件名(去掉lib在前面加l) -o 生成的可执行文件名字

发现可以链接成功
但是输入./usehellolib
会出现这个错误
工程应用的SDK封装——linux环境中的.so动态链接库的使用(1)

说明找不到库,因为采用的是动态链接库,所谓动态链接是在运行时链接,编译链接的时候是直接告诉了GCC库的位置,因此会成功,而运行是如果不告诉操作系统库在哪个位置,当然找不到这个库,程序也就不能运行。因此要告诉操作系统库在哪个地方,linux使用LD_LIBRARY_PATH告诉系统库在哪个地方。(LD_LIBRARY_PATH是Linux环境变量名,该环境变量主要用于指定查找共享库(动态链接库)时除了默认路径之外的其他路径)。

设置环境变量可以有临时,也可以永久设置。
(1)临时设置解决方案
输入命令

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rootroot/workspace/hello/install/lib
  • 1

再次运行 ./uselibhello
输出hello

(2)永久设置解决方案
永久设置解决方案一:
su用户下
编辑.bashrc文件
vi /root/.bashrc
在最后加入

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/rootroot/workspace/hello/install/lib
  • 1

然后
source /root/.bashrc
就能够运行了。

永久设置解决方案二:
本文使用的是ubantu14.02系统
编辑该文件

vi /etc/ld.so.conf.d/libc.conf
  • 1

在文件的末尾加入要调用的动态链接库的路径
本文加入

/home/rootroot/workspace/hello/install/lib
  • 1

然后在控制台执行

ldconfig
  • 1

运行程序就能够执行了。

##2.2 方法2.Cmake链接动态链接库
那么在大型工程中怎么链接外部共享库呢?本节介绍编辑CMakeLists.txt来使用生成的动态链接库。
在工程目录/home/rootroot/workspace/usehellolib下新建CMakeLists.txt如下:

PROJECT(usehellolib)
ADD_EXECUTABLE(usehellolib usehellolib.c)
INCLUDE_DIRECTORIES(/home/rootroot/workspace/hello/install/include)
TARGET_LINK_LIBRARIES(usehellolib /home/rootroot/workspace/hello/install/lib/libhello.so)

解析:
INCLUDE_DIRECTORIES()告诉编译器头文件在哪个位置。
TARGET_LINK_LIBRARIES()告诉链接器动态链接库在哪个位置

输入
cmake.
make
会出现链接错误
/usr/bin/ld: cannot find -lhello

/usr/bin/ld: cannot find -l*解决方法
ld链接器告诉你找不到库函数,那么你就要把库函数放到ld链接器能够找到的地方。因此解决方法如下
方法1
将要调用的库函数复制到linux默认搜索库函数的目录下
即/usr/lib 目录。

sudo cp /home/rootroot/workspace/hello/install/lib/libhello.so /usr/lib
  • 1

方法2
使用软链接(个人理解类似于创建快捷方式)

sudo ln -s /home/rootroot/workspace/hello/install/lib/libhello.so /usr/lib/libhello.so
  • 1

ln -s 它的功能是为某一个文件在另外一个位置建立一个同步的链接,这个命令最常用的参数是-s,具体用法是:ln -s 源文件 目标文件

方法3
类似于上文的动态链接库的路径设置方法

cd /etc/ld.so.conf.d/
cp libc.conf hello.conf
vi hello.conf

编辑hello.conf的内容如下

/home/rootroot/workspace/hello/install/lib
  • 1

告诉链接器动态链接库的路径。
执行
ldconfig
输入
ldconfig -p |grep libhello
输出libhello动态链接库信息

设置好后
注意要重新删除所有Cmake生成的文件
再输入
cmake.
make
就能够正常使用了。

补充
方法4
如果加上link_directories这一句就不会出现 cannot find -l* 的问题,最终的CMakeLists.txt如下

project(usehellolib)
cmake_minimum_required (VERSION 2.6)
INCLUDE_DIRECTORIES(/home/rootroot/workspace/hello/install/include)
link_directories(/home/rootroot/workspace/hello/install/lib)
add_executable(${PROJECT_NAME} usehellolib.c)
target_link_libraries(${PROJECT_NAME} hello.so)