1. 创建一个工程
打开终端,切换到你要创建的位置的目录,我这里是/Desktop/POD
cd Desktop/POD
pod lib create HYPodTestOneDemo
1、What is your email?
填入自己的邮箱地址。
2、What platform do you want to use?? [ iOS / macOS ]
根据自己的需要选择, 此处选择iOS。
3、What language do you want to use?? [ Swift / ObjC ]
根据自己的需要选择, 此处选择ObjC。
4、Would you like to include a demo application with your library? [ Yes / No ]
是否创建一个demo应用包含在工程里, 根据自己的需要选择,此处选择Yes。
5、Which testing frameworks will you use? [ Specta / Kiwi / None ]
是否需要使用测试Framwork,选择None。
6、Would you like to do view based testing? [ Yes / No ]
否需要做接界面调试test,此处选择No。
7、What is your class prefix?
设置工程文件的前缀,这个根据自己的代码规范填写。
2.填写Pod的Metadata和验证
- .podspec这个文件主要是用来描述pod的版本号,首页(homepage),作者信心等,具体的可以参看官方offical reference page
- README如果你使用过GitHub,你肯定知道README文件的重要性,这个文件可以使用Markdown语法,主要展示在GitHub工程上的首页。README文件对于使用这个pod库的人来说,有和没有这个文件,区别是很明显的,此外这还有助于创建一个高质量CocoaPods Quality Index ;
-
LICENSE要想是Spec仓库接收,就必须包含一个license。命令
pod lib create
自动创建使用的是 MIT license;
其实通过pod lib lint
这个命令,Cocoapods已经帮我们创建了一个模板我们只需要在里面根据需要你进行配置即可.没有用到的注释(#开头的)可以删除掉,看起来舒服一些.
其中,s.version 根据自己项目的版本配置好
s.summary 最好填写一下描述,不然会有警告
3.在GitHub中创建一个项目
接下来就需要把自己的工程推送到Github:
git add .
git commit -m “Initial Commit"
// replace <GITHUB_USERNAME> with your github.com username
git remote add origin https://github.com/<GITHUB_USERNAME>/YourPodName.git
git push -u origin master
做完以上操作,没有问题的话, 就可以做验证了:
pod lib lint HYPodTestOneDemo.podspec
只要见到passed validation就是成功通过了验证。
4.添加自己的代码
通过以上步骤,我们只是创建了一个合格的空的工程,并没有实现任何功能,接下来在图中classes路径下创建自己的代码类。
添加完自己的代码后执行以下命令
git add .
git commit -m "code"
git push
1、以上已经可以使用pod导入库文件
pod 'HYPodTestOneDemo', :git => 'https://github.com/<GITHUB_USERNAME>/HYPodTestOneDemo'
2、发布开源项目到cocoapods上去需要添加版本号,用git tag添加版本号。
git tag -a 1.0.0 -m"version 1.0.0"
添加完版本号后,用'git tag'命令查看tag是否添加成功
git tag
将本地添加的tag同步到远程代码仓库:
git push --tag
终端切换到.podspec文件所在的目录下面,运行命令
pod spec lint HYPodTestOneDemo.podspec
-> HYPodTestOneDemo (1.0.0)
Analyzed 1 podspec.
HYPodTestOneDemo.podspec passed validation.
提交pod到Specs仓库
pod trunk push HYPodTestOneDemo.podspec
Updating spec repo `master`
Validating podspec
-> HYPodTestOneDemo (1.0.0)
Updating spec repo `master`
----------------------------------------------------------------------
🎉 Congrats
🚀 LPodTest (0.1.0) successfully published
📅 March 3rd, 03:07
🌎 https://cocoapods.org/pods/LPodTest
👍 Tell your friends!
需要注意的是,这种提交命令,不允许你的podspec文件存在警告。若存在警告,则不能通过有效性验证,导致发布失败!
我们可以加上允许警告的选项(--allow-warnings)如:
pod trunk push HYPodTestOneDemo.podspec --allow-warnings
使用pod search 检验是否可用
pod search HYPodTestOneDemo
若出现红色报错:
可以通过重新创建索引来解决:
rm ~/Library/Caches/CocoaPods/search_index.json
再次搜索时,会自动重新创建索引
终端提示(END) 键盘敲Q退出
接着本地测试一下,如果你在创建工程时候创建了一个包含demo的工程,那么你可以先切换到工程的Example文件目录下面使用命令:
pod install
成功以后你就可以在demo文件中使用你的功能文件了.如果不能导入,那么可以commond + B编译一下再导入使用