创建私有Pod库

步骤总览

• 创建一个git仓库用来做内部私有库的Spec Repo
• 创建私有Pod组件库
• 将podspec文件加入私有Sepc Repo中
• 查找和使用内部组件库

创建一个git仓库用来做内部私有库的Spec Repo

image.png

创建私有Pod组件库

• 了解原理
  • 用pod install命令的时候，为什么可以直接把代码或者资源直接导入到我们的工程的？其实在我们的本地有目前支持cocoapods所有项目的信息，我们可以打开~/.cocoapods/repos/Specs目录，目录里面有很多的文件夹，在这些文件夹中我们项目中所使用的第三库NIMSDK，进入目录下，我们搜索NIMSDK，会发现有很多NIMSDK.podspec.json文件，这是一个json格式的文件，打开后看到下面的代码，对比这些同名字的，主要是版本号的不同
    image.png
    image.png
  • 上图可以清楚看到有关NIMSDK的信息，比如git地址，开源协议，简介等。有了这些数据cocoapods就可以找到需要同步的资源的位置。在Specs文件夹下的所有索引信息其实都是从cocoapods的官方git主分支https://github.com/CocoaPods/Specs上同步下来的。整个cocoapods的运作过程可以参照下图
    
  • 通过上述简介，其实制作cocoapods仓库的步骤无非就两步：
    • 制作podspec索引文件,文件中放入需要同步的资源的git或者svn地址
    • 把制作的podspec索引文件推到官方的git远程主分支上

• 如果我们的库是新建的，那么别的使用者的本地分支上是没有对应的.podspec.json文件的，也就相应获取不到。这个时候使用者需要使用pod repo update命令去远程重新获取更新本地分支
• ~/.cocoapods/repos文件是一个隐藏目录，默认是看不到隐藏目录的，但是我们可以通过Terminal执行以下命令控制隐藏文件的显示与否
  defaults write com.apple.finder AppleShowAllFiles -boolean true ; killall Finder 显示
  defaults write com.apple.finder AppleShowAllFiles -boolean false ; killall Finder 隐藏
• pod install 和 pod update 的区别
  使用install 会优先安装Podfile.lock文件中的内容,而不会主动更新Podfile.lock文件.而执行pod update方法会主动获取最新的库,并更新Podfile.lock文件,这两个命令都会升级CocoaPods的spec仓库

• 创建私有Spec Repo
  • Terminal执行以下命令
    # pod repo add [Private Repo Name] [GitHub HTTPS clone URL]
pod repo add YTDevice https://github.com/Yakov1012/YTDevice.git
    image.png
  • 前后可以看到~/.cocoapods/repos/Specs的变化，多出来我们自己新建的YTDeviceRepo
    image.png
    image.png
• 创建私有Pod组件库
  • 在Terminal中cd进入要创建项目的目录
    桌面目录
  • 然后执行以下命令
    #pod lib create [项目名]
pod lib create YTDevice
  • 之后他会问你四个问题
    • 是否需要一个例子工程
    • 选择一个测试框架
    • 是否基于View测试
    • 类的前缀

image.png

• 回答完以上问题，会自动在桌面创建一个YTDevice项目

├── Example
demo APP
│ ├── YTDevice.xcodeproj
│ ├── YTDevice.xcworkspace
│ ├── Podfile
demo APP 的依赖描述文件
│ ├── Podfile.lock
│ └── Tests
demo APP 的依赖文件
│ ├── Pods
demo APP组件的目录
├── LICENSE
开源协议 默认MIT
│ ├── Assets
资源文件
│ └── Classes
│ │ └── ReplaceMe.m 此处用于存放自己实现库的相关代码！！！
类文件
├── YTDevice.podspec
第三步要创建的podspec文件
└── README.md
MarkDown格式的README

