前言
Cocoapods是非常好用的一个iOS依赖管理工具,使用它可以方便的管理和更新项目中所使用到的第三方库,以及将自己的项目中的公共组件交由它去管理。实际开发中,像组件化之一中讲的一样,大型项目中有很多公共化组件可以做成私有化库,独立于项目工程,减少耦合和维护成本
整体先说明一下创建一个私有的podspec包括如下那么几个步骤:
- 创建并设置一个私有的Spec Repo,事先创建好该私有的Spec Repo的仓库。
- 创建Pod所需要的项目工程文件,并且有可访问的项目版本控制地址。
- 创建Pod所对应的podspec文件。
- 本地测试配置好的podspec文件是否可用。
- 向私有的Spec Repo中提交podspec。
- 在个人项目中的Podfile中增加刚刚制作的好的Pod并使用。
更新维护podspec。
版本控制这里用git,个人没有私有账户,所以过程中创建的都是public项目
1、创建一个spec仓库,作为私有化Spec Repo的远端地址,先来说第一步,什么是Spec Repo?它是所有的Pods的一个索引,就是一个容器,所有公开的Pods都在这个里面,它实际是一个Git仓库remote端在GitHub上
创建私有化Spec Repo,进入.cocoaPods文件你会看到创建的结果
# pod repo add [Private Repo Name] [GitHub HTTPS clone URL]
$ pod repo add WSPodTestSpec https://github.com/Anny-github/WSPodTestSpec.git
创建Pod工程
1、如果你已经有了一个git上的项目,就不用进行这一步了,如果没有,先cd到目标文件夹,再z执行pod lib create podTestLibrary
之后他会问你四个问题,1.是否需要一个例子工程;2.选择一个测试框架;3.是否基于View测试;4.类的前缀;4个问题的具体介绍可以去看官方文档,我这里选择的是1.yes;2.Specta/Expecta;3.yes;4.PTL。 问完这4个问题他会自动执行pod install命令创建项目并生成依赖。
以上是项目生成的目录结构及相关介绍。
2、完善项目文件
接下来就是向Pod文件夹中添加库文件和资源,并配置podspec文件,我把自己写的两个类放入Pod/Classes中,然后进入Example文件夹执行pod update命令,再打开项目工程可以看到,刚刚添加的组件已经在Pods子工程下Development Pods/LoadingViewLibrary中了
可以看到,pods中的LoadingViewLibrary的Classes中已经添加好了文件,现在要把修改push到远端,这个时候,我们发现还没有对应的git仓库,所以上面创建仓库一样,再创建一个pod文件的仓库,LoadingViewLibrary
git add .
git commit -m "initial Pod"
git remote add origin https://github.com/Anny-github/LoadingViewLibrary.git
git push origin master //如果失败rejected,使用git push -f origin master 强制push
注:这里需要注意的是每当你向Pod中添加了新的文件或者以后更新了podspec的版本都需要重新执行一遍pod update命令。
因为podspec文件中获取Git版本控制的项目还需要tag号,所以我们要打上一个tag,并推送tag到远端。
git tag 0.0.1
git push --tags
修改并验证podspec文件
podspec文件将lib中用到的包括资源、源码、需要引用的framework,以及第三库等等组织起来,是我们创建私有Pod的重要文件
1、接下来开始编辑podspec文件了,它是一个Ruby的文件,把编辑器的格式改成Ruby就能看到语法高亮,下面我贴上我的podspec文件,并在后面以注释的形式说明每个字段的含义,没有涉及到的字段可以去官方文档查阅
Pod::Spec.new do |s|
s.name = 'LoadingViewLibrary'
s.version = '0.0.1'
s.summary = 'test for private pod.'
s.description = <<-DESC
test private pod,this is a class used to loading view
DESC
s.homepage = 'https://baidu.com'
s.license = { :type => 'MIT', :file => 'LICENSE' }
s.author = { 'Anny-github' => 'wenshanshan1991@163.con' }
s.source = { :git => 'https://github.com/Anny-github/LoadingViewLibrary.git', :tag => '0.0.1'}
s.ios.deployment_target = '8.0'
s.source_files = 'LoadingViewLibrary/Classes/**/*'
# s.resource_bundles = {
# 'LoadingViewLibrary' => ['LoadingViewLibrary/Assets/*.png']
# }
s.public_header_files = 'LoadingViewLibrary/Classes/**/*.h'
s.frameworks = 'UIKit'
# s.dependency 'AFNetworking', '~> 2.3'
end
2、编辑完podspec文件后,需要对其进行验证,如果有任何WARNING或者ERROR都是不可以的,它就不能被添加到Spec Repo中,不过xcode的WARNING是可以存在的,验证需要执行一下命令,两个任选一个都可以
pod lib lint //不予许警告和错误
pod lib lint --allow-warnings //允许警告
可能会遇到的问题,提示会将有错误的用>指出来,一般会有标点等格式错误,最重要的是s.source_files和source不能搞错
验证通过是这个样子的:
本地创建xcode工程TestPodSpec,测试创建的pod能否可用
1、创建Podfile文件,链接本地pod地址,可以通过Finder的前往,查看这个地址是否存在,能找到证明链接地址没错
platform :ios,'8.0'
target 'TestPodSpec' do
pod 'LoadingViewLibrary' , :podspec => '/Users/Hammer/Desktop/LoadingViewLibrary/LoadingViewLibrary.podspec'
inhibit_all_warnings!
end
2、保存好Podfile后,pod install,下面是成功了
打开TestPodSpec.xcworkspace,查看Pods目录下,是否install好了本地的私有库LoadingViewLibrary
看到上面,就证明安装成功,运行demo测试一下。
提交本地podspec到Specs仓库
向Spec Repo提交podspec需要完成两点一个是podspec必须通过验证无误,在一个就是删掉无用的注释(这个不是必须的,为了规范还是删掉吧)。 向我们的私有Spec Repo提交podspec只需要一个命令
pod repo push WSPodTestSpec LoadingViewLibrary.podspec
至此,我们的私有podspec已经创建完成,这个时候就可以像pod search AFNetworking一样,搜索自己的podspec库了,死不死挺过瘾😁
问题小结
1、执行pod lib create (组件库) 出错
提示错误:rubygems/core_ext/kernel_require.rb:120:in `require': cannot load such file -- colored2
(LoadError)
解决办法:
输入上面提示的colored2的两条gem命令即可解决问题
sudo gem install colored2
sudo gem update --system
2、添加组件库到私有spec repo仓库后 执行 pod search搜索不到。
方法一:
先确认你本地仓库上面确实有你新创建的组件库,这时候可以先删除search缓存文件
rm ~/Library/Caches/CocoaPods/search_index.json
,删除后从新执行pod search ***
方法二:
1.切换到某个项目(含有podfile文件)下
2.执行pod update(提示不能更新)
3.尝试 pod repo update —verbose获取详细信息,我记得是提示我删除一个 index.lock文件,
4.删除后从新 执行 pod repo update —verbose 会更新本地私有库和master仓库
5.执行pod search *** 创建search索引,可以搜到
3、提交本地podspec到Specs仓库的时候出错,提示repo 文件夹下的spec repo is not clean
方法一: cd到spec repo 文件夹下,执行 git clean -f
方法二:cd到spec repo 文件夹下,执行 git stash
2.其他关于pod的问题:
Cocoapods环境配置 :http://blog.csdn.net/cbl643966855/article/details/51120497Cocoapods使用私有库遇到的坑:http://www.jianshu.com/p/1e5927eeb341http://blog.csdn.net/andanlan/article/details/50515434Cocoapods安装或更新出错:http://blog.csdn.net/lindir/article/details/52980526Cocoapods search无法搜索:http://blog.csdn.net/yuanmengong886/article/details/57083919