podspec 校验报错问题指南

转自：https://www.jianshu.com/p/f296ec3649f4

1.that GitHub is down

cocoapods < Failed to connect to GitHub to update the CocoaPods/Specs specs repo - Please check if you are offline, or that GitHub is down>

解决办法：
方法一：优先尝试此方法

每次需要更新你的repo时，将老版本的repo删除，重新下载
$sudo rm -fr ~/.cocoapods/repos/master
$pod setup
$pod install --repo-update

方法二：

To solve this, first you need to update openssl, then ruby, then cocoapod.
更新openssl、ruby、cocoapod

$ which openssl
/usr/bin/openssl

$ openssl version
OpenSSL 0.9.8zh 14 Jan 2016

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

$ brew update

$ brew install openssl

$ brew upgrade openssl

**If you need to have this software first in your PATH run: echo 'export PATH="/usr/local/opt/openssl/bin:$PATH"' >> ~/.bash_profile**

$ echo 'export PATH="/usr/local/opt/openssl/bin:$PATH"' >> ~/.bash_profile
$ source ~/.bash_profile

$ which openssl
/usr/local/opt/openssl/bin/openssl

$ openssl version
OpenSSL 1.0.2n  7 Dec 2017

$ brew install rbenv ruby-build

$ echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bash_profile
$ echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.bash_profile
$ source ~/.bash_profile

$ rbenv install --list

Available versions:
  1.8.5-p52
  1.8.5-p113
  1.8.5-p114
  1.8.5-p115
  1.8.5-p231
  1.8.6
:
  2.5.0-rc1
  2.5.0
  2.6.0-dev
:

$ rbenv install 2.5.0

$ rbenv versions
* system (set by /Users/username/.rbenv/version)
  2.5.0

$ ruby --version
ruby 2.0.0p648 (2015-12-16 revision 53162) [universal.x86_64-darwin16]

$ rbenv global 2.5.0

$ rbenv versions
  system
* 2.5.0 (set by /Users/username/.rbenv/version)

$ ruby --version
ruby 2.5.0p0 (2017-12-25 revision 61468) [x86_64-darwin16]

$ gem install cocoapods -n /usr/local/bin

$ which pod
/usr/local/bin/pod

$ pod --version
1.4.0

2.The source_files pattern did not match any file.

podspec 验证pod lib lint 失败  
ERROR | [iOS] file patterns: The source_files pattern did not match any file.

原因：制作私有库的文件夹，物理路径下没有.h/.m文件，只有子文件夹
解决办法：
spec.source_files = "ShareUIDemo/ShareUIDemo/*"

附加：
对照路径是否错误
路径书写规则：
source_files：这里要注意的是这里的路径是以xxx.podspec文件为根据，同级的话，就写文件名就好（一般要传pod
的最外层文件夹和xxx.podspec文件是同级的）。往后多级的，逐级加。如果多个的话，就分组加，逗号隔开。下面
针对各种情况给出范例：

1）同级的文件夹B里面只有.h和.m文件
source_files = "B/.{h,m}"
2）多级文件夹B/C/D（只有最后一级文件夹里面有.h和.m文件
source_files = "B/C/D/.{h,m}"
3）多级文件夹B/C/D，每个文件夹里面都有.h和.m文件
source_files = "B/.{h.m}","B/C/.{h.m}","B/C/D/.{h.m}"
其中C D可以用*代替

文件匹配
匹配所有文件
c匹配以名字C开头的文件
*c匹配以名字c结尾的文件
c匹配所有名字包含c的文件
**文件夹以及递归子文件夹
?任意一个字符(注意是一个字符)
[set] 匹配多个字符,支持取反
{p,q} 匹配名字包括p 或者 q的文件

3.unable to find utility "simctl", not a developer tool or in PATH

