如何发布github上的CocoaPods Pod库

将自己的开源代码提交到github后,我们还可以将其发布到CocoaPods上,从而可以通过pod来管理项目,其中的好处我不说大家都知道=_=(CocoaPods大法好!)

发布步骤

第一步

打开终端,进入项目工程根目录,创建podspec文件

pod spec create CJLabel

第二步

编辑podspec文件

vim CJLabel.podspec

执行命令后会自动生成一份模版文件,我们只需修改其中的一些主要内容即可
image填写的时候注意几点:

  1. s.license = “MIT” ,默认选这个,但我选择后提示错误[iOS] license: Unable to find a license file,经google后找到解决方案,可改为后面的那段描述

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    s.license      = { :type => 'Apache License, Version 2.0', :text => <<-LICENSE
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at
    http://www.apache.org/licenses/LICENSE-2.0
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
    LICENSE
    }
  2. s.source 可直接填github上对应的托管地址,注意最后要以.git结尾,并填写对应的tag号

  3. s.source_files是一定要填写正确的,不然无法提交 .podspec文件

第三步

设置tag号,提交修改

  • 先提交当前修改 :$ git commit -m “Release 0.0.1”
  • 可选,查看当前tag :$ git tag
  • 可选,删除本地指定tag :$ git tag -d 0.0.1
  • 可选,删除远程指定tag :$ git push origin :refs/tags/0.0.1
  • 添加tag  :$ git tag 0.0.1
  • 可选,推送指定tag到远程 :$ git push origin 0.0.1
  • 可选,推送所有tag到远程 :$ git push –tags
  • 推送到远程到代码仓库 :$ git push origin master

完成以后验证配置:

pod spec lint CJLabel.podspec
pod spec lint CJLabel.podspec –allow-warnings(表示忽略项目警告)

如果出现提示:image
那么就是已经配置成功,可以提交到cocoapods了,否则要将所有提示的error和warn修改掉。(这一步花费了我不少时间,用心修改吧-_-#)

  • 附修改步骤:
    1、先删除远程tag

    git push origin :refs/tags/0.0.1

    2、 重复上面的第三步步骤

第四步

提交cocoapods

pod trunk push CJLabel.podspec
pod trunk push CJLabel.podspec –allow-warnings(表示忽略项目警告)

如果在这一步出现提示[!] You need to register a session first.
可以执行以下指令来解决:

pod trunk register 邮箱地址 “用户名” –description=”macbook pro”

之后会有一封带有验证链接的邮件发送到你输入的邮箱,点击验证后就可以回来终端继续提交操作了。

第五步

提交成功后可以执行pod search命令来搜索提交的库,如果搜索不成功则执行pod setup,更新pod库,再次搜索。搜索成功后安装。