CocoaPods 1.0 + 适配

CocoaPods 1.0 发布4个多月了。之前的写的笔记过时了，抽空更新一波。同时解决一下图片不能看的问题。鉴于写完之前的总结之后很多人问我怎么弄私有 Pod ，今天会写一下。

目录

• CocoaPods 1.0 安装及适配
• 利用 CocoaPods 发布自己的三方库
• CocoaPods 1.0 私有 Pods

---

CocoaPods 1.0 安装及适配

• 如何安装？命令行中输入 sudo gem install cocoapods

遇到 Operation not permitted - /usr/bin/pod 可以参照这里

• 有何变化？[没用过旧版的可以忽略]
  • 必须指明 target
  • :exclusive => true 和 link_with 被去掉了
  • 使用本地的 pod 只能使用 :path
  • pod install 不再更新本地 repo
  • pod install --repo-update 更新本地 repo 在安装 pods
  • ...

---

利用 CocoaPods 发布自己的三方库

• 将自己的三方库集成 CocoaPods 只需要三步
  • 1. 初始化项目
  • 2. 创建和编写 podspec
  • 3. 将 podspec 上传到 CocoaPods 的 repo 上

1.初始化项目

• 如何初始化可以看这里
• 原理上 Cocoapods 支持任意源代码管理(例如 git svn)的开源仓库。只要用户可以根据 url 下载到项目的网址都可以。所以不局限于GitHub。但是今天我们以 GitHub 为例。
• 项目初始化结束之后,需要给项目打 tag 以便告诉 Cocoapods 自己项目的最新版。每发一版需要一个 tag

// push to remote
git add .
git commit -m "初始化项目"
git push

//add tag 
git tag -m "2rd release" 0.2.0
git push --tags

2.创建和编写 podspec [ 最重要的一步 ]

• 你可以创建一个名字叫做 XXX.podspec 空文件。
• 也可以通过 pod spec create DWCategory [email protected]:Damonvvong/DWCategory.git 创建一个有备注的 podspec
• 编写 podspec 文件：

Pod::Spec.new do |s|

  s.name         = "DWCategory"                           # 名称
  s.version      = "0.2.0"                                # 版本号，git 的 tag
  s.summary      = "一个简单的分类用于测试 Cocoapods 1.0 +"

  s.description  = <<-DESC
                    - 测试 pod
                    - Cocoapods 1.0
                    - description 需要比 summary 长
                   DESC

  s.homepage     = "https://github.com/Damonvvong"
  s.license      = { :type => "MIT", :file => "LICENSE" }                    # 开源协议

  s.author       = { "Damonwong" => "[email protected]" }
  s.platform     = :ios, "8.0"                                               # 支持的平台及版本
  s.source       = { :git => "https://github.com/Damonvvong/DWCategory.git", :tag => "#{s.version}" }
  # 项目地址作为开源项目，这里不能使用 ssh 
  s.source_files  = "DWCategory", "DWCategory/**/*.{h,m}"                    # 模块文件路径配置
  s.exclude_files = "Classes/Exclude"
  s.module_name   = 'DWCategory'                                             # 模块名称
end

• 编写完运行 pod lib lint ，出现如下图 运行无误

3. 将 podspec 上传到 CocoaPods 的 repo 上

利用Trunk把自己的 DWCategory.podspec 文件上传给 Cocoapods

####1.注册

pod trunk register [email protected] 'Damonwong' --verbose

• [email protected]：自己的邮箱
• Damonwong：用户名（最好和.podspec 文件 中一样）

####2.检查是否注册成功

• 登录邮箱，确认注册

• 检查注册情况：pod trunk me（看到类似下面，就是成功了）

pod trunk me
  - Name:     Damonwong
  - Email:    [email protected]

####3.上传DWCategory.podspec 到 Cocoapods/repo

• 进入 文件所在文件夹

	cd /Users/damon/Desktop/DWCategory 

• 上传文件

pod trunk push /Users/damon/Desktop/DWCategory 

####4.上传完成，查找一下

pod search DWCategory

Done! 现在可以用 pod 'DWCategory' 来导入了

---

CocoaPods 1.0 私有 Pods

• 创建一个私有 pods 需要三个东西
  • 1. 私有的代码管理仓库
  • 2. 私有的 repo
  • 3. 私有 pod

1. 私有的代码管理仓库

• 搭建在自己服务器的源代码管理仓库，例如 GitLab

2. 私有的 repo 【非必要】

• repo 是什么？

  • repo 其实就是一个索引表。一个管理 .podspec 文件夹的索引。下图是从这里 下载的 master 的目录结构(在下系统的~/.cocoapods/repos/master)。Specs 下存放了Cocoapods 几乎所有开源的项目索引。例如 AFNetworking 下有每一个版本(tag)对应的 podspec。

• 所以，我们也要自己先搞一个私有的 repo

  • 1.在私有源代码管理上创建一个空仓库。
  • 2.到本地 在命令行中输入 pod repo add REPO_NAME SOURCE_URL 期中REPO_NAME 是你的 repo 名字 例如 DWRepo , SOURCE_URL 是你的 空仓库的 地址。【这一步在本地的~/.cocoapods/repo 下初始化了一个 DWRepo,同时 git push 到了 SOURCE_URL】

  

3. 私有 pod

• 这一步这里步骤类似。只需要把代码仓库改为私有的就行。

• 创建和编写 podspec。

  • 这一步大致与 **CocoaPods 1.0 安装及适配 ** 的一致。只需要把 s.source = { :git => "改成私有地址" }即可。记得用 pod lib lint 是否有问题

• 创建完 podspec 不再是用 trunk 上传自己的 podspec 了。你需要用 pod repo push DWRepo DWCategory.podspec 将.podspec 上传到自己的 repo 中。【这一步，先将 DWCategory.podspec 拷贝到了 自己的 repo 中，再将 repo 同步到服务器上】

ok！Done。

---

关于私有 pod

• 你可以按照上面步骤搭建一个 类似 Cocoapods 的 方案
• 其实你可以省略 repo 直接在 pod 的时候添加 code 源 例如 ：

    platform :ios, "8.0"

source 'https://github.com/CocoaPods/Specs.git'

target 'CocoaPods2' do
	pod 'DWCategory', :git => '这里写上私有库的源'
end

• 当然上面的 :git 可以改为 :path 来导入本地的 库

---

###1.在 GitHub 初始化一个分类仓库（DWCategory）

###2.clone 到本地，配置文件，再上传

• 把 GitHub 上的项目克隆到本地。(打开终端，cd 到桌面)

git clone [email protected]:Damonvvong/DWCategory.git

这里是利用 SSH 方式 clone,配置 SSH教程传送门

• 把自己的分类放入桌面的DWCategory文件夹中,如下。

本文编辑于 2016年9月20日