让自己的代码支持CocoaPods

让自己的代码支持CocoaPods_第1张图片

cocoapod 大家都用过,一些好的第三方的,比如Masonry ,AFNetworking,那你有没有想过有一天把自己写的工具类,分类,封装好,在下一个项目中直接用pod 导入呢;

下面我们就开始做自己的pod

1. 首先在github创建一个项目

这个 pod 我们就叫 ios_categoryPP 吧;

git仓库创建好了
链接 https://github.com/hunter858/ios_categoryPP.git

现在里面什么都没有,那么我们该干嘛呢,把仓库 克隆下来,把我们需要支持的类和 demo 放到仓库中;

2. 在本地新建一个文件夹

取名 ios_categoryPP_demo
在终端进入到该文件夹下,执行该命令 (该命令的意思是clone 仓库到 ios_categoryPP_demo 文件夹内)
可用pwd 查看是否到了正确的文件夹下

git clone https://github.com/hunter858/ios_categoryPP.git

3. 新建一个 Classes 文件夹用来放我们需要支持的类

因为克隆下来的仓库 自己又一个文件夹 ,文件夹名称和仓库名称一致,所以我们在 ios_categoryPP 下建 Classe 文件夹,用来放置pod 支持的类;
再建立一个文件夹叫 [pod名称]demo 的文件夹,这里我是为了规范,告诉用我这个库的用户,我这里有一个demo文件夹,里面又一个库支持的demo工程,一些fock我项目的人也可以直接运行项目,进行更新;

4. 进入到有 .git 的文件夹内;

执行

$ pod spec create iOS_CategoryPP

生成一个ios_categoryPP.podspec

添加Pods依赖库所需文件;
依赖库所需的文件格式为 {project}.podspec 格式,每个Pods依赖库必须有这个描述文件

6. podspec 文件用xcode 打开配置信息如下;

需要把里面的信息填写完成,才不会报错;必填信息可爱的网友已经整理出来了,我就借过来一下,如下所示;

Pod::Spec.new do |s|
   s.name         = "ios_categoryPP"         #名称
   s.version      = "0.0.1"              #版本号
   s.summary      = "在这里写你对这个pod 的介绍信息" #描述
   s.homepage     = "这里填写你在pod在github支持的仓库就行了"                                #描述页面
   s.license      = "MIT" #版权声明
   s.author       = { "作者名称" => "作者邮箱地址" }                        #作者信息

   s.platform     = :ios, "5.0"              #使用平台
   s.source       = { :git => "github.com/hunter858/ios_categoryPP.git", :tag => "#{s.version}"  }  #源码地址
   s.source_files  = "Classes", "Classes/**/*.{h,m}" #源码文件
   s.frameworks = "CoreGraphics", "CoreFoundation", "Foundation", "UIKit"          #依赖的framework
   s.requires_arc = true #是否支持ARC
end

如果你第一次做一个很基础的pod demo 的话,上面的配置信息,基本ok了;

让自己的代码支持CocoaPods_第2张图片

7.pod验证

执行命令

pod lib lint

如果碰见错误,必须要解决掉,才能创建成功;

  • 比如还是碰见报错信息

    ➜ ios_categoryPP git:(master) ✗ pod lib lint

    -> ios_categoryPP (0.0.1)
    - WARN | github_sources: Github repositories should end in .git.
    - WARN | [iOS] license: Unable to find a license file

    [!] ios_categoryPP did not pass validation, due to 2 warnings (but you can use --allow-warnings to ignore them).
    You can use the --no-clean option to inspect any issue.

解释:

第一个说你的项目库 必须要以.git 结束,我们去找到问题,然后解决
这里需要创建一个 license 文件 , 在终端中键入 touch license 暂时什么都不写,等提交成功后,找一个比较知名的pod,把人家的内容copy 一份,抄进来;
注意文件名是否大小写,不然还会报错,这里创建了一个小写的 license,然后两个问题解决了

执行 pod lib lint成功了

-> ios_categoryPP git:(master) ✗ pod lib  lint
    
-> ios_categoryPP (0.0.1)
        
ios_categoryPP passed validation.

编码成功后,打上tag标签,与podspec里面的tag 标签一致,才能推上去;

