关于Argument list too long的问题

问题

在使用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下面还有几级子目录，这样连接起来就会导致路径非常的长。

解决方案

1. 将工程移到目录结构比较浅的地方，比如移到上上级文件夹，减少层级。（临时方案，不能解决根本问题，不建议）
2. 如果是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)/**"，那么可以改成搜索**之类的，主要核心思想就是排查搜索路径是否过大。