/DWCategory

借助 GitHub 托管 Category,利用 CocoaPods 集成到项目中

Primary LanguageObjective-CMIT LicenseMIT

CocoaPods 1.0 + 适配

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

目录


CocoaPods 1.0 安装及适配

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

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

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

利用 CocoaPods 发布自己的三方库

  • 将自己的三方库集成 CocoaPods 只需要三步
      1. 初始化项目
      1. 创建和编写 podspec
      1. 将 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 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 ,出现如下图 运行无误

3. 将 podspec 上传到 CocoaPods 的 repo 上

利用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

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


CocoaPods 1.0 私有 Pods

  • 创建一个私有 pods 需要三个东西
      1. 私有的代码管理仓库
      1. 私有的 repo
      1. 私有 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)

Category.png

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

  • 把 GitHub 上的项目克隆到本地。(打开终端,cd 到桌面)
git clone git@github.com:Damonvvong/DWCategory.git

Category_Clone

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

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

Dir

本文编辑于 2016年9月20日