Android cmake命令總結以及指令碼模板

常用cmake命令記錄及Cmake指令碼模板(對付日常開發幾乎已經夠用了)

指令總結方面可以直接檢視這個官方連結：cmake.org/cmake/help/…

這裡總結一些常用的命令及使用示例：

set
- set (<variable> <value>... [PARENT_SCOPE])
  
  設定某個變數的值，作用域為當前函式或者當前資料夾，[PARENT_SCOPE]這個引數沒用過，參照官方文件可知似乎是將此變數設定在上一級作用域中（也就是父目錄或者呼叫函式）
  
  使用變數的方法：${}
file
- file(WRITE <filename> <content>...)
  
  將content寫入指定檔案，如果檔案不存在則建立檔案；如果檔案存在則覆蓋該檔案
  
  示例：file(WRITE src/hello.txt "hello world")
- file(APPEND <filename> <content>...)
  
  示例：file(APPEND src/hello.txt "hello world 2")
  
  將content以追加的形式寫入指定檔案
- file(READ <filename> <variable> [OFFSET <offset>][LIMIT <max-in>] [HEX])
  
  將<filename>檔案裡面的內容從偏移為<offset>的地方最多讀取<max-in>個內容，並放入<variable>進行儲存，HEX選項為16進位制讀取。
  
  示例：file(READ src/hello.txt context LIMIT 5)
