使用CocoaPods上传自己的依赖库

创建一个Git项目

项目内容

  • 项目文件
  • YourProjectName.podspec文件(CocoaPods配置文件)
    文件创建:使用终端命令
pod spec create [YourProjectName|ProjectUrl] 

例:

pod spec create YourProjectName|https://git.coding.net/User/YourProject.git

创建podspec文件,使用命令

chmod +x YourProjectName.podspec

将文件转换成 Unix executable 文件

文件内容:

Pod::Spec.new do |s|
  s.name = 'YourProjectName'
  s.version = '1.0.0'
  s.license = 'MIT'
  s.summary = 'Project Summary'
  s.homepage = 'https://www.baidu.com'
  s.social_media_url = 'https://www.baidu.com'
  s.authors = { 'YourName' => '[email protected]' }
  s.source = { :git => 'https://git.coding.net/User/YourProject.git', :tag => s.version }

  s.ios.deployment_target = '9.0'

  # 指定你的三方文件(使用通配符,建议拿其他三方库的文件进行修改)
  s.source_files = 'YourProject/*.swift'
  s.dependency 'AFNetworking', '~> 2.3'   #依赖关系,该项目所依赖的其他库,如果有多个需要填写多个s.dependency
end

该文件中 s.version 指定的版本号需要在Git上添加tag标记,该标记是给版本指定项目分支(如果没有添加或者格式错误,上传和获取的时候会产生branch错误)

  • .swift-version文件(项目Swift版本说明文件,CocoaPods默认Swift版本是3.0)
    文件内容:Swift版本号。例:
3.1
  • LICENSE文件(该文件是版权说明文件,不提供该文件CocoaPods不会帮你自动配置项目)
    文件创建:使用终端命令
vim LICENSE

创建文本文件(文件名:LICENSE),使用命令

chmod +x LICENSE

将文件转换成 Unix executable 文件

文件内容:授权说明。例:

Copyright © 2017年 YourName. All rights reserved. 
other info...

私有三方库

当创建了一个Git项目后,就有了一个私有的三方库,可直接在Podfile文件中添加代码

 pod 'YourProjectName', :git => ' https://git.coding.net/User/YourProject.git'

然后

pod install
或
pod update

公有三方库

Trunk

以上的方法,使用 pod search 是搜不到你的库的,因为这只是你私有的库而已。在你本地,前往~/.cocoapods/repos/master/Specs,你会看到CocoaPods所有公有的开源库配置,这个通过cocoapod官方在github的specs来管理,地址为https://github.com/CocoaPods/Specs 。说到这里,你会想把这个库fork分支下来,clone到你本地,把自己的YourProjectName.podspec加入,然后add、commit、 push,最后在github上pull request来和官方的主分支合并,可是你会发现请求马上被自动关闭。WHY!!!!!! 虽然一开始使用GitHub Pull Requests来整理所有公共pods效果很好。但是,随着Pod数量的增加,这个工作对于spec维护人员Keith Smiley来说变得十分繁杂。甚至一些没有通过$ pod lint的spec也被提交上来,造成repo无法build。 CocoaPods 0.33中加入了Trunk服务。CocoaPods Trunk服务的引入,解决了很多类似的问题。CocoaPods作为一个集中式的服务,使得分析和统计平台数据变得十分方便。下面来说说怎么分布CocoaPod。

使用Trunk服务

  1. 注册电脑
    使用podspec文件中的邮箱和用户名进行注册
pod trunk register [email protected] 'yourname'

成功后你会收到一份邮件,需要点击验证。

可以使用 pod trunk me 查看自己的注册信息

  1. 可以使用 pod trunk add-owner [email protected] 添加其他维护者

  2. 提交podspec文件

pod trunk push YourProjectName.podspec

在提交之前你可以使用 pod spec lint YourProjectName.podspec 验证你本地的podspec文件(是否有错误)
如果验证成功的话会显示

YourProjectName.podspec passed validation.

但你收到类似消息,如:

[!] /usr/bin/git clone https://github.com/User/YourProject.git /var/folders/z2/h6c1f1hj72b6p5y3dhgjd27c0000gn/T/d20150827-4039-1ujw0u9 --single-branch --depth 1 --branch v1.0.0Cloning into '/var/folders/z2/h6c1f1hj72b6p5y3dhgjd27c0000gn/T/d20150827-4039-1ujw0u9'...
warning: Could not find remote branch v1.0.0 to clone.
fatal: Remote branch v1.0.0 not found in upstream originUnexpected end of command stream

这是因为Git项目没有给分支添加tag标记或者tag标记格式错误
如果错误提示是 branch v1.0.0,格式就是v+版本号
如果错误提示是 branch 1.0.0,格式就是版本号

等待部署成功。

上面的代码做了三件事: *验证你的podspec文件是否合法。在trunk方式之前我们一般用“pod spec lint”命令进行验证。 *上传podspec文件到trunk服务器(其实最终也会自动添加到https://github.com/CocoaPods/Specs中,只是使用trunk方式省去了以前先fork在pull request的繁琐操作) *将你上传的podspec文件转成json格式文件
执行上面的push操作,就相当于你把你的源代码提交给CocoaPods团队审核了,一般需要一到两个工作日可以审核结束。这种心情有点像提交App给Apple审核,哈哈。

其实在这里就可以使用 pod 'YourProjectName' 来安装自己的CocoaPods依赖库,只是不能 pod search 到而已

查看我们自己创建的pods依赖库 如果收到了cocoapods官方发过来的审核通过邮件后,你很急着用pod search命名肯定会失望,没收到,还记得我们本地的~/.cocoapods/repos/master/Specs吗,还没跟官方的github上的Specs同步, 执行一次
pod setup
或者
pod update
来更新本地缓存的Spec库,再去search就能看到了
就能够用
pod 'YourProjectName', '~> 1.0.0'
这样去安装自己pod依赖库了 而.podspec文件也可以作为管理内部代码的利器
pod 'Z', :path => 'path/to/directory/with/podspec'

这里不要使用 pod install,这行命令不会更新本地的三方库列表

参考: http://m.blog.csdn.net/bluefish89/article/details/48030941

你可能感兴趣的:(使用CocoaPods上传自己的依赖库)