git tag -m "注释信息" "0.0.1"

git push --tags

推送tag 到远端分支上, 后面的是tag 版本号 ,和ios_categoryPP.podspec 下里面写的版本号一致;

$ pod lib lint --allow-warnings

$ pod lib lint --verbose

附带说一下,Xcode允许警告存在,所以可以通过命令屏蔽警告
如果出现Error但是提示信息不足,可以添加--verbose 以获取更多错误信息

pod trunk push ios_categoryPP.podspec 把 .podspec 推送上去;

如果是第一次使用的话,需要去注册一下; CocoaPods Trunk

注册方法执行以下命令

$ pod trunk register [email protected] 'Orta Therox' --description='macbook air'

$ pod trunk register xxx@email 'xxxx' --description='xxxx' 

进入邮箱,找到发送的验证码链接,在浏览器打开,激活成功,就可以用了,so easy;

执行命令 pod lib lint 成功;
pod trunk push ios_categoryPP.podspec

推送成功

➜  ios_categoryPP git:(master) pod trunk push ios_categoryPP.podspec
Updating spec repo `master`

CocoaPods 1.4.0.beta.2 is available.
To update use: `sudo gem install cocoapods --pre`
[!] This is a test version we'd love you to try.

For more information, see https://blog.cocoapods.org and the CHANGELOG for this version at https://github.com/CocoaPods/CocoaPods/releases/tag/1.4.0.beta.2

Validating podspec
 -> ios_categoryPP (0.0.1)

Updating spec repo `master`

CocoaPods 1.4.0.beta.2 is available.
To update use: `sudo gem install cocoapods --pre`
[!] This is a test version we'd love you to try.

For more information, see https://blog.cocoapods.org and the CHANGELOG for this version at https://github.com/CocoaPods/CocoaPods/releases/tag/1.4.0.beta.2

  - Data URL: https://raw.githubusercontent.com/CocoaPods/Specs/bdda21026298108ad9da4a61987a0840d05bf014/Specs/1/e/3/ios_categoryPP/0.0.1/ios_categoryPP.podspec.json
  - Log messages:
    - October 31st, 04:05: Push for `ios_categoryPP 0.0.1' initiated.
    - October 31st, 04:05: Push for `ios_categoryPP 0.0.1' has been pushed
    (0.735147935 s).

但是我 执行命令没有找到我的pod ,所以我搜索了以下找到解决方法;

pod search ios_categoryPP
  • pod setup成功后会生成~/Library/Caches/CocoaPods/search_index.json文件

  • 终端输入rm ~/Library/Caches/CocoaPods/search_index.json
    删除成功后再执行 pod search

后在一次输入:pod search xxxx

啰嗦重度患者再来说一遍创建和提交流程

  • pod search ios_categoryPP
  • rm ~/Library/Caches/CocoaPods/search_index.json
  • pod search
  • pod search ios_categoryPP
  • 等待一会应该就出来了
    成功找到自己上传的pod
让自己的代码支持CocoaPods_第3张图片
WX20171101-103202.png

成功后的工程的目录结构是这个样子

让自己的代码支持CocoaPods_第4张图片
WX20171101-103302.png
  • pod set 成功的log
➜  ~ pod setup
Setting up CocoaPods master repo
  $ /usr/bin/git clone https://github.com/CocoaPods/Specs.git master --progress
  Cloning into 'master'...
  remote: Counting objects: 1642516, done.        
  remote: Compressing objects: 100% (256/256), done.        
  remote: Total 1642516 (delta 118), reused 35 (delta 35), pack-reused 1642217        
  Receiving objects: 100% (1642516/1642516), 436.77 MiB | 872.00 KiB/s, done.
  Resolving deltas: 100% (876336/876336), done.
  Checking out files: 100% (193077/193077), done.
Setup completed

集成进自己的工程里,发现ok ,就此大功告成

让自己的代码支持CocoaPods_第5张图片
WX20171101-111509.png

参考链接


Cocoapods公有库与私有库
iOS开发-- 创建podspec文件,为自己的项目添加pod支持
Cocoapods: pod search无法搜索到类库的解决办法

你可能感兴趣的:(让自己的代码支持CocoaPods)