podspec文件解析

必要屬性
//
Pod::Spec.new do|s|
  //項目名
  s.name ='HycProject'
  //版本號
  s.version ='1.0.1'
  //listen文件的類型
  s.license = 'MIT'
  //簡單描述
  s.summary = 'ATest in iOS.'
  //項目的getub地址,只支持HTTP和HTTPS地址,不支持ssh的地址
  s.homepage ='https://github.com/hyc603671932/HycProject'
  //作者和郵箱
  s.authors = {'HouKavin' => '603671932@qq.com' }
  //git倉庫的https地址
  s.source = { :git=> 'https://github.com/hyc603671932/HycProject.git', :tag =>s.version}
  //是否要求arc(有部分非arc文件情況未考證)
  s.requires_arc = true
 //在這個屬性中聲明過的.h文件能夠使用<>方法聯(lián)想調用(這個是可選屬性)
  s.public_header_files = 'UIKit/*.h'
  //表示源文件的路徑,這個路徑是相對podspec文件而言的。(這屬性下面單獨討論)
  s.source_files ='AppInfo/*.*'
  //需要用到的frameworks,不需要加.frameworks后綴。(這個沒有用到也可以不填)
  s.frameworks ='Foundation', 'CoreGraphics', 'UIKit'
end

//可選屬性

Pod::Spec.new do|s|
  ...
  ...
  ...
  //詳細介紹
  s.description = "詳細介紹"
  //支持的平臺及版本
  s.platform     = :ios, '7.0' 
  //最低要求的系統(tǒng)版本
  s.ios.deployment_target= '7.0'
  //主頁,需填寫可訪問地址
  s.homepage = "https://coding.net/u/wtlucky/p/podTestLibrary"
  //截圖                      
  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' 
  
  //動態(tài)庫所使用的資源文件存放位置,放在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| 
      //最低要求的系統(tǒng)版本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庫,但系統(tǒng)會找不到這個庫的頭文件,需與下方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

后續(xù)步驟

//驗證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 //一樣代表使用最新版本(這個我測試用不起來)

附錄:gem環(huán)境安裝

# 查看RubyGems軟件的版本
gem -v
# 更新升級RubyGems軟件自身
gem update --system
# 更新所有已安裝的gem包
$ gem update
# 安裝指定gem包,程序先從本機查找gem包并安裝,如果本地沒有,則從遠程gem安裝。
gem install [gemname]
# 查看本機已安裝的所有gem包
gem list

附錄:清理本地spec文件緩存

//查看所有spec文件的緩存,可以直接到路徑下刪除文件
pod cache list
//刪除指定庫的緩存文件
pod cache clean AFNetworking
//運行podfile文件但不更新本地spec文件
pod install --no-repo-update
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發(fā)布,文章內容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容

  • 寫這篇文章的目的,是在項目組件化中,pod文件目錄下的文件夾多級(A>>B>>C)分組遇到的一些問題和解決思路 p...
    骨古閱讀 7,081評論 17 17
  • Ruby 安裝 要安裝cocospods 首先需要安裝ruby,可以先安裝xcode,再安裝macport ,最后...
    山天大畜閱讀 1,886評論 0 1
  • CocoaPods 是什么? CocoaPods 是一個負責管理 iOS 項目中第三方開源庫的工具。CocoaPo...
    朝洋閱讀 25,740評論 3 51
  • 項目組件化、平臺化是技術公司的共同目標,越來越多的技術公司推崇使用pod管理第三方庫以及私有組件,一方面使項目架構...
    swu_luo閱讀 22,161評論 0 39
  • 一. CocoaPods的介紹 什么是CocoaPods?CocoaPods是一個負責管理iOS項目中第三方開源庫...
    輝712閱讀 3,973評論 0 7