如何编写一个CocoaPods的spec文件

转载 2014年06月12日 14:46:45
原文:http://www.apkbus.com/android-131350-1-10.html

CocoaPods命令介绍

上一篇文章
中,已经介绍过CocoaPods的几条基本命令。
pod setup
用于初始化本地第三方库的Spec描述文件,所有的spec文件存都存放在
~/.cocoapods
目录中。
pod install
用来安装或删除Podfile文件声明中的第三方依赖库。下面继续介绍其它一些命令。
  1. $ pod list
  2. # 列出所有可用的第三方库
复制代码
  1. $ pod search query
复制代码
搜索名称包含query的类库,query可以替换为你想搜索的名字(如json),不区分大小写。也可以使用pod search --full query命令作更仔细的搜索,该命令不但搜索类库的名称,同时还搜索类库的描述文本,所以搜索速度也相对慢一些。 

pod listpod search命令只搜索存在于本地~/.cocoapods文件夹的所有第三方库,并不会连接到远程服务器。如果你要从服务器更新本地第三方库的描述文件,可以:
  1. $ pod repo update master
  2. 创建自己项目的Podspec描述文件
复制代码
CocoaPods还是一个相对年轻的项目,所有的项目的Podspec文件都托管在 。可能有一些库并未收录其中。下面我们通过为微博sso认证登录库编写Podspec文件来学习相关的概念。 

初始化一个Podspec文件
  1. $ pod spec create weibo_ios_sdk_sso-oauth
复制代码
该命令将在本目录产生一个名为weibo_ios_sdk_sso-oauth.podspec的文件。用编辑器打开该文件,里面已经有非常丰富的说明文档。下面我们介绍如何声明第三方库的代码目录和资源目录,还有该第三方库所依赖ios核心框架和第三方库。 

去除所有的注释,podspec文件如下所示:
  1. Pod::Spec.new do |s|
  2. s.name = 'ADVProgressBar'
  3. s.version = '0.0.1'
  4. s.license = 'MIT'
  5. s.summary = 'Progress Bar Design with Percentage values.'
  6. s.homepage = 'https://github.com/appdesignvault'
  7. s.author = { 'appdesignvault' => 'appdesignvault' }
  8. s.source = { :git => 'https://github.com/appdesignvault/ADVProgressBar.git', :commit => 'f17b15c15574d6d101cd5fcfd58239e16e806647' }
  9. s.platform = :ios 
  10. s.source_files = 'ADVProgressBar/Classes/*.{h,m}'
  11. s.resources = "ADVProgressBar/Resources/*.png"
  12. s.framework = 'UIKit'

  13. s.requires_arc = true 
  14. end
复制代码
其中s.names.summary用来声明库的名称和一个简短的说明文档。pod search命令就是根据这两项内容作为搜索文本的。s.homepage声明库的主页,s.version库原代码的版本,s.license所采用的授权版本,s.author库的作者。 

s.source 声明原代码的地址,以微博sso认证登录库为例,它托管在
  1. https://github.com/mobileresearch/weibo_ios_sdk_sso-oauth
复制代码
中,在其未尾加上.git扩展名就是库的原代码地址了,所以该行应声明为:
  1. 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最终如下:
  1. 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的目录结构:
  1. --
  2. |
  3. +-- demo
  4. |
  5. +-- src
  6. |
  7. +-- .gitignore
  8. |
  9. +-- README.md
复制代码
demo目录保存一个示例项目,src才是库的原代码目录。src的目录结构如下:
  1. -- src
  2. |
  3. +-- JSONKit
  4. |
  5. +-- SinaWeibo
  6. |
  7. +-- sinaweibo_ios_sdk.xcodeproj
  8. |
  9. +-- SinaWeibo-Prefix.pch
复制代码
JSONKit目录说明这个库本身依赖于JSONKit第三方库。我们可以在podspec文件中的s.dependency声明段中声明。SinaWeibo目录才是包含所有原代码的目录,我们需要在s.source_files中声明
  1. s.source_files = 'src/SinaWeibo/*.{h,m}'
复制代码
前一部分src/SinaWeibo/是一个相对目录,目录的层级关系一定要跟代码库的保持一致。最后一部分*.{h,m}是一个类似正则表达式的字符串,表示匹配所有以.h和.m为扩展名的文件。 

src/SinaWeibo/目录下还有一个SinaWeibo.bundle目录,该目录存放一些资源文件(如图片等),这些文件并不需要进行编译。可以使用s.resourcs声明
  1. s.resources = "src/SinaWeibo/SinaWeibo.bundle/**/*.png"
复制代码
前一部分跟上面相同,**表示匹配所有子目录,*.png表示所有以.png为扩展名的图片文件。 

通过查看代码我们知道,weibo_ios_sdk_sso-oauth还依赖一个ios的核心库QuartzCore
  1. s.framework = 'QuartzCore'
复制代码
在前面我们已经说过,weibo_ios_sdk_sso-oauth库自身也依赖于另外一个第三方库JSONKit,声明如下:
  1. s.dependency 'JSONKit', '~> 1.4'
复制代码
这行声明与Podfile文件中的声明类似。 

