CocoaPods使用中级篇
2017-11-23 本文已影响50人
summer201704
目录
profile相关参数
1. 依赖相关的指令
-
pod : 声明一个依赖库
-
版本
//使用最新的版本 pod 'SSZipArchive' //指定使用某个版本 pod 'Objection', '0.9' //0.1.2与0.2版本之间的最新版本 pod 'Objection', '~> 0.1.2'
-
Build配置
//只有在debug模式下才使用PonyDebugger库 pod 'PonyDebugger', :configuration => 'Debug'
-
Subspecs 配置
Subspecs 配置, 只使用pod中某一个或者某一些子pod 库(需要pod库支持) //使用QueryKit下的Attribute库: pod 'QueryKit/Attribute' //使用QueryKit下的Attribute库和QuerySet库: pod 'QueryKit', :subspecs => ['Attribute', 'QuerySet']
-
本地pod库(cocoapod会在指定的文件夹下找podspec,所以当前文件夹下一定要有podspec文件)
pod 'AFNetworking', :path => '~/Documents/AFNetworking'
-
设置pod库
//使用master分支 pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git' //使用指定分支 pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git', :branch => 'dev' //使用指定tag pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git', :tag => '0.7.0' //使用某一次commit pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git', :commit => '082f8319af
-
设置podSpec的来源
-
pod 'JSONKit', :podspec => 'https://example.com/JSONKit.podspec'
-
Target : 与project中的target保持一致,默认target会继承外面的依赖库
简单应用:
target 'ZipApp' do
pod 'SSZipArchive'
end
继承别的target的依赖库
target 'ZipApp' do
pod 'SSZipArchive'
target 'ZipAppTests' do
inherit! :search_paths
pod 'Nimble'
end
end
继承多个target的依赖库(ShowsTests 同时有ShowsApp和)
target 'ShowsApp' do
pod 'ShowsKit'
# Has its own copy of ShowsKit + ShowTVAuth
target 'ShowsTV' do
pod 'ShowTVAuth'
end
target 'ShowsTests' do
inherit! :search_paths
pod 'Specta'
pod 'Expecta'
end
end
-
抽象Target : 方便其他target继承(这个抽象的target是不存在的)
abstract_target 'Networking' do
pod 'AlamoFire'
target 'Networking App 1'
target 'Networking App 2'
end
# Note: There are no targets called "Shows" in any of this workspace's Xcode projects
abstract_target 'Shows' do
pod 'ShowsKit'
# The target ShowsiOS has its own copy of ShowsKit (inherited) + ShowWebAuth (added here)
target 'ShowsiOS' do
pod 'ShowWebAuth'
end
# The target ShowsTV has its own copy of ShowsKit (inherited) + ShowTVAuth (added here)
target 'ShowsTV' do
pod 'ShowTVAuth'
end
# Our tests target has its own copy of
# our testing frameworks, and has access
# to ShowsKit as well because it is
# a child of the abstract target 'Shows'
target 'ShowsTests' do
inherit! :search_paths
pod 'Specta'
pod 'Expecta'
end
end
-
inherit!:给当前target设置集成模式
参数有
:complete : 全部继承父target
:none :全部不继承
:search_paths :只继承父target的searchPaths
例如:
target 'App' do
target 'AppTests' do
inherit! :search_paths
end
end
2. Target配置
platform: 两个参数。一个是name, 一个是target
name属性
osx for OS X, :ios for iOS, :tvos for tvOS, or :watchos for watchOS.
target:版本
例如:
platform :ios, '4.0'
platform :ios
inhibit_all_warnings : 忽略所有库中的警告,也可以指定某一个具体库的警告。例如:
//全部忽略
platform :ios, '8.0'
inhibit_all_warnings!
source 'https://github.com/CocoaPods/Specs.git'
target 'TestPod' do
pod 'SummerOCProjectFrame', '~> 0.0'
end
//某一个忽略
pod 'SummerOCProjectFrame', '~> 0.0', :inhibit_warnings => true
3. Source : 可以指定CocoaPods Master Repository,也可以自定义的Repository。例如:
source 'https://github.com/artsy/Specs.git'
source 'https://github.com/CocoaPods/Specs.git'
4. Hooks: 提供在初始化过程中接口
plugin:插件。描述在初始化时候使用的插件。例如:
plugin 'cocoapods-keys', :keyring => 'Eidolon'
plugin 'slather'
pre_install:在pod下载完初始化前可以通过它做逻辑处理。例如:
pre_install do |installer|
# Do something fancy!
end
post_install:在形成project后写入本地前可以通过它做逻辑处理。比如设置target的build setting, 代码如下:
post_install do |installer|
installer.pods_project.targets.each do |target|
target.build_configurations.each do |config|
config.build_settings['GCC_ENABLE_OBJC_GC'] = 'supported'
end
end
end
5. def name end。 如果project依赖的库很多,比如有自己开发的库,有第三方的库,可以对这些库进行分类。例如:
def myPods
pod xxx
pod xxx1
pod xxx2
end
def thirdPods
pod yyy
pod yyy1
pod yyy2
end
target 'xxx' do
myPods
thirdPods
end
参考:https://guides.cocoapods.org/syntax/podfile.html#podfile
podspec相关参数
-
一些参数:
- prefix_header_file : 给pod库设置pch文件
- dependency : 设置依赖库
- weak_framework :兼容高低版本api的问题,类似于主工程中frame里面的option属性
- libraries, framework
- compiler_flags,例如
spec.compiler_flags = '-DOS_OBJECT_USE_OBJC=0', '-Wno-format'
- prefix_header_contents :给pod库的pch文件增加文件,例如:
spec.prefix_header_contents = '#import <UIKit/UIKit.h>' spec.prefix_header_contents = '#import <UIKit/UIKit.h>', '#import <Foundation/Foundation.h>'
- source_files, public_header_files(不写默认是所有.h文件),private_header_files。source支持如下几种源:
//git源 :git => :tag, :branch, :commit, :submodules spec.source = { :git => 'https://github.com/AFNetworking/AFNetworking.git', :tag => spec.version.to_s } //:svn => :folder, :tag, :revision spec.source = { :svn => 'http://svn.code.sf.net/p/polyclipping/code', :tag => '4.8.8' } //:hg => :revision spec.source = { :hg => 'https://bitbucket.org/dcutting/hyperbek', :revision => "#{s.version}" } //:http => :flatten, :type, :sha256, :sha1 spec.source = { :http => 'http://dev.wechatapp.com/download/sdk/WeChat_SDK_iOS_en.zip' } //:path
- vendored_frameworks: pod库的frame
- vendored_libraries: 第三方.a文件
spec.vendored_libraries = 'xxx/Classes/ThirdParty/*.{a}'
- resource_bundles,resources
spec.resource_bundles = {
'MapBox' => ['MapView/Map/Resources/*.png'],
'OtherResources' => ['MapView/Map/OtherResources/*.png']
}
spec.resources = ['Images/*.png', 'Sounds/*']
- preserve_path: install 或者 update之后不会更新的文件路径
spec.preserve_path = 'IMPORTANT.txt'
spec.preserve_paths = 'Frameworks/*.framework'
- exclude_files : 不包含的文件。例如:
spec.exclude_files = 'Classes/**/unused.{h,m}'
- subspec : 子spec。可以使用spec中所有属性。比如不同的source_file, 不同的dependencies。例如:
//不同的source_file
subspec 'Twitter' do |sp|
sp.source_files = 'Classes/Twitter'
end
subspec 'Pinboard' do |sp|
sp.source_files = 'Classes/Pinboard'
end
Pod::Spec.new do |s|
s.name = 'RestKit'
//不同的dependencies
s.subspec 'Core' do |cs|
cs.dependency 'RestKit/ObjectMapping'
cs.dependency 'RestKit/Network'
cs.dependency 'RestKit/CoreData'
end
s.subspec 'ObjectMapping' do |os|
end
end
参考:https://guides.cocoapods.org/syntax/podspec.html
清除pod缓存
第一步:
pod cache list //查看看缓存
pod cache clean --all //清除缓存
如果还不行,就执行下面的代码:
rm ~/Library/Caches/CocoaPods/search_index.json;
pod sutup