Linux编程：合并静态库

在项目开发过程中，会存在经常使用的模块，按照代码复用的思想，可以将这些通用的模块生成库，以此减少开发代码量。如果一个项目引用的库文件比较多，管理起来也不方便，也可以将这些库合并为一个。

1、ar基本用法

ar命令可以用来创建、修改库，也可以从库中提出单个模块。

库是一单独的文件，里面包含了按照特定的结构组织起来的其它的一些文件（称做此库文件的member）。原始文件的内容、模式、时间戳、属主、组等属性都保留在库文件中。

使用命令ar -h可以查看帮助，我们把{dmpqrtx}部分称为操作选项，而[abcfilNoPsSuvV]部分称为任选项。

Usage: ar [emulation options] [-]{dmpqrstx}[abcDfilMNoOPsSTuvV] [--plugin <name>] [member-name] [count] archive-file file...
       ar -M [<mri-script]
 commands:
  d            - delete file(s) from the archive
  m[ab]        - move file(s) in the archive
  p            - print file(s) found in the archive
  q[f]         - quick append file(s) to the archive
  r[ab][f][u]  - replace existing or insert new file(s) into the archive
  s            - act as ranlib
  t[O][v]      - display contents of the archive
  x[o]         - extract file(s) from the archive
 command specific modifiers:
  [a]          - put file(s) after [member-name]
  [b]          - put file(s) before [member-name] (same as [i])
  [D]          - use zero for timestamps and uids/gids (default)
  [U]          - use actual timestamps and uids/gids
  [N]          - use instance [count] of name
  [f]          - truncate inserted file names
  [P]          - use full path names when matching
  [o]          - preserve original dates
  [O]          - display offsets of files in the archive
  [u]          - only replace files that are newer than current archive contents
 generic modifiers:
  [c]          - do not warn if the library had to be created
  [s]          - create an archive index (cf. ranlib)
  [S]          - do not build a symbol table
  [T]          - make a thin archive
  [v]          - be verbose
  [V]          - display the version number
  @<file>      - read options from <file>
  --target=BFDNAME - specify the target object format as BFDNAME
  --output=DIRNAME - specify the output directory for extraction operations
 optional:
  --plugin <p> - load the specified plugin
 emulation options: 
  No emulation specific options
ar: supported targets: elf64-x86-64 elf32-i386 elf32-iamcu elf32-x86-64 pei-i386 pei-x86-64 elf64-l1om elf64-k1om elf64-little elf64-big elf32-little elf32-big pe-x86-64 pe-bigobj-x86-64 pe-i386 srec symbolsrec verilog tekhex binary ihex plugin
Report bugs to <http://www.sourceware.org/bugzilla/>

操作选项说明如下：

• d：从库中删除模块。按模块原来的文件名指定要删除的模块。如果使用了任选项v则列出被删除的每个模块。
• m[ab]：该操作是在一个库中移动成员。当库中如果有若干模块有相同的符号定义(如函数定义)，则成员的位置顺序很重要。如果没有指定任选项，任何指定的成员将移到库的最后。也可以使用a，b，或i任选项移动到指定的位置。
• p：显示库中指定的成员到标准输出。如果指定任选项v，则在输出成员的内容前，将显示成员的名字。如果没有指定成员的名字，所有库中的文件将显示出来。
• q[f]：快速追加。增加新模块到库的结尾处。并不检查是否需要替换。a，b，或i任选项对此操作没有影响，模块总是追加的库的结尾处。如果使用了任选项v则列出每个模块。 这时，库的符号表没有更新，可以用ar s或ranlib来更新库的符号表索引。
• r[ab][f][u]：在库中插入模块(替换)。当插入的模块名已经在库中存在，则替换同名的模块。如果若干模块中有一个模块在库中不存在，ar显示一个错误消息，并不替换其他同名模块。默认的情况下，新的成员增加在库的结尾处，可以使用其他任选项来改变增加的位置。
• s: 作为ranlib
• t[O][v]：显示库的模块表清单。一般只显示模块名。
• x[o]：从库中提取一个成员。如果不指定要提取的模块，则提取库中所有的模块。

任选项说明如下：

• a：在库的一个已经存在的成员后面增加一个新的文件。如果使用任选项a，则应该为命令行中member-name参数指定一个已经存在的成员名。
• b：在库的一个已经存在的成员前面增加一个新的文件。如果使用任选项b，则应该为命令行中member-name参数指定一个已经存在的成员名。
• c：创建一个库。不管库是否存在，都将创建。
• f：在库中截短指定的名字。缺省情况下，文件名的长度是不受限制的，可以使用此参数将文件名截短，以保证与其它系统的兼容。
• i：在库的一个已经存在的成员前面增加一个新的文件。如果使用任选项i，则应该为命令行中member-name参数指定一个已经存在的成员名(类似任选项b)。
• l：暂未使用
• N：与count参数一起使用，在库中有多个相同的文件名时指定提取或输出的个数。
• o：当提取成员时，保留成员的原始数据。如果不指定该任选项，则提取出的模块的时间将标为提取出的时间。
• P：进行文件名匹配时使用全路径名。ar在创建库时不能使用全路径名（这样的库文件不符合POSIX标准），但是有些工具可以。
• s：写入一个目标文件索引到库中，或者更新一个存在的目标文件索引。甚至对于没有任何变化的库也作该动作。对一个库做ar s等同于对该库做ranlib。
• S：不创建目标文件索引，这在创建较大的库时能加快时间。
• u：一般说来，命令ar r...插入所有列出的文件到库中，如果你只想插入列出文件中那些比库中同名文件新的文件，就可以使用该任选项。该任选项只用于r操作选项。
• v：该选项用来显示执行操作选项的附加信息。
• V：显示ar的版本。

2、合并静态库

假设存在三个静态库：oldlib1.a、oldlib2.a、oldlib3.a，需要合并为新静态库：newlib.a

• 方法一

LIB_OUTPUT=${PWD}/build/output
# 解包，获取*.o文件，静态库的模块是.o文件
ar x oldlib1.a --output=${LIB_OUTPUT}
ar x oldlib2.a --output=${LIB_OUTPUT}
ar x oldlib3.a --output=${LIB_OUTPUT}

# 打包
cd ${LIB_OUTPUT}
ar crsv newlib.a *.o

# 清理
rm *.o

• 方法二

ar crsT newlib.a oldLib1.a oldlib2.a oldlib3.a

• 方法三

（1）先编写一个mri脚本，如newlib.mri，内容如下

create newlib.a
 
addlib oldlib1.a 
addlib oldlib2.a 
addlib oldlib3.a 
 
save
end

(2)执行该脚本

ar -M <./newlib.mri

参考链接

• linux ar命令

• Linux 合并多个.a 静态库文件

• linux编程合并多个静态库.a为一个.a

• How to merge two “ar” static libraries into one?

Linux 合并多个静态库为一个静态库

Linux 下可以使用 ar 命令对多个静态库做合并。可以按照如下方式合并静态库。

1. 获取全部需合并的静态库
2. 使用 ar -x 对 静态库解压为 .o 文件
3. 使用 ar cr 对静态库做合并

# [可选] 将依赖库放置到某一处
cp <deps>.a 

find . -name "*.a" | xargs -n1 ar -x
find . -name "*.o" | xargs ar rc
rm *.o