|—project
|----------app_module #这个工程是app的主工程,里面有一个商贩类,并且有个main程序入口。
|----------second_module #这个工程是二方module,将以源码的方式被app_module依赖,里面有个表示外国友人的foreign类。
|----------third_party #这个是工程依赖的第三方库,示例中的汇率转换工具,将由银行提供,作为第三方库被集成,非源码依赖。
示例讲解
- 帮助银行生成一个汇率库,我们给这个库起个名字叫rate_util,发出去给商贩们使用。
#声明所需cmake的最小版本号
cmake_minimum_required(VERSION 3.11)
#指定生成的target(一个银行工具库,可以用来做汇率转换)
add_library(rate_util SHARED rate_util.cpp)
#指定library输出目录
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY
P
R
O
J
E
C
T
S
O
U
R
C
E
D
I
R
/
b
u
i
l
d
/
l
i
b
s
/
{PROJECT_SOURCE_DIR}/build/libs/
PROJECTSOURCEDIR/build/libs/{OS})
#安装头文件到指定的目录
install(FILES “rate_util.h” DESTINATION “${PROJECT_SOURCE_DIR}/build/inc”)
#如果是iOS平台,则生成framework
if(“${OS}” STREQUAL “iOS”)
set_target_properties(rate_util PROPERTIES FRAMEWORK TRUE)
endif()
前面我们讲到过,cmake需要指定Target,那这里的target就是要生成的工具库,这里我们编译一个动态库,用add_library来指定target是一个库,用SHARED标记这个是一个动态库,然后指定要编译的源文件,这里只有一个就是rate_util.cpp。如果要生成可执行文件就是add_executable,后面生成main程序的时候会看到。
接下来还要指明这个库输出到哪里,这里我们使用cmake内置的一个变量CMAKE_LIBRARY_OUTPUT_DIRECTORY,实际上从变量名大家也能看出来,这个表示生成library的输出目录,cmake还有很多其他的内置变量,实际上上面代码的PROJECT_SOURCE_DIR也是一个内置变量,关于cmake变量我们将在后面讲解。
然后我们又指定了这个库的头文件安装位置,因为这个库要被其他人拿去使用,所以相应的头文件肯定也要跟着发不出去,这里我们使用了一个install命令,这是cmake的内置命令,就像add_library一样都是cmake的内置命令,关于cmake命令我们后面会讲解。
实际上到这里一个基础的cmake配置就完成了,后面我们还加了点小菜,就是给这个target设置了一个属性,标记如果是iOS平台编译的话,要生成framework,而不是dylib这种动态库。至此,第一个问题就有了答案。(示例下载:bank.zip)
- **银行的第三方库有了,接下来就要搭建我们的app工程了,我们就按照上面提到的工程结构来。 **
在开始搭建前先来点小甜点,开篇提到过cmake编译时需要依赖一个CMakeLists.txt配置文件,如果我们像第一步那样所有的配置,所有module的配置都写到一个CMakeLists.txt里面,是不是要疯掉。幸好cmake有个超级好用的内置命令叫add_subdirectory,顾名思义,就是可以用它来指定子目录,当然也就意味着子目录里必须也有一个CMakeLists.txt,这样我们就可以分级去写配置了,各个module的配置写在各自的CMakeLists.txt 里就好了。按照这个思路,我们的工程结构应该变成这样
|—project
|----------CMakeLists.txt#工程最外面入口的CMakeLists.txt
|----------app_module #这个工程是app的主工程,里面有一个商贩类,并且有个main程序入口。
|---------CMakeLists.txt #app_module这个子module的CMakeLists.txt
|----------second_module #这个工程是二方module,将以源码的方式被app_module依赖,里面有个表示外国友人的foreign类。
|----------CMakeLists.txt #second_module这个子module的CMakeLists.txt
|----------third_party #这个是工程依赖的第三方库,示例中的汇率转换工具,将由银行提供,作为第三方库被集成,非源码依赖。
|----------CMakeLists.txt#第三方库的总配置CMakeLists.txt
|----------bank
|---------CMakeLists.txt#银行这个第三方库的CMakeLists.txt
实际上这个结构就是我们demo工程的结构,接下来我们逐个CMakeLists.txt分析。首先看project->CMakeLists.txt,也就是工程总入口的配置:
CMake最低版本号要求
cmake_minimum_required (VERSION 3.11)
#项目信息
project§
#添加一堆的子module
add_subdirectory(app_module ${PROJECT_SOURCE_DIR}/build-cache/app_module/)
add_subdirectory(second_module ${PROJECT_SOURCE_DIR}/build-cache/second_module/)
add_subdirectory(third_party ${PROJECT_SOURCE_DIR}/build-cache/third_party/)
配置很简单,声明了cmake最低版本号,指定了项目信息,然后就是添加了一堆子module,实际上啥活也没干,事情都分配给下面的小弟了,然后我们再看小弟们的CMakeLists.txt先看app_module->CMakeLists.txt,
#声明cmake最低版本号
cmake_minimum_required (VERSION 3.11)
#声明要编译的target是一个可执行文件,target名字是main
add_executable(main
saler.cpp
)
#指定main要链接的其他target,实际上也就是这些target对应的库
target_link_libraries(main
foreign
rate_util
)
#指定这个target的include路径,编译器将在这些路径中寻找头文件
target_include_directories(main
PUBLIC
${PROJECT_SOURCE_DIR}/third_party
)
#设置可执行文件的输出路径
set(EXECUTABLE_OUTPUT_PATH
P
R
O
J
E
C
T
S
O
U
R
C
E
D
I
R
/
b
u
i
l
d
/
b
i
n
/
{PROJECT_SOURCE_DIR}/build/bin/
PROJECTSOURCEDIR/build/bin/{OS})
这个里面就有货了,首先映入眼帘的就是add_executable,原来最终的可执行文件就是在这里生成的,定义了一个叫main的target,由于这个app主程序还要依赖外国友人和银行汇率工具库这两个库,所以我们要给它去指定link的库,这里用到cmake另一个内置命令target_link_libraries,但是参数里指定的都是target name,而并不是库名。只link了库还不够,还要指定头文件查找路径,否则第三方库的头文件找不到,用cmake内置命令target_include_directories,最后需要设置可执行文件的输出目录,这里类似步骤1中生成银行库一样,也是设置cmake内置变量的值,用到的内置变量是*EXECUTABLE_OUTPUT_PATH,*后面的${OS}是我们自定义的一个变量,去看完整的示例工程时会看到。接下来我们再看second_module->CMakeLists.txt,也就是外国友人所在的module,这个module并不是独立的第三方库,而是源码依赖的。
#声明cmake最小版本号
cmake_minimum_required (VERSION 3.11)
#指定target,一个名字为foreign的target,生成物是一个静态库
add_library(foreign
STATIC
ForeignFriend.cpp
)
#指定该target的头文件查找路径,PUBLIC表示该路径也会被传递给依赖该target的库,在该工程中app_module依赖了foreign,因此app_module也能访问该路径,这也就是
#为什么app_module中的文件在引用foreign库中的头文件时不用加前面的路径,直接使用文件名即可
target_include_directories(foreign
PUBLIC
${CMAKE_CURRENT_LIST_DIR}
)
可以看到foreign被作为另一个target声明了,指定生成一个名字为foreign的静态库,并且同样指明了头文件包含路径,由于这里是源码依赖的,该头文件不需要发布给外外面,因此不需要install。最后我们看下第三方库——银行汇率转换工具库是怎么被使用的。
#声明cmake最小版本号
cmake_minimum_required(VERSION 3.11)
#添加一个imported library,
add_library(rate_util SHARED IMPORTED
GLOBAL)
#设置library的位置
set(__lib_name lib_rateutil.so)
if(“KaTeX parse error: Expected group after '_' at position 31: …"android") set(_̲_lib_name libra…{OS}” STREQUAL “iOS”)
set(__lib_name rate_util.framework)
else()
set(__lib_name librate_util.dylib)
endif()
#设置target属性,指明该target imported的库的路径
set_target_properties(rate_util PROPERTIES IMPORTED_LOCATION
P
R
O
J
E
C
T
S
O
U
R
C
E
D
I
R
/
t
h
i
r
d
p
a
r
t
y
/
b
a
n
k
/
l
i
b
s
/
{PROJECT_SOURCE_DIR}/third_party/bank/libs/
PROJECTSOURCEDIR/thirdparty/bank/libs/{OS}/${__lib_name})
#由于这里target是imported进来的,不能使用target_include_directories,因此要用include_directories
include_directories(rate_util
PUBLIC
${CMAKE_CURRENT_LIST_DIR}/inc)
这里第三方库也被声明为一个单独的target了,但是与之前不同的是这里并没有给target指定源文件(因为本来也没有源文件,这是外部编译好的可以直接拿来使用的动态库),而是通过一个IMPORTED标记,表示这个target是外部引入的库,然后通过给target设置IMPORTED_LOCATION这一属性值,指明导入库的文件路径。另外有一点不同的是这里声明头文件包含路径时不能使用target_include_directories了,而要使用include_directries,cmake不允许为imported的库使用target_include_directries。至此,开始提出的2,3问题也都有了答案。
3. 如何生成不同平台的库
结尾
好了,今天的分享就到这里,如果你对在面试中遇到的问题,或者刚毕业及工作几年迷茫不知道该如何准备面试并突破现状提升自己,对于自己的未来还不够了解不知道给如何规划,可以来看看同行们都是如何突破现状,怎么学习的,来吸收他们的面试以及工作经验完善自己的之后的面试计划及职业规划。
这里放上一部分我工作以来以及参与过的大大小小的面试收集总结出来的一套进阶学习的视频及面试专题资料包,主要还是希望大家在如今大环境不好的情况下面试能够顺利一点,希望可以帮助到大家~
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》,点击传送门,即可获取!
312920727)]
[外链图片转存中…(img-uw151o7R-1715312920728)]
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》,点击传送门,即可获取!