用CocoaPods创建远程公有库到github

我们要发布一个 图片浏览组件：DDPhotoBrowser，需要的步骤？

1. 创建本地组件模板
2. 为工程添加写好的组件
3. 添加组件到Example工程内
4. 创建远程仓库
5. 本地仓库关联远程仓库
6. 本地仓库提交到远程仓库
7. 检验.podspec文件有没有问题
8. 注册Trunk
9. 发布.podspec push到cocopods的trunk中
10. 验证是否上传到CocoaPods的索引库中

1.创建本地组件模板

本地创建文件夹OpenSource,打开终端工具并进入OpenSource

pod lib create DDPhotoBrowser

执行结果：

What platform do you want to use?? [ iOS / macOS ]
 > 选择平台
What language do you want to use?? [ Swift / ObjC ]
 > 选择语言
Would you like to include a demo application with your library? [ Yes / No ]
 > 是否自动生成测试demo模板
Which testing frameworks will you use? [ Specta / Kiwi / None ]
 > 是否集成测试框架
Would you like to do view based testing? [ Yes / No ]
 >是否需要基于视图的测试
What is your class prefix?
 > 类文件前缀

之后自动打开创建好的工程，工程目录如下

2. 为工程添加写好的组件

找到创建好的工程目录.../OpenSource/DDPhotoBrowser/DDPhotoBrowser/Classes

原目录结构

把组件复制到.../OpenSource/DDPhotoBrowser/DDPhotoBrowser/Classes

image.png

3. 添加组件到Example工程内

• 终端进入Example工程内

cd DDPhotoBrowser/Example 

• 执行pod install

pod install

• 本地仓库已完成
  
  运行完后的工程目录结构

4. 创建远程仓库

• 打开https://github.com/new创建
  

• 远程仓库地址

• HTTPS：https://github.com/liuhedong01/DDPhotoBrowser.git

• SSH：[email protected]:liuhedong01/DDPhotoBrowser.git

5. 本地仓库关联远程仓库

5.1找到工程内.podspec 文件

5.1修改工程内.podspec内容

Pod::Spec.new do |s|
  # 项目的名称
  s.name             = 'DDPhotoBrowser'
  # 项目的版本号，通过项目git的tag标签进行对应，这里的标签代表的版本
  s.version          = '1.0.0'
  # 项目简单的描述信息
  s.summary          = '图片浏览组件'

# 项目的详细描述信息，注意，这里的文字的长度，一定要比上面的s.summary长，不然会认为格式不合格
  s.description      = '图片浏览 组件描述.'
#TODO: Add long description of the pod here.
  #                       DESC
  # 组件的网页主页
  s.homepage         = 'https://github.com/liuhedong01/DDPhotoBrowser'
  #截图
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  # 开源协议
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  # 作者信息
  s.author           = { 'liuhedong' => '[email protected]' }
  
  # 项目地址，不支持ssh的地址，只支持HTTP和HTTPS
  # tag
  s.source           = { :git => 'https://github.com/[email protected]/DDPhotoBrowser.git', :tag => s.version.to_s }
  
  # 多媒体介绍地址
  # s.social_media_url = 'https://twitter.com/'

  # 支持的平台及版本
  s.ios.deployment_target = '9.0'

  #代码源文件地址，**/*表示Classes目录及其子目录下所有文件，如果有多个目录下则用逗号分开,
  s.source_files = 'DDPhotoBrowser/Classes/**/*'
  # s.source_files = 'DDPhotoBrowser/Classes/**/*', 'DDPhotoBrowser/Classes2/**/*'

  # s.resource_bundles = {
  #   'DDPhotoBrowser' => ['DDPhotoBrowser/Assets/*.png']
  # }

  # 公开头文件地址
  # s.public_header_files = 'Pod/Classes/**/*.h'
  
  # 所需的framework，多个用逗号隔开
  s.frameworks = 'UIKit', 'Foundation'
  
  # 依赖关系，该项目所依赖的其他，当在加载的时候也会一块把相关的依赖的库加载下来，如果有多个需要填写多个
  s.dependency 'SDWebImage', '~> 5.0'
   
end

6. 本地仓库提交到远程仓库

• 终端cd到 DDPhotoBrowser 开源目录下
  

 git add .
/// 提交， -m "提交说明"
 git commit -m "图片浏览组件提交"  
/// 新增提交 使用 git commit -am "提交说明"
 // 将自己的本地仓库和远程仓库进行绑定
 git remote add origin https://github.com/liuhedong01/DDPhotoBrowser.git
// 将本地代码push到远程仓库
 git push origin master
// 1.0.0 需要与.podspec 文件内 s.version 一致
git tag 1.0.0
// 提交
git push --tags

7. 检验.podspec文件有没有问题

• 终端cd到 DDPhotoBrowser 开源目录下

// --verbose 显示详细信息
// --allow-warnings 忽略所有的警告, 可去掉
// --use-libraries 如果没有依赖其他库，可去掉
pod spec lint --use-libraries --verbose --allow-warnings

验证成功

8. 注册Trunk

• 终端执行以下命令

// --description = '描述' 
// --verbose 输出详细信息
pod trunk register [email protected] 'liuhedong'  --verbose

• 查看注册信息

pod trunk me

你会收到一份邮件，收到的邮件有可能在邮件垃圾箱中，需要点击验证。验证完毕之后:

9. 发布.podspec push到cocopods的trunk中

• 终端cd 到 有.podspec文件目录下

// --allow-warnings
pod trunk push DDPhotoBrowser.podspec 

• 发布完成截图
  
• 打开组件地址可以看到
  

10. 验证是否上传到CocoaPods的索引库中

pod search DDPhotoBrowser

• 搜索不到时，请删除search_index.json，重新search

cd ~/Library/Caches/CocoaPods
rm -f search_index.json

• 新建Test工程，测试一下pod 'DDPhotoBrowser'
  
  ipod install成功