最终的结果如下:
  1. Pod::Spec.new do |s|
  2. s.name = "weibo_ios_sdk_sso-oauth"
  3. s.version = "0.0.1"
  4. s.summary = 'weibo.com sso oauth, 微博sso认证登录功能'
  5. s.homepage = "https://github.com/mobileresearch/weibo_ios_sdk_sso-oauth"
  6. s.license = 'MIT'
  7. s.author = {'mobileresearch' => 'mobileresearch'}
  8. s.source = { :git => 'https://github.com/mobileresearch/weibo_ios_sdk_sso-oauth.git', :commit => '68defea78942ecc782ffde8f8ffa747872af226d' }
  9. s.platform = :ios
  10. s.source_files = 'src/SinaWeibo/*.{h,m}'
  11. s.resources = "src/SinaWeibo/SinaWeibo.bundle/**/*.png"
  12. s.framework = 'QuartzCore'
  13. s.dependency 'JSONKit', '~> 1.4'
  14. end
复制代码
可以将该spec文件保存到本机的~/.cocoapods/master/目录中仅供自己使用,也可以将其提交到CocoaPods/Specs代码库中。下面我们将其保存到本机中
  1. $ mkdir -p ~/.cocoapods/master/weibo_ios_sdk_sso-oauth/0.0.1
  2. $ cp weibo_ios_sdk_sso-oauth.podspec ~/.cocoapods/master/weibo_ios_sdk_sso-oauth/0.0.1
复制代码
是否可以通过搜索找到该库:
  1. $ pod search weibo
复制代码
同样在需要依赖于weibo_ios_sdk_sso-oauth这个库的项目,可以将下列添加到项目的Podfile文件中
  1. pod 'weibo_ios_sdk_sso_oauth', '0.0.1'
复制代码
保存文件,并用pod install安装weibo_ios_sdk_sso-oauth库。 

Linux: 学习如何制作RPM包, SPEC文件如何编写

一 RPM介绍 RPM 前是Red Hat Package Manager 的缩写,本意是Red Hat 软件包管理,顾名思义是Red Hat 贡献出来的软件包管理;现在应为RPM Pack...
  • elfprincexu
  • elfprincexu
  • 2015年08月27日 11:07
  • 1768

最新的 CocoaPods 的使用教程 上传podspec

来源:Dely(@爱芸初见) 链接:http://www.jianshu.com/p/c6c258a7a3b8 背景 上一篇博客最新的 Coc...
  • qq_34047841
  • qq_34047841
  • 2016年12月01日 22:18
  • 450

linux-RPM 打包原理 SPEC 编写规范

一、编写spec脚本 由前面的日志了解到,生成rpm除了源码外,最重要的就是懂得编写.spec脚本。rpm建包的原理其实并不复杂,可以理解为按照标准的格式整理一些信息,包括:软件基础信息,以及安装、卸...
  • wf1982
  • wf1982
  • 2011年07月18日 18:17
  • 4882

CocoaPods was not able to update the `master` repo....

根据提示执行repo更新: $ pod repo update --verbose Updating spec repo `master` $ /usr/bin/git pull --f...
  • Enjolras1024
  • Enjolras1024
  • 2016年04月01日 15:46
  • 1028

制作rpm所依赖的spec文件详细说明

update log: 2010.01.08 加入SPEC文件中的宏定义和变量 2010.01.08 关键字说明,如何在升级过程中不覆盖配置文件     为什么要制作rpm包,以及如何...
  • yangyu19910407
  • yangyu19910407
  • 2013年06月28日 18:37
  • 1133

CocoaPods版本升级遇到问题以及解决方案

控制器进入目录执行pod install: $ pod install Analyzing dependencies [!] The version of CocoaPods used to gene...
  • lichuanlong007
  • lichuanlong007
  • 2016年08月12日 09:36
  • 2037

SPEC文件详解

1 spec文件 1.1 spec文件的语法 TagName: value 比如 Version: 2.1.0 tag名大小写不敏感。 1.2 宏 ...
  • wangxin6722513
  • wangxin6722513
  • 2016年04月11日 16:49
  • 4061

CocoaPods详解之----制作篇

CocoaPods详解之----制作篇 作者:wangzz 原文地址:http://blog.csdn.net/wzzvictory/article/details/19178709 转载请注...
  • wzzvictory_tjsd
  • wzzvictory_tjsd
  • 2014年03月04日 16:05
  • 28749

rpmbuild spec文件的注释问题

请注意:以#开头的一行为注释,如果在注释里加%会产生错误,如%prep,应该加上两个%,即%%prep...
  • qianggezhishen
  • qianggezhishen
  • 2015年11月17日 14:08
  • 1331

Cocoapods: pod search无法搜索到类库的解决办法

缘由 按照往常的方法一样安装Cocoapods,在安装的过程中遇到了一切问题,按照传统的命令sudo gem install cocoapods出现了如下的错误: ERROR: Whil...
  • yuanmengong886
  • yuanmengong886
  • 2017年02月25日 16:32
  • 2267
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:如何编写一个CocoaPods的spec文件
举报原因:
原因补充:

(最多只允许输入30个字)