.podspec 文件简介
- 必要属性
//
Pod::Spec.new do|s|
//项目名
s.name ='ZCTest'
//版本号
s.version ='0.1.0'
//listen文件的类型
s.license = { :type => 'MIT', :file => 'LICENSE' }
//简单描述
s.summary = 'A short description of ZCTest.'
//项目的getub地址,只支持HTTP和HTTPS地址,不支持ssh的地址
s.homepage ='https://git.coding.net/zczczyc'
//作者和邮箱
s.author = { 'zczczyc' => 'gitzczyc' }
//git仓库的https地址
s.source = { :git=> 'https://git.coding.net/zczczyc/ZCTest.git', :tag =>s.version}
//是否要求arc(有部分非arc文件情况未考证)
s.requires_arc = true
//在这个属性中声明过的.h文件能够使用<>方法联想调用(这个是可选属性)
s.public_header_files = 'UIKit/*.h'
//表示源文件的路径,这个路径是相对podspec文件而言的。(这属性下面单独讨论)
s.source_files = 'ZCTest/Classes/**/*'
//需要用到的frameworks,不需要加.frameworks后缀。(这个没有用到也可以不填)
s.frameworks ='Foundation', 'CoreGraphics', 'UIKit'
end
- 可选属性
Pod::Spec.new do|s|
...
...
...
//详细介绍
s.description = "详细介绍"
//支持的平台及版本
s.platform = :ios, '8.0'
//最低要求的系统版本
s.ios.deployment_target= '8.0'
//主页,需填写可访问地址
s.homepage = "https://coding.net/u/zczczyc"
//截图
s.screenshots = "www.example.com/screenshots_1"
//多媒体介绍地址
s.social_media_url = 'https://twitter.com/<twitter_username>'
//效果和s.public_header_files的相同,只需要配置一种
s.ios.public_header_files = 'URS/URSAuth.h'
//不常用,所有文件默认即为private只能用import"XXX"调用
s.ios.private_header_files
#依赖关系,该项目所依赖的其他库
s.dependency 'AFNetworking', '~> 2.3'
//可拥有多个dependency依赖属性
s.dependency 'JSONKit', '~> 1.4'
//动态库所使用的资源文件存放位置,放在Resources文件夹中
s.resource_bundles = {
'Test5' => ['Test5/Assets/*.png']
}
//资源文件(具体使用带考证)
s.resources = 'src/SinaWeibo/SinaWeibo.bundle/**/*.png'
//建立名称为Info的子文件夹(虚拟路径)
s.subspec 'Info' do |ss|
//应该和s.subspec作用相同(未考证)
s.default_subspec
end
- s.source_files
//下载AppInfo文件夹下的所有文件,子文件夹不识别
s.source_files ='AppInfo'
//下载AppInfo目录下所有格式文件
s.source_files ='AppInfo/*.*'
**/*表示Classes目录及其子目录下所有文件
s.source_files = 'AppInfo/**/*'
//下载HycProject文件夹下名称为AppManInfo和AppWomanInfo的共4项文件
s.source_files ='HycProject/App{Man,Woman}Info.{h,m}'
//目标路径下的文件不进行下载
s.ios.exclude_files = 'AppInfo/Info/json'
- 文件层次
Pod::Spec.new do|s|
//第一层文件夹名称HycProject
s.name ='HycProject'
...
...
...
//第二层文件夹名称AppInfo(虚拟路径)
s.subspec 'AppInfo' do |ss|
//下载HycProject文件夹下AppInfo的.h和.m文件
ss.source_files = 'HycProject/AppInfo.{h,m}'
//允许使用import<AppInfo.h>
ss.public_header_files = 'HycProject/AppInfo.h'
//依赖的frameworks
ss.ios.frameworks = 'MobileCoreServices', 'CoreGraphics'
//第三层文件夹名称Info(虚拟路径)
ss.subspec 'Info' do |sss|
//最低要求的系统版本7.0
sss.ios.deployment_target = '7.0'
//只允许使用import"AppInfo.h"访问
sss.ios.private_header_files = 'AppInfo/Info/**/*.h'
// 下载路径下的.h/.m/.c文件
sss.ios.source_files = 'AppInfo/Info/**/*.{h,m,c}'
//引用xml2库,但系统会找不到这个库的头文件,需与下方sss.xcconfig配合使用(这里省略lib)
sss.libraries = "xml2"
//在pod target项的Header Search Path中配置:${SDK_DIR}/usr/include/libxml2
sss.xcconfig = { 'HEADER_SEARCH_PATHS' => '${SDK_DIR}/usr/include/libxml2' }
//json目录下的文件不做下载
sss.ios.exclude_files = 'AppInfo/Info/json'
end
end
end
- 后续步骤
//验证podspec文件是否可正常使用
命令行:pod lib lint
//上传podspec到trunk服务器中
命令行:pod trunk push HycProject.podspec
//上传需要一定时间,成功后更新本地pod依赖库
命令行:pod setup
//查看代码有没有通过审核版本是否更新
命令行:pod search HycProject
//下载线上git仓库(Podfile文件不在此讨论)
命令行:pod install
- 关于Podfile文件编辑时,第三方库版本号的各种写法
pod ‘AFNetworking’ //不显式指定依赖库版本,表示每次都获取最新版本
pod ‘AFNetworking’, ‘2.0’ //只使用2.0版本
pod ‘AFNetworking’, ‘>2.0′ //使用高于2.0的版本
pod ‘AFNetworking’, ‘>=2.0′ //使用大于或等于2.0的版本
pod ‘AFNetworking’, ‘<2.0′ //使用小于2.0的版本
pod ‘AFNetworking’, ‘<=2.0′ //使用小于或等于2.0的版本
pod ‘AFNetworking’, ‘~>0.1.2′ //使用大于等于0.1.2但小于0.2的版本,相当于>=0.1.2并且<0.2.0
pod ‘AFNetworking’, ‘~>0.1′ //使用大于等于0.1但小于1.0的版本
pod ‘AFNetworking’, ‘~>0′ //高于0的版本,写这个限制和什么都不写是一个效果,都表示使用最新版本
pod ‘AFNetworking’, :head //一样代表使用最新版本
- 附录:清理本地spec文件缓存
//查看所有spec文件的缓存,可以直接到路径下删除文件
pod cache list
//删除指定库的缓存文件
pod cache clean AFNetworking
//运行podfile文件但不更新本地spec文件
pod install --no-repo-update