Comment on page

安装pod库-podfile

#cocoapods #依赖管理 #podfile
1. source
source指令指定索引库(specs)的地址
source "https://github.com/aliyun/aliyun-specs.git"
source "https://github.com/CocoaPods/Specs.git"
使用source指定索引库，顺序很重要。Cocoapods 会使用第一个source中最高版本的pod，不论后面的source是否包含更高的版本。 ​
官方的source是隐式指定的。当你指定其他source时，需要显式制定官方source。 ​
2. Dependencies
2.1 pod
​
pod 用于指定project或者target依赖的pod库。 ​
pod 后面跟随pod库的名字以及可选的版本要求。 ​
pod 'Objection', '0.9'
2.1.1 版本控制
'= 0.1', 指定版本为 0.1.
'> 0.1', 指定版本高于 0.1
'>= 0.1', 指定版本高于或等于 0.1
'~> 0.1.2' 指定版本高于或等于 0.1.2 ，且小于 0.2.0
'~> 0' 指定版本高于等于0，小于 1
'~> 0.1.3-beat.0' 指定版本高于等于0.1.3 小于0.2
​
~> 表示高于等于指定版本，但小于下一个版本。 下一个版本基于最后一个子版本号。如 '0.1.2'下一个版本为'0.2.0'，'1.3.4.5'下一个版本为'1.3.5.0' , '0' 下一个版本为 '1' ; 带 '-' 的版本号之后的部分会被忽略，'0.1.3-beat.0' 下一个版本为 '0.2.0' ​
2.1.2 pod库source配置
不指定pod库的地址，将从索引库中查找对应的.podspec文件，从.podspec文件中读取库地址
pod 'QueryKit/Attribute'
指定source
pod 'PonyDebugger', :source => 'https://github.com/CocoaPods/Specs.git'
指定git地址, 不指定 branch，tag，commit时，默认为master分支最新的commit
pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git'
pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git', :branch => 'dev'
pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git', :tag => '0.7.0'
pod 'AFNetworking', :git => 'https://github.com/gowalla/AFNetworking.git', :commit => '082f8319af'
直接指定路径，developerment pod
pod 'AFNetworking', :path => '~/Documents/AFNetworking'
通过 subspecs 安装指定的子库
# 安装 QueryKit 的 Attribute 和 QuerySet 子库
pod 'QueryKit', :subspecs => ['Attribute', 'QuerySet']
如果某个库中没有.podspec文件，可以使用podspec指定库外的.podsepc文件
pod 'JSONKit', :podspec => 'https://example.com/JSONKit.podspec'
通过 testspecs 可以指定测试库
pod 'AFNetworking', :testspecs => ['UnitTests', 'SomeOtherTests']
build configuration 默认情况下，pod 库将会安装在所有的build configuration下，也可以显示指定在某几个build configuration下
pod 'PonyDebugger', :configurations => ['Debug', 'Beta']
​
2.2 target 和 abstract target
target 与 xcode 工程中的 target 对应，在 target 闭包中声明的 pod 库即对应 xcode 工程中的实际 target 所依赖的 pod库。 target 定义了 pod 库的作用范围。 target 之中可以包含 target，target 可以继承父 target 的pod库和其他配置
target 'ZipApp' do
  pod 'SSZipArchive'
end
abstract_target 是一个虚拟的target，不与 xcode 工程中的实际 target 对应。abstract_target主要是 pod 库和其他一些配置的继承
abstract_target 'Networking' do
  pod 'AlamoFire'
​
  # Networking App 1 , Networking App 2 继承 Networking 的 AlamoFire 库声明
  target 'Networking App 1'
  target 'Networking App 2'
end
在 Podfile 文件中，隐式声明了一个最外层的 abstract target
# 最外层的隐式 abstract target 
​
platform :ios, '9.0'
use_modular_headers!
​
pod "ZMToolBase"
​
target 'ZMTool' do
  # 继承隐式abstract target 的 ZMToolBase
  pod "Alamofire"
end
​
target 'ZMTool_extension' do
  pod "CTMediator"
