在Linux系统编译DCMTK的源码得到其动态库文件和可执行程序

本文介绍如何在Linux系统下编译出DCMTK的动态库和可执行文件，以编译DCMTK的动态库为主，实际开发需要使用其动态库。

编译环境：Ubuntu 20.04 LTS 64位

DCMTK源码包版本：dcmtk-3.6.4

构建工具：cmake-3.16.3

gcc，g++编译器：9.4.0

一、下载DCMTK官方源码包

 下载地址1（有些人打不开）：Index of /download/dcmtk

上述下载地址有些打不开，可以试试在Wiki下载，下地址2：Files - DCMTK - OFFIS DCMTK and DICOM Projects

 二、解压源码包编译源码

1.解压源码包：

tar -zxvf dcmtk-3.6.4.tar.gz

解压完成：

 2.创建“build”目录，进去构建cmake工程：

mkdir build
cd build
cmake -DCMKE_BUILD_TYPE=Debug -DBUILD_SHARED_LIBS=true ../

参数说明：

（1）-DCMKE_BUILD_TYPE：编译方式，不填默认为Release方式

        以Debug方式编译 ： -DCMKE_BUILD_TYPE=Debug

        以Release方式编译 ：-DCMKE_BUILD_TYPE=Release

（2）-DBUILD_SHARED_LIBS：是否生成动态库文件(.so文件)，不填默认为false（不生成动态库文件，但会生成静态库.a文件）

        生成动态库文件：-DBUILD_SHARED_LIBS=true

        不生成动态库文件：-DBUILD_SHARED_LIBS=false

 3.工程构建完成后，开始编译工程

make -j8

 说明：-j8 ：开8条线程编译速度会快一些

 4.编译完成后，安装（其实是把可执行文件、动态库文件、头文件、资源文件、配置文件全部拷贝）到指定的路径：（建议不要模仿我的安装路径，我仅为了方便展示使用）

make DESTDIR=../dcmtk-3.6.4-install install

也可以安装到系统默认路径：（需要管理员权限sudo）

sudo make install

 安装完成：

 注意：每个动态库文件都要三个一起才完整缺一不可（libxxx.so，libxxx.so.14，libxxx.so.14.3.6.4），移植这个动态库文件时必须把三个一起打包拷贝。

 在安装路径内，会默认创建“usr/local”两级目录，在里面还有5个子目录，分别是：

“bin”：存放可执行文件

“etc”：配置文件，“bin”里面的可执行文件的运行会读取里面的配置文件

“include”：头文件

“lib”：动态库文件，“bin”里面的可执行文件的运行会连接里面的动态库文件

“share”：资源文件，“bin”里面的可执行文件的运行会读写里面的资源文件

如果我们写代码需要使用dcmtk的动态库，只需要“include”和“lib”这两个就可以了，建议把这两个文件写入编译器的环境变量。

三、最后，可以把“include”、“lib”、“bin”这三个目录和“share/dcmtk/dicom.dic”数据字典文件加到系统对应的环境变量里：

对所有用户有效修改 "/etc/profile" 可能需要重启系统才会生效
对个人有效则修改 "~/.bashrc"

# 程序可执行文件环境变量，用于在任何位置都可以直接运行该程序

export PATH=$PATH:/home/wjp/Desktop/dcmtk-3.6.4/dcmtk-3.6.4-install/usr/local/bin

# （必须）DCMTK工具包可执行文件依赖的数据字典文件的环境变量 "share/dcmtk/dicom.dic"

export DCMDICTPATH=$DCMDICTPATH:/home/wjp/Desktop/dcmtk-3.6.4/dcmtk-3.6.4-install/usr/local/share/dcmtk/dicom.dic

# gcc 编译器找到头文件（xxx.h）的路径，写C++程序一般都不会用到gcc,所以这个可以忽略不写

export C_INCLUDE_PATH=$C_INCLUDE_PATH:/home/wjp/Desktop/dcmtk-3.6.4/dcmtk-3.6.4-install/usr/local/include  

# g++ 编译器找到头文件（xxx.h/hpp）的路径

export CPLUS_INCLUDE_PATH=$CPLUS_INCLUDE_PATH:/home/wjp/Desktop/dcmtk-3.6.4/dcmtk-3.6.4-install/usr/local/include

 # 找到静态库（xxx.a）的路径

export LIBRARY_PATH=$LIBRARY_PATH:/home/wjp/Desktop/dcmtk-3.6.4/dcmtk-3.6.4-install/usr/local/lib  

# 找到动态链接库（xxx.so）的路径

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/wjp/Desktop/dcmtk-3.6.4/dcmtk-3.6.4-install/usr/local/lib

例如我在 "/etc/profile" 中添加：

使用管理员权限通过 vi 编辑器或者 gedit 编辑器打开配置文件修改

sudo vi /etc/profile

或者

sudo gedit /etc/profile

在文件尾部添加，保存后使用source指令让配置文件立即生效：（貌似只对“~/.bashrc”有用）

source /etc/profile

如果source指令后没有生效，那就重启虚拟机就会生效；

四、编写测试程序（非必须）

1.准备一个Dicom文件（自己想办法，我不提供该文件），再写一个简单的读取Dicom文件的C++程序，测试生成的动态库是否正常：

gedit dcmtest.cpp

#include <iostream>
#include "dcmtk/dcmdata/dctk.h" //使用dcmtk的动态库，由于写入了编译器查找头文件的环境变量，此处可以使用尖括号<dcmtk/dcmdata/dctk.h>

int main()
{
	//读取一个dicom文件，解析tag值
	std::string dicomfileName = "./CT_test.dcm";
	OFFilename tm(dicomfileName.data());
	DcmFileFormat dfile;
	OFCondition dcmcond = dfile.loadFile(tm);
	if (dcmcond.good())
	{
		DcmDataset* data = dfile.getDataset();
		OFString ValueStr;

		//获取Patient信息
		data->findAndGetOFString(DCM_PatientID, ValueStr);
		std::cout << std::string(ValueStr.c_str()) << std::endl;

		data->findAndGetOFString(DCM_PatientName, ValueStr);
		std::cout << std::string(ValueStr.c_str()) << std::endl;

		data->findAndGetOFString(DCM_PatientSex, ValueStr);
		std::cout << std::string(ValueStr.c_str()) << std::endl;

		data->findAndGetOFString(DCM_PatientBirthDate, ValueStr);
		std::cout << std::string(ValueStr.c_str()) << std::endl;

		data->findAndGetOFString(DCM_StudyInstanceUID, ValueStr);
		std::cout << std::string(ValueStr.c_str()) << std::endl;

		data->findAndGetOFString(DCM_StudyID, ValueStr);
		std::cout << std::string(ValueStr.c_str()) << std::endl;

		data->findAndGetOFString(DCM_AccessionNumber, ValueStr);
		std::cout << std::string(ValueStr.c_str()) << std::endl;
	}
	
	return 0;	
}

上图可见运行测试Demo，把Dicom文件的部分信息读出来了，表示动态库正常调用。