#五、靜態庫與動態庫構建
讀者云,太能羅唆了,一個Hello World 就折騰了兩個大節。OK,從本節開始,我們不再折騰Hello World 了,我們來折騰Hello World 的共享庫。
本節的任務:
1,建立一個靜態庫和動態庫,提供HelloFunc 函數供其他程序編程使用,HelloFunc向終端輸出Hello World 字符串。2,安裝頭文件與共享庫。
一,準備工作:在/backup/cmake 目錄建立t3目錄,用于存放本節涉及到的工程
二,建立共享庫
cd /backup/cmake/t3mkdir lib在t3目錄下建立CMakeLists.txt,內容如下:PROJECT(HELLOLIB)ADD_SUBDIRECTORY(lib)
在lib 目錄下建立兩個源文件hello.c 與hello.hhello.c 內容如下:#include “hello.h”void HelloFunc(){
printf(“Hello World\n”);
}
hello.h 內容如下:#ifndef HELLO_H #define HELLO_H #include <stdio.h> void HelloFunc(); #endif
在lib 目錄下建立CMakeLists.txt,內容如下:
SET(LIBHELLO_SRC hello.c)ADD_LIBRARY(hello SHARED ${LIBHELLO_SRC})
三,編譯共享庫:
仍然采用out-of-source 編譯的方式,按照習慣,我們建立一個build 目錄,在build 目錄中
cmake .. make 這時,你就可以在lib 目錄得到一個libhello.so ,這就是我們期望的共享庫。
如果你要指定libhello.so 生成的位置,可以通過在主工程文件CMakeLists.txt 中修改ADD_SUBDIRECTORY(lib) 指令來指定一個編譯輸出位置或者在lib/CMakeLists.txt 中添加SET(LIBRARY_OUTPUT_PATH < 路徑>)來指定一個新的位置。
這兩者的區別我們上一節已經提到了,所以,這里不再贅述,下面,我們解釋一下一個新的指令ADD_LIBRARY ADD_LIBRARY(libname [SHARED|STATIC|MODULE] [EXCLUDE_FROM_ALL]
source1 source2 ... sourceN) 你不需要寫全libhello.so,只需要填寫hello 即可,cmake 系統會自動為你生成libhello.X
類型有三種: SHARED,動態庫STATIC,靜態庫MODULE ,在使用dyld的系統有效,如果不支持dyld,則被當作SHARED 對待。
EXCLUDE_FROM_ALL 參數的意思是這個庫不會被默認構建,除非有其他的組件依賴或者手工構建。
四,添加靜態庫:
同樣使用上面的指令,我們在支持動態庫的基礎上再為工程添加一個靜態庫,按照一般的習慣,靜態庫名字跟動態庫名字應該是一致的,只不過后綴是.a罷了。
下面我們用這個指令再來添加靜態庫:
ADD_LIBRARY(hello STATIC ${LIBHELLO_SRC})
然后再在build 目錄進行外部編譯,我們會發現,靜態庫根本沒有被構建,仍然只生成了一個動態庫。因為hello 作為一個target 是不能重名的,所以,靜態庫構建指令無效。
如果我們把上面的hello 修改為hello_static: ADD_LIBRARY(hello_static STATIC ${LIBHELLO_SRC}) 就可以構建一個libhello_static.a 的靜態庫了。
這種結果顯示不是我們想要的,我們需要的是名字相同的靜態庫和動態庫,因為target 名稱是唯一的,所以,我們肯定不能通過ADD_LIBRARY 指令來實現了。這時候我們需要用到另外一個指令:
SET_TARGET_PROPERTIES ,其基本語法是:
SET_TARGET_PROPERTIES(target1 target2 ...
PROPERTIES prop1 value1
prop2 value2 ...)
這條指令可以用來設置輸出的名稱,對于動態庫,還可以用來指定動態庫版本和API 版本。
在本例中,我們需要作的是向lib/CMakeLists.txt 中添加一條:SET_TARGET_PROPERTIES(hello_static PROPERTIES OUTPUT_NAME "hello") 這樣,我們就可以同時得到libhello.so/libhello.a 兩個庫了。
與他對應的指令是:
GET_TARGET_PROPERTY(VAR target property) 具體用法如下例,我們向lib/CMakeListst.txt 中添加:GET_TARGET_PROPERTY(OUTPUT_VALUE hello_static OUTPUT_NAME) MESSAGE(STATUS “This is the hello_static
OUTPUT_NAME:”${OUTPUT_VALUE})
如果沒有這個屬性定義,則返回NOTFOUND.
讓我們來檢查一下最終的構建結果,我們發現,libhello.a 已經構建完成,位于build/lib 目錄中,但是libhello.so 去消失了。這個問題的原因是:cmake 在構建一個新的target 時,會嘗試清理掉其他使用這個名字的庫,因為,在構建libhello.a 時,
就會清理掉libhello.so.為了回避這個問題,比如再次使用SET_TARGET_PROPERTIES 定義CLEAN_DIRECT_OUTPUT 屬性。
向lib/CMakeLists.txt 中添加:SET_TARGET_PROPERTIES(hello PROPERTIES CLEAN_DIRECT_OUTPUT 1)SET_TARGET_PROPERTIES(hello_static PROPERTIES CLEAN_DIRECT_OUTPUT
1)
這時候,我們再次進行構建,會發現build/lib 目錄中同時生成了libhello.so 和libhello.a
五,動態庫版本號按照規則,動態庫是應該包含一個版本號的,我們可以看一下系統的動態庫,一般情況是
libhello.so.1.2libhello.so ->libhello.so.1libhello.so.1->libhello.so.1.2
為了實現動態庫版本號,我們仍然需要使用SET_TARGET_PROPERTIES 指令。具體使用方法如下:
SET_TARGET_PROPERTIES(hello PROPERTIES VERSION 1.2 SOVERSION 1) VERSION 指代動態庫版本,SOVERSION 指代API版本。將上述指令加入lib/CMakeLists.txt 中,重新構建看看結果。在build/lib 目錄會生成:libhello.so.1.2 libhello.so.1->libhello.so.1.2 libhello.so ->libhello.so.1
六,安裝共享庫和頭文件
以上面的例子,我們需要將libhello.a, libhello.so.x 以及hello.h 安裝到系統目錄,才能真正讓其他人開發使用,在本例中我們將hello 的共享庫安裝到<prefix>/lib 目錄,將hello.h 安裝到<prefix>/include/hello 目錄。
利用上一節了解到的INSTALL 指令,我們向lib/CMakeLists.txt 中添加如下指令:INSTALL(TARGETS hello hello_static
LIBRARY DESTINATION libARCHIVE DESTINATION lib)
INSTALL(FILES hello.h DESTINATION include/hello) 注意,靜態庫要使用ARCHIVE 關鍵字通過: cmake -DCMAKE_INSTALL_PREFIX=/usr .. make make install 我們就可以將頭文件和共享庫安裝到系統目錄/usr/lib 和/usr/include/hello 中了。
七,小結:本小節,我們談到了:如何通過ADD_LIBRARY 指令構建動態庫和靜態庫。如何通過SET_TARGET_PROPERTIES 同時構建同名的動態庫和靜態庫。如何通過SET_TARGET_PROPERTIES 控制動態庫版本最終使用上一節談到的INSTALL 指令來安裝頭文件和動態、靜態庫。
在下一節,我們需要編寫另一個高級一點的Hello World 來演示怎么使用我們已經構建的構建的共享庫libhello 和外部頭文件。