这个路径说明第三方来自不是CocoaPods
source 'git@github.com:aliyun/aliyun-specs.git'
如果出现上面的那一句必须加上该句,因为其它的第三方是来自CocoaPods
source 'https://github.com/CocoaPods/Specs.git'
- use_frameworks!
注意:在Swift 中 导入 第三方 要加上该句!!!
此句的位置很重要 如果放在 platform end 之间 那么生成的是 图一 类型,
如果是不在 platform end之间 在语句platform :ios, '8.0' 上面 或者 end 下面 则生成的是 图二 类型
参考:
source 'git@github.com:aliyun/aliyun-specs.git'
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!
inhibit_all_warnings!
target 'mpush_ios_swift_demo' do
pod 'AlicloudPush', '~> 1.9.1'
pod 'KoaPullToRefresh', '~> 1.0.6'
end
- pod search source 'git@github.com:aliyun/aliyun-specs.git'
直接 search是搜索 master仓库。 - 不一定能搜索到
git@github.com:aliyun/aliyun-specs.git
如何解决?
- pod repo add 把仓库拉到本地才能搜索。
- 或者pod search 通过source指定私有仓库地址。
手动把阿里云pod仓库拉去到本地:
- pod repo add AliyunRepo git@github.com:aliyun/aliyun-specs.git
搜索某一个第三方
- Pod search AlicloudHTTPDNS
- Pod search AlicloudPush
输入指令
$ touch Podfile //(创建Podfile文件)
$ vim Podfile // (编译指令)
$pod install
现在的 Podfile 的写法:
=begin
这里写注释
=end
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
inhibit_all_warnings!
xcodeproj 'Demo.xcodeproj'
target :Demo1 do
pod 'AFNetworking', '~> 2.5.4'
end
target :Demo2 do
pod 'MBProgressHUD', '~> 0.9.1'
pod 'MJRefresh', '~> 2.3.2'
end
说说重点:xcodeproj 'demo.xcodeporj' 这个指明用于那个项目.
target :Demo1 指明对应那个Target
这里说一说 为什么最好先建一个空项目。 大家都知道一个项目可以有多个Target 如果我们的项目名称和Target 的名称一致就会产生一个 Pod.debug 的配置文件,也就不会产生一个和Target 一致的Pod-target.debug 的配置文件。pod.debug 也是一个默认的配置文件。
如果我们在 xcodeporj 和 Target 之间 添加 pod 'AFNetworking' 同样会产生这个默认的配置文件。
Podfile简介
Podfile的官方说明为:The Podfile is a specification that describes the dependencies of the targets of one or more Xcode projects.即Podfile文件用来配置第三方库与一或多个Xcode项目之间的依赖信息。
platform :ios, '9.0'
inhibit_all_warnings! //在全局指定不显示所有所引用的库中的警告信息
target 'MyApp' do
pod 'ObjectiveSugar', '~> 0.5'
end
target "MyAppTests" do
inherit!: search_paths
pod 'OCMock', '~> 2.0.1'
end
use_frameworks! // 通过指定use_frameworks!要求生成的是framework而不是静态库
inhibit_all_warnings! // 在全局指定不显示所有所引用的库中的警告信息。nhibit_all_warnings! 命令是不显示所引用的库中的警告信息。我们可以指定全局不显示警告信息,也可以指定某一个库不显示警告信息:
pod 'SSZipArchive', :inhibit_warnings => true // 指定不显示某个库的警告信息
def shared_pods //定义依赖宏
shared_pods //使用宏
workspace 默认情况下,我们不需要指定workspace,而是直接使用与Podfile所在目录的工程名一样的workspace就可以了。如果要指定另外的名称,而不是使用工程的名称,可以这样指定:
- workspace 'MyWorkspace'
source 是指定pod的来源。
如果不指定source,默认是使用CocoaPods官方的source。
通常我们没有必要添加。
// 如果不想使用官方的,而是在别的地方也有,可以这样指定
source 'https://github.com/artsy/Specs.git'
// 默认是官方的source
source 'https://github.com/CocoaPods/Specs.git'
def
我们还可以通过def命令来声明一个pod集:
def 'CustomPods'
pod 'IQKeyboardManagerSwift'
end
然后,我们就可以在需要引入的target处引入之:
target 'MyTarget' do
CustomPods
end
这么写的好处是:如果有多个target,
而不同target之间并不全包含,那么可以通过这种方式来分开引入。
Dependencies(依赖)
CocoaPods 就是用于管理第三方依赖的。我们通过Podfile文件来指定工程中的每个target之间与第三方之间的依赖。
有以下三个命令来管理依赖:
pod 指定特定依赖。比如指定依赖AFNetwroking
podspec 提供简单的API来创建podspec
target 通过target指定工程所依赖的范围。
Pod命令
pod 命令用于指定工程所依赖的第三方及第三方库的版本范围。
永远使用最新版本
- pod 'HYBMasonryAutoCellHeight'
当我们永远使用远程仓库中的最新版本时,我们只需要指定仓库名即可。当有新的版本发布时,执行 pod update 命令,会更新至最新的版本。因为版本之间可能会存在很大的差异,因此我们不应该采用这种方式,而是指定版本范围或者指定特定版本。
使用固定版本
- pod 'HYBLoopScrollView', '2.0'
当我们不希望版本更新,而是固定使用指定的版本时,我们应该这么写法。当远程有新的版本发布时,pod是不会去更新新版本的。由于版本变化可能较大,因此有时候我们希望这么做的。
指定版本范围
- pod 'KoaPullToRefresh', '~> 1.0.6'
- pod 'HYBUnicodeReadable', '~>1.1.0'
当我们不要求固定版本号,而是指定某个范围时,我们会像上面这么写法,在工程中见到最多的就是这种写法。上面这句代码的意思是:HYBUnicodeReadable的版本可以是1.1.0到2.0.0,但是不包括2.0.0。使用这种写法是很有用的,因此小版本的升级一般是fix bug,当有bug被fix时,确实应该更新。从1.9.9升级到2.0.0时,不会去更新到2.0.0版本。我们认为从2.0.0是一个大版本,大版本的发布,通常不是fix bug,而是增加功能或者改动较大。
pod中用于指定范围的符号如下:
= version 要求版本大于或者等于version,当有新版本时,都会更新至最新版本
< version 要求版本小于version,当超过version版本后,都不会再更新
<= version 要求版本小于或者等于version,当超过version版本后,都不会再更新
~> version 比如上面说明的version=1.1.0时,范围在[1.1.0, 2.0.0)。注意2.0.0是开区间,也就是不包括2.0.0。
使用本地库
pod 'AFNetworking', :path => '~/Documents/AFNetworking'
如果我们的库是在本地的,那么我们可以通过这样的命令来指定。由于是引用目录,因此外部直接修改目录中的内容,CocoaPods也会更新到最新的,所以也挺不错的!
cocoapods官网
下载cocoapods 的链接
https://github.com/kattrali/cocoapods-xcode-plugin
使用CocoaPods
新建一个项目,名字 CocoaPodsDemo
终端中,“cd+空格” 到项目总目录(注意:包含PodTest文件夹、PodTest.xcodeproj、PodTestTest的那个总目录) eg: cd /Users/mac/Desktop/
建立Podfile(配置文件)
$ touch Podfile
终端输入 $ vim Podfile 回车键盘 输入 i,进入编辑模式
输入内容:.......
然后按Esc,并且输入“ :” 进入vim命令模式,然后在冒号后边输入wq
注意:键盘输入 :后,才能输入wq。回车 后发现CocoaPodsDemo项目总目录中多一个Podfile文件
最后终端输入 pod install,等待一会,就OK了。
注意:现在打开项目不是点击 CocoaPodsDemo.xodeproj了,而是点击 CocoaPodsDemo.xcworkspace
对于我们使用cocoapod引入的第三方,我们可以在podfile文件中 增加一句 inhibit_all_warnings! 来要pod的工程不显示任何警告
在终端输入:
$ ls //查看当前
$ ls -al //把当前目录下所有文件显示
$ pwd //查看当前文件夹的路径
$ man 命令名 //比如要看看 ls 命令的详细用法,执行 man ls
$ history //列出最近执行过的 几条命令及编号
$ clear //清除屏幕或窗口内容 滚动到顶部
$ cd +工程 //进入工程
$ touch Podfile //创建podfile文件
$ pod install --verbose --no-repo-update
$ pod update //更新
$ pod update --no-repo-update //本地更新
补充一个vi的命令(在终端操作):
- 在默认的"指令模式"下按 i 进入编辑模式
- 在非指令模式下按 ESC 返回指令模式
- 在"指令模式"下输入:
:w 保存当前文件
:q 退出编辑,如果文件为保存需要用强制模式
:q! 强制退出不保存修改
:wq 组合指令, 保存并退出 - 在"指令模式"下移动:
h 左
j 下
k 上
l 右
MacdeiMac-67:~ mac$ pod update //更新所有的第三方
MacdeiMac-67:~ mac$ ls -al //检测是否有cocoapods
MacdeiMac-67:~ mac$ cd ~ //进入根目录
MacdeiMac-67:~ mac$ pwd //进入当前目录
MacdeiMac-67:~ mac$ pod search jsonkit //搜索
MacdeiMac-67:~ mac$ clear //清除
MacdeiMac-67:~ mac$ ls
Desktop Downloads Movies Pictures Public
Documents Library Music Pods podfile