• 添加实现代码
  • 在YTDevice项目中，添加我们的实现代码，注意把实现代码加入到ReplaceMe.m所在目录
    image.png
  • 开发模式下测试pod库的代码
  • 打开Example工程目录Podfile文件
    pod 'MyLib', :path => '../' # 指定路径
  • 然后在Example工程目录下执行pod update命令安装依赖，打开项目工程，可以看到库文件都被加载到Pods子项目中了，不过它们并没有在Pods目录下，而是跟测试项目一样存在于Development Pods/YTDevcie中，这是因为我们是在本地测试，而没有把podspec文件添加到Spec Repo中的缘故
    image.png
• 本地pod组件库，与远程git库链接
  在Terminal中cd进入YTDevice项目的根目录，并执行以下命令

git add . # 添加文件
git commit -s -m "初始化YTDeviece库"
git remote add origin https://github.com/Yakov1012/YTDevice.git #与远端仓库链接
git push origin master #提交到远端仓库
git tag -m "first release" '1.0.1' #打上标签，这个很重要
git push --tags #推送tag到远端仓库

将podspec文件加入私有Sepc Repo中

• 配置YTDevice库的podspec文件
  image.png

#
# Be sure to run `pod lib lint YTDevice.podspec' to ensure this is a
# valid spec before submitting.
#
# Any lines starting with a # are optional, but their use is encouraged
# To learn more about a Podspec see http://guides.cocoapods.org/syntax/podspec.html
#

Pod::Spec.new do |s|
  s.name             = 'YTDevice'
  s.version          = '1.0.1'
  s.summary          = 'YTDevice.'

# This description is used to generate tags and improve search results.
#   * Think: What does it do? Why did you write it? What is the focus?
#   * Try to keep it short, snappy and to the point.
#   * Write the description between the DESC delimiters below.
#   * Finally, don't worry about the indent, CocoaPods strips it!

  s.description      = <<-DESC
设备工具类，可查询当前设备名称，版本号等
                       DESC

  s.homepage         = 'https://github.com/Yakov1012/YTDevice'
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'Yakov1012' => '1446486761@qq.com' }
  s.source           = { :git => 'https://github.com/Yakov1012/YTDevice.git', :tag => s.version.to_s }
  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'

  s.ios.deployment_target = '8.0'

  s.source_files = 'YTDevice/Classes/**/*'
  
  # s.resource_bundles = {
  #   'YTDevice' => ['YTDevice/Assets/*.png']
  # }

  # s.public_header_files = 'Pod/Classes/**/*.h'
  # s.frameworks = 'UIKit', 'MapKit'
  # s.dependency 'AFNetworking', '~> 2.3'
end

• 编辑完YTDevice.podspec文件后，需要验证一下这个YTDevice.podspec文件是否可用
  • 在Terminal中执行cd进入YTDevice项目根目录然后，执行命令pod lib lint

  • 看到以下输出代表验证成功

    
    image.png
    image.png

• Example工程目录下执行pod update命令安装依赖，打开项目工程，现在可以看到库文件都被加载到Pods子项目中了

  #pod 'YTDevice', :path => '../' # 指定路径
  pod 'YTDevice', :podspec => '../YTDevice.podspec'  # 指定podspec文件

• pod search可能出现以下问题，根据提示解决即可
  image.png
  image.png
  删除Assets 和 Classes
  image.png
  出现以上界面代表搜索成功

CocoaPods 在主干上发布pods

CocoaPods Trunk 是一个基于授权的CocoaPodsAPI服务。 要在主干上发布或者更新库，需要注册。

• 注册CocoaPods账户信息

使用trunk方式, 在终端执行如下代码
使用github邮箱和用户名
pod trunk register 邮箱地址 '用户名' --verbose

image.png

上图会提示你打开你的邮箱，打开确认链接，即可注册成功 image.png

成功之后可以终端执行如下代码:
pod trunk me
查看自己的注册信息, 以后当你有了自己的开源Pod库, 也可以用此方式随时查看自己发布过的Pods

image.png
image.png
然后去邮箱验证，验证后，可以通过命令 pod trunk me来查看账号所有Session
然后通过命令pod trunk push来发布pod。
image.png
image.png