CocoaPods
安装:
1.升级Ruby。
2.升级gem。
3.更换Ruby镜像源,换成国内的地址。
4.安装CocoaPods 命令sudo gem install cocoapods。
5.更新索引仓库 pod setup 。(1G左右,比较耗时)
完成
使用:
1.创建Podfile文件。cd到工程目录下 pod init,创建podfile文件
2.进podfile文件填写需要的库
3.安装第三方库 pod install
一、本地私有库
1.文件准备
创建库文件夹:JDStorage;里面添加需要共享的文件,如JDTextEditViewController,里面创建Classes放代码。使用命令行,cd到JDTextEditViewController,添加git管理:
git init
git add .
git commit -m 'xx'
2.创建spec文件:
pod spec create JDTextEditViewController
编辑spec文件:
s.summary = "文本编辑控制器"
s.description = <<-DESC
"此文本编辑控制器包含单行和多行的文本编辑,对应UITextField和UITextView"
DESC
s.source = { :git => "", :tag => "#{s.version}" } //git地址为空
s.license = "MIT"
# s.exclude_files = "Classes/Exclude" //注释掉
3.在有需要工程中使用该私有库
在Podfile中的pod要加上本地的相对路径
platform :ios, '8.0'
target 'JDTestProject' do
use_frameworks!
pod 'JDTextEditViewController', :path => '../JDProject/JDTextEditViewController'
end
二、远程私有库
1.创建私有描述文件库
到git平台创建私有描述文件库,如在Gitee平台添加:Specs项目。
在平台账号设置中添加本机生成的ssh
2.关联到本地描述文件夹
specs关联克隆到本地
pod repo add GiteeJDSpecs [email protected]:jdbb/Specs.git
执行后会在路径/Users/gyenno/.cocoapods/repos下生成一个GiteeJDSpecs文件夹。(官方的master索引库也在该repos文件夹下)
3.创建项目
在平台新建项目JDViewExtension;克隆项目到本地,并添加文件上传(cd到目标文件夹):
git init
git remote add origin https://gitee.com/jdbb/JDViewExtension.git
git pull origin master
//添加文件后(好像是工程项目文件才可以)
git add .
git commit -m '新建文件'
git push origin master
//并打tag(此tag要跟spec文件上的tag一致)
git tag '1.0.0'
git push --tags
4.创建podspec文件
pod spec create JDViewExtension
编辑:
s.name = "JDViewExtension"
s.version = "1.0.0"
s.description = <<-DESC
"提供view直接调用的width、height等属性。"
DESC
s.homepage = "https://gitee.com"
s.license = { :type => "MIT", :file => "LICENSE" }
s.author = { "xxx" => "[email protected]" }
s.platform = :ios
s.source = { :git => "https://gitee.com/jdbb/JDViewExtension.git", :tag => "#{s.version}" }
s.source_files = "Classes", "Classes/**/*.{h,m}"
s.frameworks = "Foundation", "UIKit"
注:license文件可参考网上的,把版权名字改为个人就可以
编辑完后验证本地的spec文件:
pod spec lint
验证成功后可以上传spec文件到平台项目中,同时也会在本地对应spec下:
pod repo push GiteeJDSpecs JDViewExtension.podspec
注:上面的GiteeJDSpecs为本地对应的spec文件库(因为之前已经建立了和远程的映射关系),JDViewExtension.podspec为要上传的文件
上传完后可以看一下平台的spec仓库和本地的spec仓库有没有JDViewExtension文件,
5.使用
在Podfile文件中添加:
platform :ios, '8.0'
source '[email protected]:jdbb/Specs.git'
source 'https://github.com/CocoaPods/Specs.git'
target 'JDTestProject' do
use_frameworks!
pod 'JDViewExtension', '~> 1.0.1'
pod 'AFNetworking', '~> 3.2.1'
end
注意:此处的source是specs库的地址
6.使用时更新pod项目
JDViewExtension有改动时,更新spec文件,提交后要打tag,并同步spec文件
三、 subspec分支
注释掉s.source_files,使用分支,分支的总和要包含原s.source_files的内容,dependency依赖的框架也可以写在各分支里面
# s.source_files = 'DownLoader/Classes/**/*'
s.subspec 'Category' do |category|
category.source_files = 'DownLoader/Classes/Category/**/*'
end
s.subspec 'DownLoader' do |downLoader|
downLoader.source_files = 'DownLoader/Classes/DownLoader/**/*'
category.dependency 'AFNetworking', '~> 3.0'
end