starX 2019-07-01
使用CocoaPods有以下几点好处:
sudo gem install cocoapods
pod --version
在开发中安装使用cocoapods要注意版本,因为一般开发过程中要大家一起使用同一个工程,一般为了指定版本我们会在工程下创建Gemfile来指定使用cocoapods的版本。
除了指定Gemfile以外 , 我们还可以安装指定版本的pods
sudo gem install cocoapods -v 1.3.1
再查看一下pod版本我们就会发现已经安装了1.3.1
当我们本地同时存在多个版本的pod的时候可以把多余的卸载掉
sudo gem uninstall cocoapods
会提示我们选择卸载的版本
Select gem to uninstall: 1. cocoapods-1.2.1 2. cocoapods-1.3.1 3. All versions >
我们选择想要卸载的版本的序号就好了 。
cocoapods支持我们去查找想要使用的仓库 , 比如我们想查找ReactoveObjC这个库
pod spec cat ReactiveObjC
我们可以看到该仓库的配置信息。
{ "name": "ReactiveObjC", "version": "3.1.0", "summary": "The 2.x ReactiveCocoa Objective-C API: Streams of values over time", "description": "ReactiveObjC (formally ReactiveCocoa or RAC) is an Objective-C\nframework inspired by [Functional Reactive Programming](\nhttp://en.wikipedia.org/wiki/Functional_reactive_programming).\nIt provides APIs for composing and **transforming streams of values**.", "homepage": "https://reactivecocoa.io", "screenshots": "https://reactivecocoa.io/img/logo.png", "license": { "type": "MIT", "file": "LICENSE.md" }, "documentation_url": "https://github.com/ReactiveCocoa/ReactiveObjC/tree/master/Documentation#readme", "authors": "ReactiveCocoa", "social_media_url": "https://twitter.com/ReactiveCocoa", "platforms": { "ios": "8.0", "osx": "10.9", "watchos": "2.0", "tvos": "9.0" }, "source": { "git": "https://github.com/ReactiveCocoa/ReactiveObjC.git", "tag": "3.1.0" }, "source_files": [ "ReactiveObjC/*.{h,m,d}", "ReactiveObjC/extobjc/*.{h,m}" ], "private_header_files": [ "**/*Private.h", "**/*EXTRuntimeExtensions.h", "**/RACEmpty*.h" ], "ios": { "exclude_files": "ReactiveObjC/**/*{AppKit,NSControl,NSText,NSTable}*" }, "osx": { "exclude_files": "ReactiveObjC/**/*{UIActionSheet,UIAlertView,UIBarButtonItem,UIButton,UICollectionReusableView,UIControl,UIDatePicker,UIGestureRecognizer,UIImagePicker,UIRefreshControl,UISegmentedControl,UISlider,UIStepper,UISwitch,UITableViewCell,UITableViewHeaderFooterView,UIText,MK}*" }, "tvos": { "exclude_files": "ReactiveObjC/**/*{AppKit,NSControl,NSText,NSTable,UIActionSheet,UIAlertView,UIDatePicker,UIImagePicker,UIRefreshControl,UISlider,UIStepper,UISwitch,MK}*" }, "watchos": { "exclude_files": "ReactiveObjC/**/*{UIActionSheet,UIAlertView,UIBarButtonItem,UIButton,UICollectionReusableView,UIControl,UIDatePicker,UIGestureRecognizer,UIImagePicker,UIRefreshControl,UISegmentedControl,UISlider,UIStepper,UISwitch,UITableViewCell,UITableViewHeaderFooterView,UIText,MK,AppKit,NSControl,NSText,NSTable,NSURLConnection}*"
首先 , 新建一个singlgViewApp ,然后在命令行进入该project目录
pod init
我们可以看到cocoapods为我们生成了一个Podfile
platform表示这个工程安装的设备,后面是系统最低版本
现在我们可以在里面添加一下刚才搜索的仓库
# Uncomment the next line to define a global platform for your project platform :ios, '9.0' target 'ocTest' do # Uncomment the next line if you're using Swift or would like to use dynamic frameworks # use_frameworks! pod 'ReactiveObjC' # Pods for ocTest end
这里我们添加了一个仓库,接下来再命令行执行pod update来安装所需要的仓库,安装完毕后我们可以看到当前路径下有两个工程文件
我们在使用了cocoapods管理第三方库的时候,每次install或者update的时候就会生成*.xcworkspace这个文件我们需要使用这个工程进行开发调试。
现在打开工程,定位到viewController.m中就可以import并使用ReactiveObjC啦 。
公司内部有自己搭建的gitlab服务时,有的公司搭建的gitlab服务为了安全并没有提供外网接口,我们只能在内网访问,这时候就要在podfile中添加私有源的地址
source 'http://xx.xxxx.com/ios/cocoapods-spec.git' source 'https://github.com/CocoaPods/Specs.git' # 官方库
上面那个就是我们要添加的私有源地址,下面的是官方源地址,如果都不写的话那么默认就会使用官方源 。
pod lib create TDFCommonUtil
To get you started we need to ask a few questions, this should only take a minute. If this is your first time we recommend running through with the guide: - https://guides.cocoapods.org/making/using-pod-lib-create.html ( hold cmd and click links to open in a browser. ) What platform do you want to use?? [ iOS / macOS ] > ios What language do you want to use?? [ Swift / ObjC ] > swift Would you like to include a demo application with your library? [ Yes / No ] > yes Which testing frameworks will you use? [ Quick / None ] > None Would you like to do view based testing? [ Yes / No ] > NO
cd进入刚才创建的目录,执行命令 ls
可以看到控制台有以下输出。
Example README.md TDFCommonUtil.podspec LICENSE TDFCommonUtil _Pods.xcodeproj
解释一下这里都是啥
我们首先要为我们的pod创建一个实际的git仓库 。
打开gitlab服务创建一个空的git仓库 然后先把pod目录提交到我们的仓库 blalblabla
打开TDFCommonUtil.podspec文件
Pod::Spec.new do |s| s.name = 'TDFCommonUtil' s.version = '0.1.0' s.summary = 'A short description of TDFCommonUtil.' s.description = <<-DESC TODO: Add long description of the pod here. DESC s.homepage = 'https://github.com/[email protected]/TDFCommonUtil' s.license = { :type => 'MIT', :file => 'LICENSE' } s.author = { 'xxxxx' => '[email protected]' } s.source = { :git => 'https://github.com/[email protected]/TDFCommonUtil.git', :tag => s.version.to_s } s.ios.deployment_target = '8.0' s.source_files = 'TDFCommonUtil/Classes/**/*' # s.resource_bundles = { # 'TDFCommonUtil' => ['TDFCommonUtil/Assets/*.png'] # } # s.public_header_files = 'Pod/Classes/**/*.h' # s.frameworks = 'UIKit', 'MapKit' # s.dependency 'AFNetworking', '~> 2.3' end
这里的配置项就是生成pod需要配置的大部分选项了 ,简单介绍一下
现在把这些填好吧 。
有的时候我们开发的pod仓库需要依赖其他仓库,比如我们需要依赖ReactiveObjC
这里就可以在TDFCommonUtil.podspec下面添加这一行
s.dependency 'ReactiveObjC'
ps ,这里可以指向特定的版本也可以用 '~> 2.3' 的形式表示依赖此仓库至少大于2.3版本但是不会超过3.0 。
一切就绪后你可以在里面创建你的文件,添加代码了,别忘了再有文件的增加或删除后在运行一遍 ‘pod install’。
先随便创建几个文件,然后我们使用cocoapods检测我们的库
pod lib lint --sources='[email protected]:ios/cocoapods-spec.git' --use-libraries --allow-warnings --verbose --no-clean
这里的sources填写你所使用的私有gitlab服务,然后我们就可以静静的看着命令行了。
最后如果出现
Test passed validation.
证明你的库是可运行的,如果没有出现passed就注意下输出中的error信息,搜索一下error看是什么导致的 。
lint通过后我们就可以把自己的仓库信息推送到私有源了,注意不是「仓库」是「仓库信息」,也就是x.podspec 。
cocoapod可以自动帮我们完成这件事情
pod repo push xxx-cocoapods-spec TDFOpenShopSDK.podspec [email protected]:ios/cocoapods-spec.git --allow-warnings --use-libraries --verbose
Cocoapods极大方便了我们管理外部SDK和内部模块化解耦,用好这个管理工具无疑会为我们的工作效率带来巨大提升。