iOS podspec 文件简介Podfile引入版本写法

.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/'  
  //效果和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
    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