问题
在使用cocoapods进行组件管理,编译xcode工程时,可能会遇到如下错误:
Argument list too long: recursive header expansion failed at /Users/liusilan/Documents/workspace/douyu/project/PlayerRoom/Demo/xx/xx.
这个问题从字面上看起来的原因是参数列表太长,在递归展开的时候失败
。通过排查,发现我们工程出现的原因是因为搜索路径范围太大($(PODS_ROOT)/**
),编译时会遍历搜索范围内的所有目录。这时候当工程根目录的层级比较深时,Pods里面的层级也比较多时,导致路径太长,超出范围。
比如我的工程目录是/Users/liusilan/Documents/workspace/douyu/project/PlayerRoom/Demo
,pods的层级Pods/VideoComponent/VideoComponent/Classes/Business/Video
,而Video
下面还有几级子目录,这样连接起来就会导致路径非常的长。
解决方案
- 将工程移到目录结构比较浅的地方,比如移到上上级文件夹,减少层级。(临时方案,不能解决根本问题,不建议)
- 如果是debug,则查看
Pods-xx.debug.xcconfig
文件,搜索LIBRARY_SEARCH_PATHS
或者FRAMEWORK_SEARCH_PATHS
是否包含"$(PODS_ROOT)/**"
。正是因为**
,导致搜索范围过大。
一般出现这种搜索路径,是由于在podspec
里面指定search_path
时图方便,写的不规范。比如:
s.xcconfig = {
"LIBRARY_SEARCH_PATHS" => "\"$(PODS_ROOT)/**\""
}
比较好的做法是指定具体的路径,如sdk/libs/*.a
,这样会极大的减少搜索范围。
如何排查
那么,如何查找哪些podspec有问题呢?对于大型项目,组件上百个,手动去查找显得费时费力。
可通过脚本,扫描~/.cocoapods/repos/xx
,xx代表要扫描的spec仓库,然后逐个读取podspec文件,搜索"$(PODS_ROOT)/**
,如果搜索到了,则记录下来。最后将结果打印,可以看到哪些podspec有问题,然后再逐个修改。
简单列一下python
代码:
PODS_ROOT_result = set('')
def list(rootDir):
for lists in os.listdir(rootDir):
path = os.path.join(rootDir, lists)
if os.path.isdir(path):
list(path)
else:
file_extension = os.path.splitext(path)[1]
if file_extension == '.podspec':
file_object = open(path, 'r')
try:
all_the_text = file_object.read()
basename=os.path.basename(path)
(filename,extension) = os.path.splitext(basename)
if all_the_text.find("$(PODS_ROOT)/**") != -1:
print "PODS_ROOT:"+filename
PODS_ROOT_result.add(filename)
result.add(filename)
finally:
file_object.close()
不过,可能其他同学的podspec里不是这样写的"$(PODS_ROOT)/**"
,那么可以改成搜索**
之类的,主要核心思想就是排查搜索路径是否过大。