cocoa pods
2016-01-22 16:38
148 查看
在
上一篇文章
中,已经介绍过CocoaPods的几条基本命令。
pod setup
用于初始化本地第三方库的Spec描述文件,所有的spec文件存都存放在
~/.cocoapods
目录中。
pod install
用来安装或删除Podfile文件声明中的第三方依赖库。下面继续介绍其它一些命令。
$ pod list
# 列出所有可用的第三方库
复制代码
$ pod search query
复制代码
搜索名称包含 query的类库, query可以替换为你想搜索的名字(如json),不区分大小写。也可以使用 pod
search --full query命令作更仔细的搜索,该命令不但搜索类库的名称,同时还搜索类库的描述文本,所以搜索速度也相对慢一些。
pod list和 pod search命令只搜索存在于本地 ~/.cocoapods文件夹的所有第三方库,并不会连接到远程服务器。如果你要从服务器更新本地第三方库的描述文件,可以:
$ pod repo update master
创建自己项目的Podspec描述文件
复制代码
CocoaPods还是一个相对年轻的项目,所有的项目的Podspec文件都托管在
https://github.com/CocoaPods/Specs
。可能有一些库并未收录其中。下面我们通过为微博sso认证登录库编写Podspec文件来学习相关的概念。
初始化一个Podspec文件
$ pod spec create weibo_ios_sdk_sso-oauth
复制代码
该命令将在本目录产生一个名为 weibo_ios_sdk_sso-oauth.podspec的文件。用编辑器打开该文件,里面已经有非常丰富的说明文档。下面我们介绍如何声明第三方库的代码目录和资源目录,还有该第三方库所依赖ios核心框架和第三方库。
去除所有的注释,podspec文件如下所示:
Pod::Spec.new do |s|
s.name = 'ADVProgressBar'
s.version = '0.0.1'
s.license = 'MIT'
s.summary = 'Progress Bar Design with Percentage values.'
s.homepage = 'https://github.com/appdesignvault'
s.author = { 'appdesignvault' => 'appdesignvault' }
s.source = { :git => 'https://github.com/appdesignvault/ADVProgressBar.git', :commit => 'f17b15c15574d6d101cd5fcfd58239e16e806647' }
s.platform = :ios
s.source_files = 'ADVProgressBar/Classes/*.{h,m}'
s.resources = "ADVProgressBar/Resources/*.png"
s.framework = 'UIKit'
s.requires_arc = true
end
复制代码
其中 s.name和 s.summary用来声明库的名称和一个简短的说明文档。 pod search命令就是根据这两项内容作为搜索文本的。 s.homepage声明库的主页, s.version库原代码的版本, s.license所采用的授权版本, s.author库的作者。
s.source 声明原代码的地址,以微博sso认证登录库为例,它托管在
https://github.com/mobileresearch/weibo_ios_sdk_sso-oauth
复制代码
中,在其未尾加上 .git扩展名就是库的原代码地址了,所以该行应声明为:
s.source = { :git => 'https://github.com/mobileresearch/weibo_ios_sdk_sso-oauth.git'}
复制代码
对于很多第三方库而言,在发布的时候都会打上一个 tag,如版本 0.0.1就会打上一个名为v0.0.1的tag,但是 weibo_ios_sdk_sso-oauth库还未打上所何tag,我们可以选择一个最新的commit来作为该库0.0.1版的代码。 s.source最终如下:
s.source = { :git => 'https://github.com/mobileresearch/weibo_ios_sdk_sso-oauth.git', :commit => '68defea78942ecc782ffde8f8ffa747872af226d'}
复制代码
以后我们可以根据该库不同的版本创建相应的podspec文件,例如0.0.2,0.1.0等。
让我们在浏览器中看一下weibo_ios_sdk_sso-oauth的目录结构:
--
|
+-- demo
|
+-- src
|
+-- .gitignore
|
+-- README.md
复制代码
demo目录保存一个示例项目,src才是库的原代码目录。src的目录结构如下:
-- src
|
+-- JSONKit
|
+-- SinaWeibo
|
+-- sinaweibo_ios_sdk.xcodeproj
|
+-- SinaWeibo-Prefix.pch
复制代码
JSONKit目录说明这个库本身依赖于JSONKit第三方库。我们可以在podspec文件中的 s.dependency声明段中声明。SinaWeibo目录才是包含所有原代码的目录,我们需要在 s.source_files中声明
s.source_files = 'src/SinaWeibo/*.{h,m}'
复制代码
前一部分src/SinaWeibo/是一个相对目录,目录的层级关系一定要跟代码库的保持一致。最后一部分 *.{h,m}是一个类似正则表达式的字符串,表示匹配所有以.h和.m为扩展名的文件。
src/SinaWeibo/目录下还有一个 SinaWeibo.bundle目录,该目录存放一些资源文件(如图片等),这些文件并不需要进行编译。可以使用 s.resourcs声明
s.resources = "src/SinaWeibo/SinaWeibo.bundle/**/*.png"
复制代码
前一部分跟上面相同, **表示匹配所有子目录, *.png表示所有以.png为扩展名的图片文件。
通过查看代码我们知道,weibo_ios_sdk_sso-oauth还依赖一个ios的核心库QuartzCore
s.framework = 'QuartzCore'
复制代码
在前面我们已经说过,weibo_ios_sdk_sso-oauth库自身也依赖于另外一个第三方库JSONKit,声明如下:
s.dependency 'JSONKit', '~> 1.4'
复制代码
这行声明与Podfile文件中的声明类似。
最终的结果如下:
Pod::Spec.new do |s|
s.name = "weibo_ios_sdk_sso-oauth"
s.version = "0.0.1"
s.summary = 'weibo.com sso oauth, 微博sso认证登录功能'
s.homepage = "https://github.com/mobileresearch/weibo_ios_sdk_sso-oauth"
s.license = 'MIT'
s.author = {'mobileresearch' => 'mobileresearch'}
s.source = { :git => 'https://github.com/mobileresearch/weibo_ios_sdk_sso-oauth.git', :commit => '68defea78942ecc782ffde8f8ffa747872af226d' }
s.platform = :ios
s.source_files = 'src/SinaWeibo/*.{h,m}'
s.resources = "src/SinaWeibo/SinaWeibo.bundle/**/*.png"
s.framework = 'QuartzCore'
s.dependency 'JSONKit', '~> 1.4'
end
复制代码
可以将该spec文件保存到本机的~/.cocoapods/master/目录中仅供自己使用,也可以将其提交到CocoaPods/Specs代码库中。下面我们将其保存到本机中
$ mkdir -p ~/.cocoapods/master/weibo_ios_sdk_sso-oauth/0.0.1
$ cp weibo_ios_sdk_sso-oauth.podspec ~/.cocoapods/master/weibo_ios_sdk_sso-oauth/0.0.1
复制代码
是否可以通过搜索找到该库:
$ pod search weibo
复制代码
同样在需要依赖于weibo_ios_sdk_sso-oauth这个库的项目,可以将下列添加到项目的Podfile文件中
pod 'weibo_ios_sdk_sso_oauth', '0.0.1'
复制代码
保存文件,并用 pod install安装weibo_ios_sdk_sso-oauth库。
上一篇文章
中,已经介绍过CocoaPods的几条基本命令。
pod setup
用于初始化本地第三方库的Spec描述文件,所有的spec文件存都存放在
~/.cocoapods
目录中。
pod install
用来安装或删除Podfile文件声明中的第三方依赖库。下面继续介绍其它一些命令。
$ pod list
# 列出所有可用的第三方库
复制代码
$ pod search query
复制代码
搜索名称包含 query的类库, query可以替换为你想搜索的名字(如json),不区分大小写。也可以使用 pod
search --full query命令作更仔细的搜索,该命令不但搜索类库的名称,同时还搜索类库的描述文本,所以搜索速度也相对慢一些。
pod list和 pod search命令只搜索存在于本地 ~/.cocoapods文件夹的所有第三方库,并不会连接到远程服务器。如果你要从服务器更新本地第三方库的描述文件,可以:
$ pod repo update master
创建自己项目的Podspec描述文件
复制代码
CocoaPods还是一个相对年轻的项目,所有的项目的Podspec文件都托管在
https://github.com/CocoaPods/Specs
。可能有一些库并未收录其中。下面我们通过为微博sso认证登录库编写Podspec文件来学习相关的概念。
初始化一个Podspec文件
$ pod spec create weibo_ios_sdk_sso-oauth
复制代码
该命令将在本目录产生一个名为 weibo_ios_sdk_sso-oauth.podspec的文件。用编辑器打开该文件,里面已经有非常丰富的说明文档。下面我们介绍如何声明第三方库的代码目录和资源目录,还有该第三方库所依赖ios核心框架和第三方库。
去除所有的注释,podspec文件如下所示:
Pod::Spec.new do |s|
s.name = 'ADVProgressBar'
s.version = '0.0.1'
s.license = 'MIT'
s.summary = 'Progress Bar Design with Percentage values.'
s.homepage = 'https://github.com/appdesignvault'
s.author = { 'appdesignvault' => 'appdesignvault' }
s.source = { :git => 'https://github.com/appdesignvault/ADVProgressBar.git', :commit => 'f17b15c15574d6d101cd5fcfd58239e16e806647' }
s.platform = :ios
s.source_files = 'ADVProgressBar/Classes/*.{h,m}'
s.resources = "ADVProgressBar/Resources/*.png"
s.framework = 'UIKit'
s.requires_arc = true
end
复制代码
其中 s.name和 s.summary用来声明库的名称和一个简短的说明文档。 pod search命令就是根据这两项内容作为搜索文本的。 s.homepage声明库的主页, s.version库原代码的版本, s.license所采用的授权版本, s.author库的作者。
s.source 声明原代码的地址,以微博sso认证登录库为例,它托管在
https://github.com/mobileresearch/weibo_ios_sdk_sso-oauth
复制代码
中,在其未尾加上 .git扩展名就是库的原代码地址了,所以该行应声明为:
s.source = { :git => 'https://github.com/mobileresearch/weibo_ios_sdk_sso-oauth.git'}
复制代码
对于很多第三方库而言,在发布的时候都会打上一个 tag,如版本 0.0.1就会打上一个名为v0.0.1的tag,但是 weibo_ios_sdk_sso-oauth库还未打上所何tag,我们可以选择一个最新的commit来作为该库0.0.1版的代码。 s.source最终如下:
s.source = { :git => 'https://github.com/mobileresearch/weibo_ios_sdk_sso-oauth.git', :commit => '68defea78942ecc782ffde8f8ffa747872af226d'}
复制代码
以后我们可以根据该库不同的版本创建相应的podspec文件,例如0.0.2,0.1.0等。
让我们在浏览器中看一下weibo_ios_sdk_sso-oauth的目录结构:
--
|
+-- demo
|
+-- src
|
+-- .gitignore
|
+-- README.md
复制代码
demo目录保存一个示例项目,src才是库的原代码目录。src的目录结构如下:
-- src
|
+-- JSONKit
|
+-- SinaWeibo
|
+-- sinaweibo_ios_sdk.xcodeproj
|
+-- SinaWeibo-Prefix.pch
复制代码
JSONKit目录说明这个库本身依赖于JSONKit第三方库。我们可以在podspec文件中的 s.dependency声明段中声明。SinaWeibo目录才是包含所有原代码的目录,我们需要在 s.source_files中声明
s.source_files = 'src/SinaWeibo/*.{h,m}'
复制代码
前一部分src/SinaWeibo/是一个相对目录,目录的层级关系一定要跟代码库的保持一致。最后一部分 *.{h,m}是一个类似正则表达式的字符串,表示匹配所有以.h和.m为扩展名的文件。
src/SinaWeibo/目录下还有一个 SinaWeibo.bundle目录,该目录存放一些资源文件(如图片等),这些文件并不需要进行编译。可以使用 s.resourcs声明
s.resources = "src/SinaWeibo/SinaWeibo.bundle/**/*.png"
复制代码
前一部分跟上面相同, **表示匹配所有子目录, *.png表示所有以.png为扩展名的图片文件。
通过查看代码我们知道,weibo_ios_sdk_sso-oauth还依赖一个ios的核心库QuartzCore
s.framework = 'QuartzCore'
复制代码
在前面我们已经说过,weibo_ios_sdk_sso-oauth库自身也依赖于另外一个第三方库JSONKit,声明如下:
s.dependency 'JSONKit', '~> 1.4'
复制代码
这行声明与Podfile文件中的声明类似。
最终的结果如下:
Pod::Spec.new do |s|
s.name = "weibo_ios_sdk_sso-oauth"
s.version = "0.0.1"
s.summary = 'weibo.com sso oauth, 微博sso认证登录功能'
s.homepage = "https://github.com/mobileresearch/weibo_ios_sdk_sso-oauth"
s.license = 'MIT'
s.author = {'mobileresearch' => 'mobileresearch'}
s.source = { :git => 'https://github.com/mobileresearch/weibo_ios_sdk_sso-oauth.git', :commit => '68defea78942ecc782ffde8f8ffa747872af226d' }
s.platform = :ios
s.source_files = 'src/SinaWeibo/*.{h,m}'
s.resources = "src/SinaWeibo/SinaWeibo.bundle/**/*.png"
s.framework = 'QuartzCore'
s.dependency 'JSONKit', '~> 1.4'
end
复制代码
可以将该spec文件保存到本机的~/.cocoapods/master/目录中仅供自己使用,也可以将其提交到CocoaPods/Specs代码库中。下面我们将其保存到本机中
$ mkdir -p ~/.cocoapods/master/weibo_ios_sdk_sso-oauth/0.0.1
$ cp weibo_ios_sdk_sso-oauth.podspec ~/.cocoapods/master/weibo_ios_sdk_sso-oauth/0.0.1
复制代码
是否可以通过搜索找到该库:
$ pod search weibo
复制代码
同样在需要依赖于weibo_ios_sdk_sso-oauth这个库的项目,可以将下列添加到项目的Podfile文件中
pod 'weibo_ios_sdk_sso_oauth', '0.0.1'
复制代码
保存文件,并用 pod install安装weibo_ios_sdk_sso-oauth库。
相关文章推荐
- PAT 1035. 插入与归并(25) 第二测试点不通过
- Python 爬虫入门(一)
- java代码中添加log4j日志
- 《从零开始学Swift》学习笔记(Day 63)——Cocoa Touch设计模式及应用之单例模式
- JavaScript:JS视频总结
- JS 解析map 格式JSON super.makeJSONObject(req, res, map);
- Ubuntu 为 root 帐号开启 SSH 登录
- CollectionPicker
- OC中的内存管理
- mysql 编辑距离levenshtein函数
- Linux 目录结构
- css的div垂直居中的方法,百分比div垂直居中
- 杭电1056——HangOver(水题)
- php js 截取指定的字符串 获取当前的连接地址
- (总结)Linux的chattr与lsattr命令详解
- 领域模型、贫血模型、充血模型概念总结
- 添加指纹识别功能
- Python程序员都会喜欢的6个库
- Volley源码解析
- iptables 定义规则