cocoapods系列教程---安裝與使用
cocoapods系列教程---Podfile文件
cocoapods系列教程---Podfile.lock文件 和 Spec Repo
cocoapods系列教程---spec文件
cocoapods系列教程---原理篇
cocoapods系列教程---讓自己的開(kāi)源框架支持cocoapods
cocoapods系列教程---模塊化設(shè)計(jì)
cocoapods系列教程---創(chuàng)建私有pods

下面介紹spec文件的詳細(xì)設(shè)置.基本上是根據(jù)官網(wǎng)翻譯過(guò)來(lái)的,有什么不對(duì)還望指點(diǎn)

• name

spec.name = 'AFNetworking'

• 版本

spec.version = '0.0.1'

• 支持的cocoapods的版本

spec.cocoapods_version = '>= 0.36'

• 配置信息,根據(jù)個(gè)人需要填寫

spec.xcconfig = { 'HEADER_SEARCH_PATHS' => '$(SDKROOT)/usr/include/libxml2' }
  
spec.xcconfig = { 'FRAMEWORK_SEARCH_PATHS' => '"
$(SRCROOT)/libs/Frameworks/Huoyan"' }   
  
spec.xcconfig  = { 'LIBRARY_SEARCH_PATHS' => '"$(PODS_ROOT)/iOS_Util/iOS_Util/AMR/lib"' }

spec.xcconfig  = { "HEADER_SEARCH_PATHS" => "${PODS_ROOT}/boost" }
    

• 作者信息

spec.author = 'Darth Vader'

若果有多個(gè)作者,可以這樣寫

spec.authors = 'Darth Vader', 'Wookiee'

spec.authors = { 'Darth Vader' => 'darthvader@darkside.com',
                 'Wookiee'     => 'wookiee@aggrrttaaggrrt.com' }

• 多媒體地址,如果地址是twitter,發(fā)布版本會(huì)有通知

spec.social_media_url = 'https://twitter.com/cocoapods'

spec.social_media_url = 'https://groups.google.com/forum/#!forum/cocoapods'

• 許可,一般MIT,默認(rèn)與spec文件在同一目錄下

spec.license = 'MIT'

• 指定許可文件

spec.license = { :type => 'MIT', :file => 'MIT-LICENSE.txt' }

指定許可文件的內(nèi)容

spec.license = { :type => 'MIT', :text => <<-LICENSE
                   Copyright 2012
                   Permission is granted to...
                 LICENSE
               }

• 項(xiàng)目主頁(yè)

spec.homepage = 'http://www.example.com'

• 項(xiàng)目git地址,tag值與spec.verison版本一致

spec.source = { :git => 'https://github.com/AFNetworking/AFNetworking.git',
                :tag => spec.version.to_s }

項(xiàng)目git地址,tag值以v開(kāi)頭,支持子模塊(子模塊是git的子模塊)

spec.source = { :git => 'https://github.com/typhoon-framework/Typhoon.git',
                :tag => "v#{spec.version}", :submodules => true }

項(xiàng)目svn地址

spec.source = { :svn => 'http://svn.code.sf.net/p/polyclipping/code', :tag => '4.8.8' }

項(xiàng)目壓縮包地址

spec.source = { :http => 'http://dev.wechatapp.com/download/sdk/WeChat_SDK_iOS_en.zip' }

指定壓縮包地址,并校驗(yàn)hash值,支持sha1 和 sha256

spec.source = { :http => 'http://dev.wechatapp.com/download/sdk/WeChat_SDK_iOS_en.zip',
                :sha1 => '7e21857fe11a511f472cfd7cfa2d979bd7ab7d96' }

指定為本地地址

podspec :path => '/Documents/PrettyKit/PrettyKit.podspec'

• 簡(jiǎn)介

spec.summary = 'Computes the meaning of life.'

• 詳細(xì)描述

spec.description = <<-DESC

                   這里寫描述內(nèi)容
                    
                   DESC
                   

• 單個(gè)截圖

spec.screenshot  = 'http://dl.dropbox.com/u/378729/MBProgressHUD/1.png'

• 多個(gè)截圖

spec.screenshots = [ 'http://dl.dropbox.com/u/378729/MBProgressHUD/1.png',
                     'http://dl.dropbox.com/u/378729/MBProgressHUD/2.png' ]
                     

• 文檔說(shuō)明

spec.documentation_url = 'http://www.example.com/docs.html'

• prepare_command,在pod文件下載完畢之后,執(zhí)行的命令,原文如下

A bash script that will be executed after the Pod is downloaded. This command can be used to create, delete and modify any file downloaded and will be ran before any paths for other file attributes of the specification are collected.

This command is executed before the Pod is cleaned and before the Pods project is created. The working directory is the root of the Pod.

If the pod is installed with the :path option this command will not be executed.

單個(gè)命令

spec.prepare_command = 'ruby build_files.rb'

多條命令

spec.prepare_command = <<-CMD
                        sed -i 's/MyNameSpacedHeader/Header/g' ./**/*.h
                        sed -i 's/MyNameOtherSpacedHeader/OtherHeader/g' ./**/*.h
                   CMD
                   

• 是否過(guò)期

spec.deprecated = true

• 支持的平臺(tái),如果不寫默認(rèn)支持所有平臺(tái)

spec.platform = :ios //僅支持ios

支持多個(gè)平臺(tái)

spec.ios.deployment_target = '6.0'

spec.osx.deployment_target = '10.8'

• 依賴的第三方

spec.dependency 'AFNetworking', '~> 1.0'

指定某個(gè)平臺(tái)的依賴

spec.ios.dependency 'MBProgressHUD', '~> 0.5'

• 是否是ARC,默認(rèn)true,如果不是,會(huì)自動(dòng)添加-fno-objc-arc compiler flag

spec.requires_arc = true

部分是ARC

spec.requires_arc = false
spec.requires_arc = 'Classes/Arc'   //該文件夾下是ARC,其它非ARC
spec.requires_arc = ['Classes/*ARC.m', 'Classes/ARC.mm']

• 依賴的系統(tǒng)的框架

spec.ios.framework = 'CFNetwork'

多個(gè)framework,用逗號(hào)分開(kāi)

spec.frameworks = 'QuartzCore', 'CoreData'

• weak_frameworks
  如果在高版本的OS中調(diào)用新增的功能，并且在低版本的OS中依然能夠運(yùn)行,那么就要用到weak_frameworks.如果引用的某些類或者接口在低版本中并不支持，對(duì)于不支持的接口，可以在運(yùn)行的時(shí)候判斷，這樣程序不會(huì)出錯(cuò)，如果不weak引用，程序在低版本下啟動(dòng)的時(shí)候就會(huì)崩潰掉

spec.weak_framework = 'MessageUI'

• libraries 比如libz,sqlite3.0等,多個(gè)用逗號(hào)分開(kāi)

spec.libraries = 'xml2', 'z'  //z表示libz.tdb,后綴不需要,lib開(kāi)頭的省略lib

• compiler_flags

spec.compiler_flags = '-DOS_OBJECT_USE_OBJC=0', '-Wno-format'

• prefix_header_contents 類似于pch,文件,多個(gè)用逗號(hào)隔開(kāi)

spec.prefix_header_contents = '#import <UIKit/UIKit.h>', '#import <Foundation/Foundation.h>'

也可以這樣寫:

s.prefix_header_contents = <<-EOS
 #ifdef __OBJC__
 #import "SGExtension.h"    //SGExtension包含了所有頭文件
 #endif 
EOS
end

• 指定pch文件

spec.prefix_header_file = 'iphone/include/prefix.pch'

• 源文件

spec.source_files = 'Classes/**/*.{h,m}'
spec.source_files = 'Classes/**/*.{h,m}', 'More_Classes/**/*.{h,m}'

• 文件匹配
  • *匹配所有文件
  • c*匹配以名字C開(kāi)頭的文件
  • *c匹配以名字c結(jié)尾的文件
  • *c*匹配所有名字包含c的文件
  • **文件夾以及遞歸子文件夾
  • ?任意一個(gè)字符(注意是一個(gè)字符)
  • [set] 匹配多個(gè)字符,支持取反
  • {p,q} 匹配名字包括p 或者 q的文件

例子:

"JSONKit.?"    #=> ["JSONKit.h", "JSONKit.m"]   //JSONKit.字符
"*.[a-z][a-z]" #=> ["CHANGELOG.md", "README.md"]//.兩個(gè)a-z的字母
"*.[^m]*"      #=> ["JSONKit.h"]                //.不是m的字符
"*.{h,m}"      #=> ["JSONKit.h", "JSONKit.m"]   //包含.h或者.m
"*"            #=> ["CHANGELOG.md", "JSONKit.h", "JSONKit.m", "README.md"]//所有文件

• 公有頭文件

spec.public_header_files = 'Headers/Public/*.h'

• 私有頭文件

spec.private_header_files = 'Headers/Private/*.h'

• 自己的或者第三方framework,比qqSDK的TencentOpenAPI.framework

spec.vendored_frameworks = 'MyFramework.framework','TheirFramework.framework'

• 自己的或者第三方.a文件,比如微信SDK的.a文件

spec.vendored_libraries = 'libProj4.a', 'libJavaScriptCore.a'
       

• 資源文件,比如圖片

spec.ios.resource_bundle = { 'MapBox' => 'MapView/Map/Resources/*.png' }

多個(gè)路徑        
spec.resource_bundles = {
    'MapBox' => ['MapView/Map/Resources/*.png'],
    'OtherResources' => ['MapView/Map/OtherResources/*.png']
  }
 

這種方式資源文件會(huì)被以bundle的形式加入到項(xiàng)目中去,官方建議使用的方式,主要是防止與用戶的命名方式?jīng)_突

• 資源文件另一種方式,這種比較常見(jiàn)

spec.resource = 'Resources/HockeySDK.bundle'
spec.resources = ['Images/*.png', 'Sounds/*']