编译 cocoapods 的 xxx.podspec 文件 出现以下错误  
ERROR | [iOS] unknown: Encountered an unknown error (/usr/bin/xcrun simctl list -j devices
xcrun: error: unable to find utility "simctl", not a developer tool or in PATH

解决办法：
打开你的 Xcode，点开偏好设置（Preferences）
找到Locations,然后Command Line Tools,应该是空的，选择Xcode 版本
重新验证成功

4. podspec 图片资源重复

ERROR | [iOS] xcodebuild: Returned an unsuccessful exit code

具体原因：error: Unexpected duplicate tasks:
 Target 'ShareUI' (project 'Pods') has copy command from '/Users/ywk/Desktop/MyMediatorDemo/ShareUIDemo/ShareUIDemo/ShareUI/img/friend@3x.png' to '/Users/ywk/Library/Developer/Xcode/DerivedData/App-bxwbywnltwesungutffpmsolziyh/Build/Products/Release-iphonesimulator/ShareUI/friend@3x.png'

解决办法：

网上可以找到一堆是xcode重复编译资源文件造成，要去Build Phases ->Compile Sources 中删掉参与编译的文件。不过对比找了好几遍，都没找到有重复编译的文件。

最后检查podspec文件，发现自己把自己坑了。
spec.source_files  = "ShareUIDemo/ShareUIDemo/ShareUI/*.{h,m}"
spec.resources = "ShareUIDemo/ShareUIDemo/ShareUI/Resource/**/*.png"

source_files 结尾后面多加了一个逗号，删掉就好了。注意每句spec设置之前没有分隔符。

5. 缺少架构 normal i386/normal x86_64

   The following build commands failed:
       Ld /Users/ywk/Library/Developer/Xcode/DerivedData/App-bbsqamfhzhjciwehdhwasdrwlxod/Build/Intermediates.noindex/App.build/Release-iphonesimulator/App.build/Objects-normal/x86_64/Binary/App normal x86_64
       Ld /Users/ywk/Library/Developer/Xcode/DerivedData/App-bbsqamfhzhjciwehdhwasdrwlxod/Build/Intermediates.noindex/App.build/Release-iphonesimulator/App.build/Objects-normal/i386/Binary/App normal i386

解决方法：
方法一：首先要检查source_files 路径有没有配置对，我的是目录分级时由于有一个路径配置跟其他的重复导致此错误。

方法二：然后尝试：
pod lib lint 后添加 --skip-import-validation

pod repo push 也添加--skip-import-validation
但可能不通过

方法三：podspec 文件添加x86_64 i386配置
s.pod_target_xcconfig = { 'VALID_ARCHS' => 'x86_64 armv7 arm64' }
具体参照博客：https://www.jianshu.com/p/88180b4d2ab7

6. Error installing ShareUI

执行 pod repo push podspec 时出错
Cloning into '/var/folders/7y/zk1f61qd0951c4t36mqzmvbw0000gn/T/d20200728-8911-1cjbv45'...
warning: Could not find remote branch 0.1.1 to clone.
fatal: Remote branch 0.1.1 not found in upstream origin

解决方法：
执行pod repo push podspec 之前一定要先打tag 并提交，tag要与podspec 中保持一致

7. Podfile中的 use_frameworks!

安装私有库时 使用use_frameworks!，可能导致编译失败。注释掉即可。

1）用cocoapods 导入swift框架到swift项目和oc项目都必须使用use_frameworks 
2）使用dynamic frameworks,必须要在podfile文件中添加 use_frameworks

如果在podfile文件中不使用use_frameworks,则会生成相应的.a文件，同过static libraries 这个方式来管理pod代码

如果使用use_frameworks,则cocoapods会生成相应的.frameworks文件，使用dynamic frameworks 来取代static libraries 方式。

use_frameworks! -> dynamic frameworks 方式 -> .framework
#use_frameworks! -> static libraries方式 -> .a

swift项目cocoapods 默认 use_frameworks!
oc项目cocoapods 默认 #use_frameworks!