- file(GLOB <variable> [LIST_DIRECTORIES true|false] [RELATIVE <path>] [<globbing-expressions>...]) 生成<globbing-expressions>與之匹配的檔案列表並將其儲存到<variable>。Globbing表示式與正規表示式類似，但更簡單。如果RELATIVE指定了flag，則結果將作為給定路徑的相對路徑返回。
  
  預設情況下列出GLOB目錄 - 如果LIST_DIRECTORIES設定為false，則在結果中省略目錄。
  
  示例：file(GLOB utils_src_cc src/utils/*.cc)
find_library()
- find_library (<VAR> name1 [path1 path2 ...])
  
  此命令用於查詢庫。建立名為<VAR>的快取條目以儲存此命令的結果。如果找到庫，則結果儲存在變數中，除非清除變數，否則不會重複搜尋。如果找不到任何結果，結果將是<VAR>-NOTFOUND，並在下次使用相同變數呼叫find_library時再次嘗試搜尋。搜尋的庫的名稱由name1指定(值為庫的名稱，如libz.a，則name值為z)。可以在PATHS引數之後指定其他搜尋位置。
  
  示例：find_library( log-lib log)
add_library()

使用指定的原始檔將庫新增到專案中。
- add_library(<name> [STATIC | SHARED | MODULE] [EXCLUDE_FROM_ALL] source1 [source2 ...])
  
  新增一個根據命令呼叫中列出的原始檔,構建名為<name>的庫目標。它<name>對應於邏輯目標名稱，並且在專案中必須是全域性唯一的。構建的庫的實際檔名是基於本機平臺（例如lib.a or .lib）的約定構造的。
  
  示例：
```
add_library(
        ${PROJECT_NAME}

        SHARED

        ${src1} //可以配合file命令，但官方不建議這麼做，理由是cmake無法知曉有新的檔案加入
        ${src2}
        ${src3}
        )
複製程式碼
```
- add_library(<name> <SHARED|STATIC|MODULE|UNKNOWN> IMPORTED [GLOBAL])
  
  匯入名字為<name>的庫
  
  示例：
```
add_library(myz SHARED IMPORTED)
add_library(myz SHARED IMPORTED)
#設定庫檔案所在路徑
set_target_properties(myz PROPERTIES IMPORTED_LOCATION ${CMAKE_SOURCE_DIR}/libs/${ANDROID_ABI}/libnative-static.a)
複製程式碼
```
target_link_libraries()
- target_link_libraries( ... ... ...)
  
  預設情況下，使用此簽名，庫依賴項是可傳遞的。當此目標連結到另一個目標時，連結到此目標的庫也將出現在另一個目標的連結行上。這個傳遞性的“連結介面”儲存在INTERFACE_LINK_LIBRARIES目標屬性，可以通過直接設定屬性來覆蓋。
  
  示例：target_link_libraries(${PROJECT_NAME} ${log-lib} ${z-lib})
include_directories(）
- include_directories([AFTER|BEFORE] [SYSTEM] dir1 [dir2 ...])
  
  將給定目錄新增到編譯器用於搜尋包含檔案的目錄中。相對路徑被解釋為相對於當前源目錄。include目錄被新增到當前CMakeLists檔案的目錄屬性 INCLUDE_DIRECTORIES 之中。他們對當前CMakeLists檔案中INCLUDE_DIRECTORIES屬性中也加入了每個目標的目標屬性。目標屬性值是生成器使用的值。
示例：
```
include_directories(
        src/dir1
        src/dir2
        src/dir3
        src/dir4
        )
複製程式碼
```

兩個Cmakelists.txt的例子：

第一個

cmake_minimum_required(VERSION 3.4.1)

set(PROJECT_NAME AMLLOC)

file(WRITE amlloc/hello.txt "asdasda")
file(READ amlloc/hello.txt context LIMIT 5)
file(APPEND amlloc/hello.txt ${context})

file(GLOB amlloc_src amlloc/src/*.cpp)
file(GLOB utils1_src_cc amlloc/src/utils/*.cc)
file(GLOB utils2_src amlloc/src/utils2/*.cpp)
file(GLOB utils3_src_cc amlloc/src/utils3/*/*.cc)
file(GLOB utils3_src_c amlloc/src/utils4/*/*.c)
file(GLOB utils4_src amlloc/src/utils5/*.c)



find_library( log-lib log)
find_library( z-lib z)

include_directories(
        amlloc/src/utils/include
        amlloc/src/include
        amlloc/src/utils1
        amlloc/src/utils2/md5
        amlloc/src/utils2
        amlloc/src/utils3
        )



add_library(
        ${PROJECT_NAME}

        SHARED

        ${amlloc_src}
        ${utils1_src_cc}
        ${utils2_src}
        ${utils3_src_cc}
        ${utils3_src_c}
        ${utils4_src}
        )
target_link_libraries(${PROJECT_NAME}  ${log-lib} ${z-lib})
複製程式碼

第二個

首先看Project的目錄結構

├── CMakeLists.txt
├── main.cpp
└── module
    ├── CMakeLists.txt
    ├── GameSave.h
    ├── s_utils.cc
    ├── s_utils.h
    ├── log.cc
    ├── log.h
    ├── utils.cc
    └── utils.h
複製程式碼

子目錄：

set(PROJECT_NAME module_demo)
file(GLOB module_src ./*.cc)

add_library(${PROJECT_NAME} SHARED ${module_src})
find_library(log-lib log)
target_link_libraries(${PROJECT_NAME}  ${log-lib})
複製程式碼

父目錄：

cmake_minimum_required(VERSION 3.4.1)

#find library log and the result is stored
#in the var log-lib
find_library(log-lib log)

#get the .so directory
set(DISTRIBUTION_DIR ${CMAKE_SOURCE_DIR}/../../../libs)

add_library(gamesavesaty_module SHARED IMPORTED)

set_target_properties(gamesavesaty_module
                      PROPERTIES IMPORTED_LOCATION
                      ${DISTRIBUTION_DIR}/armeabi/libmodule.so
                      )

add_library(gamesavety SHARED IMPORTED)

set_target_properties(gamesavety
                      PROPERTIES IMPORTED_LOCATION
                      ${DISTRIBUTION_DIR}/armeabi/libgamesavety.so
                      )



#set c++ compiler
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11")

set(PROJECT_NAME demo)


#include the module header file
include_directories(./module)

#add source file in module
add_subdirectory(module)

#Adds a library target called PROJECT_NAME to be built
#from the source file main.cpp and files in module.
add_library(${PROJECT_NAME} SHARED main.cpp)

include_directories(${DISTRIBUTION_DIR}/armeabi)

#Specify libraries module_demo and log-lib to
#use when linking project demo.
target_link_libraries(${PROJECT_NAME} module_demo gamesavety gamesavesaty_module ${log-lib})
複製程式碼

Android cmake命令總結以及指令碼模板

相關文章