> For the complete documentation index, see [llms.txt](https://gitbook.existorlive.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.existorlive.cn/xue-xi-kai-fa-gong-ju/cocoapods/an-zhuang-pod-ku-podfile.md).

# 安装pod库-podfile

\#cocoapods\
\#依赖管理\
\#podfile

## 1. source

`source`指令指定索引库(specs)的地址

```ruby
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库的名字以及可选的版本要求。\
​

```ruby
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文件中读取库地址

```ruby
pod 'QueryKit/Attribute'
```

* 指定source

```ruby
pod 'PonyDebugger', :source => 'https://github.com/CocoaPods/Specs.git'
```

* 指定git地址, 不指定 branch，tag，commit时，默认为master分支最新的commit

```ruby
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

```ruby
pod 'AFNetworking', :path => '~/Documents/AFNetworking'
```

* 通过 subspecs 安装指定的子库

```ruby
# 安装 QueryKit 的 Attribute 和 QuerySet 子库
pod 'QueryKit', :subspecs => ['Attribute', 'QuerySet']
```

* 如果某个库中没有.podspec文件，可以使用podspec指定库外的.podsepc文件

```ruby
pod 'JSONKit', :podspec => 'https://example.com/JSONKit.podspec'
```

* 通过 testspecs 可以指定测试库

```ruby
pod 'AFNetworking', :testspecs => ['UnitTests', 'SomeOtherTests']
```

* build configuration 默认情况下，pod 库将会安装在所有的build configuration下，也可以显示指定在某几个build configuration下

```ruby
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库和其他配置

```ruby
target 'ZipApp' do
  pod 'SSZipArchive'
end
```

abstract\_target 是一个虚拟的target，不与 xcode 工程中的实际 target 对应。abstract\_target主要是 pod 库和其他一些配置的继承

```ruby
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

```ruby
# 最外层的隐式 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

```ruby
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

```ruby
platform :ios, '4.0'
platform :ios
```

### 3.2 project

当 Podfile 文件用于多个 project 时，指定 target 所属的 project\
​

当 Podfile 文件只用于一个 project时，不需要显示指定

```ruby
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库的告警\
也可以单独关闭或者打开告警屏蔽

```ruby
# 屏蔽 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

```ruby
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库就可以作为模块被引入。\
​

```ruby
# 可以单独打开或者关闭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 的名字

```ruby
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 指定在安装过程中使用的插件和插件的参数\
​

```ruby
plugin 'cocoapods-keys', :keyring => 'Eidolon'
plugin 'slather'
```

​

### 5.2 pre\_install

pre\_install 允许你在pod库下载完成之后，安装之前，执行修改

```ruby
pre_install do |installer|
  # Do something fancy!
end
```

### 5.3 pre\_integrate

pre\_integrate 允许你在工程写入磁盘之前做修改\
​

```ruby
pre_integrate do |installer|
  # perform some changes on dependencies
end
```

### 5.4 post\_install

post\_install允许你在生成Xcode project写入磁盘之前做最后的修改\
​

```ruby
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 允许你在工程写入磁盘之后，做修改

```ruby
post_integrate do |installer|
  # some change after project write to disk
end
```

[Podfile Syntax Reference ](https://guides.cocoapods.org/syntax/podfile.html#source)​


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://gitbook.existorlive.cn/xue-xi-kai-fa-gong-ju/cocoapods/an-zhuang-pod-ku-podfile.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.