end
inherit! 可以指定继承的模式
:complete 完全继承父target的所有行为
:none 不继承
:search_paths 只继承search_paths
target 'App' do
  target 'AppTests' do
    # 只继承search_paths
    inherit! :search_paths
  end
end
​
3. target configuration
以下配置都是 target 闭包( 包括最外层的隐式abstract target )内的配置
3.1 platform
platform 指定支持的系统和版本号；如果未指定，则为默认值：iOS 4.3，OS X 10.6，tvOS 9.0，watchOS 2.0
platform :ios, '4.0'
platform :ios
3.2 project
当 Podfile 文件用于多个 project 时，指定 target 所属的 project ​
当 Podfile 文件只用于一个 project时，不需要显示指定
target 'MyGPSApp' do
  project 'FastGPS'
  ...
end
​
# Same Podfile, multiple Xcodeprojects
target 'MyNotesApp' do
  project 'FastNotes'
  ...
end
​
project 'TestProject', 'Mac App Store' => :release, 'Test' => :debu
3.3 inhibit_all_warnings!
屏蔽所有来自pod库的告警 也可以单独关闭或者打开告警屏蔽
# 屏蔽 SSZipArchive 的告警
pod 'SSZipArchive', :inhibit_warnings => true
​
---- 
# 屏蔽所有告警
inhibit_all_warnings!
​
# 单独放开SSZipArchive 的告警
pod 'SSZipArchive', :inhibit_warnings => false
3.4 use_frameworks!
pod 将被打包为 framework 而不是 static library。 :linkage 指定打包为静态framewok还是动态framework
target 'MyApp' do
  # 动态framewok
  use_frameworks! :linkage => :dynamic
  pod 'AFNetworking', '~> 1.0'
end
​
target 'ZipApp' do
  # 静态framewok
  use_frameworks! :linkage => :static
  pod 'SSZipArchive'
end
3.5 use_modular_headers!
默认情况下，pod库会被打包为static library。use_modular_headers!可以为pod库创建modular header，这样pod库就可以作为模块被引入。 ​
# 可以单独打开或者关闭modular header
pod 'SSZipArchive', :modular_headers => false
pod 'SSZipArchive', :modular_headers => true
​
4 Workspace
4.1 workspace
workspace命令 指定包含所有的project的workspace的名字
如果没有显式指定 workspace，且只有一个 project 在 Podfile 的目录下；project 的名字将作为 workspace 的名字
workspace 'MyWorkspace'
4.2 generate_bridge_support!
?? ​
4.3 set_arc_compatibility_flag!
set_arc_compatibility_flag! 命令将 -fobjc-arc 添加到 OTHER_LD_FLAGS ​
5 Hooks
Podfile 可以为 pod install 过程添加 hook；hook 是全局的，不是针对某个 target 的
5.1 plugin
plugin 指定在安装过程中使用的插件和插件的参数 ​
plugin 'cocoapods-keys', :keyring => 'Eidolon'
plugin 'slather'
​
5.2 pre_install
pre_install 允许你在pod库下载完成之后，安装之前，执行修改
pre_install do |installer|
  # Do something fancy!
end
5.3 pre_integrate
pre_integrate 允许你在工程写入磁盘之前做修改 ​
pre_integrate do |installer|
  # perform some changes on dependencies
end
5.4 post_install
post_install允许你在生成Xcode project写入磁盘之前做最后的修改 ​
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.5 post_integrate
post_integrate 允许你在工程写入磁盘之后，做修改
post_integrate do |installer|
  # some change after project write to disk
end
​Podfile Syntax Reference ​

以前

Cocoapods

下一个

创建pod库-podspec

最近更新 1yr ago

安装pod库-podfile

1. source

2. Dependencies

2.1 pod

2.1.1 版本控制

2.1.2 pod库source配置

​

2.2 target 和 abstract target

​

3. target configuration

3.1 platform

3.2 project

3.3 inhibit_all_warnings!

3.4 use_frameworks!

3.5 use_modular_headers!

4 Workspace

4.1 workspace

4.2 generate_bridge_support!

4.3 set_arc_compatibility_flag!

5 Hooks

5.1 plugin

5.2 pre_install

5.3 pre_integrate

5.4 post_install

5.5 post_integrate