CocoaPods 1.0 发布4个多月了。之前的写的笔记过时了,抽空更新一波。同时解决一下图片不能看的问题。鉴于写完之前的总结之后很多人问我怎么弄私有 Pod ,今天会写一下。
- 如何安装?命令行中输入
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 只需要三步
-
- 初始化项目
-
- 创建和编写 podspec
-
- 将 podspec 上传到 CocoaPods 的 repo 上
-
- 如何初始化可以看这里
- 原理上 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
- 你可以创建一个名字叫做 XXX.podspec 空文件。
- 也可以通过
pod spec create DWCategory git@github.com: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" => "coderonevv@gmail.com" }
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
,出现如下图 运行无误
利用Trunk把自己的 DWCategory.podspec 文件上传给 Cocoapods
####1.注册
pod trunk register coderonevv@gmail.com 'Damonwong' --verbose
- coderonevv@gmail.com:自己的邮箱
- Damonwong:用户名(最好和.podspec 文件 中一样)
####2.检查是否注册成功
-
登录邮箱,确认注册
-
检查注册情况:pod trunk me(看到类似下面,就是成功了)
pod trunk me
- Name: Damonwong
- Email: coderonevv@gmail.com
####3.上传DWCategory.podspec 到 Cocoapods/repo
- 进入 文件所在文件夹
cd /Users/damon/Desktop/DWCategory
- 上传文件
pod trunk push /Users/damon/Desktop/DWCategory
####4.上传完成,查找一下
pod search DWCategory
- 创建一个私有 pods 需要三个东西
-
- 私有的代码管理仓库
-
- 私有的 repo
-
- 私有 pod
-
- 搭建在自己服务器的源代码管理仓库,例如 GitLab
-
repo 是什么?
- repo 其实就是一个索引表。一个管理 .podspec 文件夹的索引。下图是从这里 下载的 master 的目录结构(在下系统的
~/.cocoapods/repos/master
)。Specs 下存放了Cocoapods 几乎所有开源的项目索引。例如 AFNetworking 下有每一个版本(tag)对应的 podspec。
- repo 其实就是一个索引表。一个管理 .podspec 文件夹的索引。下图是从这里 下载的 master 的目录结构(在下系统的
-
所以,我们也要自己先搞一个私有的 repo
- 1.在私有源代码管理上创建一个空仓库。
- 2.到本地 在命令行中输入
pod repo add REPO_NAME SOURCE_URL
期中REPO_NAME 是你的 repo 名字 例如 DWRepo , SOURCE_URL 是你的 空仓库的 地址。【这一步在本地的~/.cocoapods/repo
下初始化了一个 DWRepo,同时 git push 到了 SOURCE_URL】
-
这一步这里步骤类似。只需要把代码仓库改为私有的就行。
-
创建和编写 podspec。
- 这一步大致与 **CocoaPods 1.0 安装及适配 ** 的一致。只需要把
s.source = { :git => "改成私有地址" }
即可。记得用pod lib lint
是否有问题
- 这一步大致与 **CocoaPods 1.0 安装及适配 ** 的一致。只需要把
-
创建完 podspec 不再是用 trunk 上传自己的 podspec 了。你需要用
pod repo push DWRepo DWCategory.podspec
将.podspec 上传到自己的 repo 中。【这一步,先将 DWCategory.podspec 拷贝到了 自己的 repo 中,再将 repo 同步到服务器上】
- 你可以按照上面步骤搭建一个 类似 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 git@github.com:Damonvvong/DWCategory.git
这里是利用 SSH 方式 clone,配置 SSH教程传送门
- 把自己的分类放入桌面的DWCategory文件夹中,如下。
本文编辑于 2016年9月20日