Github地址 zhangxiaomeng1 (ZXM) · GitHub
正文目录
一. 创建公有Pod库
1、注册CocoaPods账户信息
2、创建共享库文件并上传到公有仓库
3、编辑.podspec文件
4、打tag, 发布一个release版本
5、发布自己的库描述文件podspec给cocoapods
6、关于查找和使用新创建的库
7、更新维护podspec
二. 创建私有Pod库,整体思路:
1.创建一个私有spec repo 管理所有私有spec文件;
2.创建Pod所需要的项目工程文件,并且有可访问的项目版本控制地址;
3.创建Pod所对应的podspec文件;
4.验证podspec文件是否可用;
5.向私有的spec repo里添加podspec文件;
6.新建个项目测试自己的私有库;
7.更新podspec,建不同的版本;
一. 创建公有Pod库
1. 创建一个工程 ,打开终端,切换到你要创建的位置的目录,
cd /Users/zhangxiaomeng/Desktop/Repertory/OC/MyPods/XMLineChartView
pod lib create XMLineChartView
当被问及创建Swift还是OC项目,按自己要求回答,我选择ObjC;
当被问及是否创建一个demo应用包含在工程里,根据需要,如果需要写一个demo示例,就选择Yes,否则选择NO,我这里选择Yes;
当被问及是否需要使用测试Framwork,选择NO;
当被问及是否需要做接界面调试,我这里选择NO;
还有一个就是工程文件的前缀,我这里是自己的名字的缩写,这个随意写;
2.填写podspec信息,这个文件主要是用来描述pod的版本号,首页(homepage),作者信心等,具体的可以参看官方offical reference page
README如果你使用过GitHub,你肯定知道README文件的重要性,这个文件可以使用Markdown语法,主要展示在GitHub工程上的首页。README文件对于使用这个pod库的人来说,有和没有这个文件,区别是很明显的,此外这还有助于创建一个高质量的CocoaPods Quality Index;
LICENSE要想是Spec仓库接收,就必须包含一个license。命令pod lib create自动创建使用的是MITlicense;
其实通过pod lib lint这个命令,Cocoapods已经帮我们创建了一个模板我们只需要在里面根据需要你进行配置即可.没有用到的注释(#开头的)可以删除掉,看起来舒服一些.
接下来,我们做一个远程验证
pod lib lint XMLineChartView.podspec --allow-warnings
只要见到passed validation就是成功通过了验证.
通过以上步骤,我们只是创建了一个合格的空的工程,并没有实现任何功能,接下来我们就需要把自己要实现的功能代码方进去.
找到工程中ReplaceMe文件,替换就可以.
如果你在创建工程时候创建了一个包含demo的工程,那么你可以先切换到工程的Example文件目录下面使用命令:
pod install
成功以后你就可以在demo文件中使用你的功能文件了.如果不能导入,那么可以commond + B编译一下再导入使用
3.我们还没有在GitHub上面创建相关的仓库,因此可以先进入GitHub账户创建仓库
4. 提交自己的pod
Step 1: 接下来就需要把自己的工程推送到Github:
git add .
git commit -m “Initial Commit"
git remote add origin https://github.com//YourPodName.git // replacewith your github.com username
git push -u origin master
//添加版本号
$ git tag -m "first release" "0.1.0"
$ git push --tags
Step 2 :验证
终端切换到LPodTest.podspec文件所在的目录下面,运行命令
pod lib lint --allow-warnings
如果出错:
[!] QXMFatherHomeTbaListMoreVC_Category did not pass validation, due to 2 errors.
You can use the `--no-clean` option to inspect any issue.
解决:
pod lib lint --allow-warnings --use-libraries
5. 提交pod 到Specs仓库
在这里有个pod trunk工具需要实现(只需要配置一次即可)。trunk工具是为了认证用户信息(包括设备)而存在的,只有注册认证通过了,才能够发布公开库。
注册trunk:
$ pod trunk register 邮箱 '名称' --description='描述'
替换自己的邮箱名称和描述
注册成功后提示:
[!] Please verify the session by clicking the link in the verification email that has been sent to13162255392@163.com
需要我们接受认证邮件并点击附带链接确认。当我们完成注册后,以后不需要此步骤。最后使用trunk工具,发布公开库。
$ pod trunk push XMLineChartView.podspec --allow-warnings
Updating spec repo `master`
--------------------------------------------------------------------------------
🎉 Congrats
🚀 XMLineChartView (1.1.3) successfully published
📅 March 25th, 18:55
🌎 https://cocoapods.org/pods/XMLineChartView
👍 Tell your friends!
如果出错:
[!] The spec did not pass validation, due to 2 errors.
解决
pod trunk push --allow-warnings --use-libraries
6. pod search 检验是否可用大多情况下会出现这个问题:
[!] Unable to find a podwithname, author, summary,ordescriptionmatching `LPodTest
这主要是因为在本地索引里面没有, 解决办法
pod setup (不行,实用方法二)
pod repo update(不行,试用方法三)
前往这个路径下~/Library/Caches/CocoaPods删除search_index.json文件 , 或者使用终端命令删除:
rm ~/Library/Caches/CocoaPods/search_index.json
然后重新搜索.
打包类库
需要使用一个cocoapods的插件cocoapods-packager来完成类库的打包。当然也可以手动编译打包,但是过程会相当繁琐。
安装打包插件
终端执行以下命令
sudo gem install cocoapods-packager
打包
命令很简单,执行
pod package BZLib.podspec --library --force
其中--library指定打包成.a文件,如果不带上将会打包成.framework文件。--force是指强制覆盖。最终的目录结构如下
修改spec文件
#s.source_files = 'ABTestFrameWork/Classes/**/*'
s.vendored_frameworks ='ABTestFrameWork-1.0.5/ios/ABTestFrameWork.framework'
(.a是s.vendored_libraries,.framework是s.vendored_frameworks。)
最后执行 pod trunk push --allow-warnings --use-libraries
二.创建私有库
1、如果想利用pod安装私有库,那么就得创建和cocoapods官方一样的结构,我们想来看看cocoapods官方的结构,cocoapods所有公共库文件都存放在CocoaPods spec远端文件地址,如果在电脑上安装了cocoapods它会从这个地址clone一份到本地,每次pod update 都会更新这个本地仓库,首先先创建一个私有的库 ,由于github的私有仓库是收费的,这里用coding码市创建私有仓库,如果和其他人协同开发,只要把该仓库的权限添加给他就行。
在coding码市在创建2个仓库,一个仓库存放spec文件, 一个存源代码,
创建完远端的spec XMSpec,在终端执行
pod repo add XMSpec https://git.coding.net/n34/XMSpec.gi
然后执行
open ~/.cocoapods/repos
会开看到在repos中创建了一个私有的仓库,master是cocoapods官方的
2.创建工程和编辑spec文件
cd /Users/zhangxiaomeng/Desktop/Repertory/OC/MyPods/XSPrivate/XSCategorys
pod lib create XSCategorys
3、上传到coding和打tag
4、验证.podspec文件
pod lib lint XSCategorys.podspec --allow-warnings
报错有可能
5、向私有的库里添加podspec文件
pod repo push XMSpec XSCategorys.podspec
6.验证一下结果;
pod search XSCategory
[!] Unable to find a pod with name, author, summary, or description matching `XSManager`
解决办法:
rm ~/Library/Caches/CocoaPods/search_index.json
7、新建一个项目进行验证
xcode新建项目 在podfile中添加
pod 'XSCategorys', '~> 0.0.2'
如果提示'unable to find a specification for'
需要在podfile文件中添加源地址
source 'https://github.com/CocoaPods/Specs.git'
source 'https://git.coding.net/n34/XMSpec.git'