缘由:
还是那个小活,需求方想用cocoapods来集成framework,由于之前,我从没有自己做过属于自己的cocoapods,所以也是一脸懵逼,各种查资料.
制作cocoapods步骤:
- 代码提交到github平台
- 创建.podspec
- 编辑.podspec
- 项目打tag
- 验证.podspec
- 注册 cocoapods trunk帐号
- 发布.podspec到cocoapods
1.代码提交到github平台
1.在github上创建一个新的仓库<图中的1、2一定要选择,2可以是其他的License
>
2.clone代码到本地
3.相加自己的项目,然后提交到github上
git add .
git commit -m "描述"
git push origin master
2.创建.podspec
在项目目录下,执行命令创建.podspec,一下3中方式都可以创建:
- $ pod spec create CFMobAdSDK.podspec
- $ touch CFMobAdSDK.podspec
- $ vim CFMobAdSDK.podspec
3.编辑.podspec
记住:不要用文本编辑打开编辑,不要用文本编辑打开编辑,不要用文本编辑打开编辑,
可以用atom编辑
可以用vim命
令编辑,vim
状态下,按i
进入编辑状态,按esc
退出编辑状态,然后输入:wq
保存退出编辑
:Pod::Spec.new do |s|
s.name = "CFMobAdSDK"
s.version = "1.0.6"
s.ios.deployment_target = '7.0'
s.summary = "广告sdk,一个简单的广告SDK."
s.homepage = "https://github.com/lixianshen/CFMobAdSDK"
s.license = { :type => "MIT", :file => "LICENSE" }
s.author = { "Simple" => "[email protected]" }
s.source = { :git => "https://github.com/lixianshen/CFMobAdSDK", :tag => s.version }
#s.source_files = "CFMobAdSDK/*"
s.resources = "CFMobAdSDK/CFMobAdSDK.bundle"
s.frameworks = 'Foundation', 'UIKit', 'CoreLocation', 'AdSupport'
s.vendored_frameworks = 'CFMobAdSDK.framework'
s.requires_arc = true
end
下面介绍一下.podspec中部分代码的含义:
s.name:名称,
pod search
搜索的关键词,一定要和.podspec的名称一样,否则报错s.version
:版本号s.ios.deployment_target
:支持的pod
最低版本s.summary
: 简介s.homepage
:项目主页地址s.license
:开源协议(创建github
库的时候选择的)s.author
:作者信息(这里随便谢谢也可以通过)s.social_media_url
:社交网址s.source
:项目的地址s.source_files
:需要包含的源文件s.resource
:资源文件,单个s.resources
: 资源文件(含bundle
)s.requires_arc
: 是否支持ARC
s.dependency
:依赖库,不能依赖未发布的库.如AFNetWorkings.vendored_frameworks
:包含的framework
,也就是我们自己制作的pods.description
:描述,字数要比s.summary
长s.screenshots
:截图s.exclude_files
:隐藏的文件s.public_header_files
:公开的头文件s.framework
:所需的framework
,单个s.frameworks
:所需的framework
,多个用逗号隔开s.vendored_libraries:包含的的.a
注意事项:多个s.dependency可以这样写,(可以加上版本号):
s.dependency = 'AFNetworking', '~> 2.3'
s.dependency = 'SDWebImage'
s.dependency = 'AFNetworking's.license可以用下面2中写法:
s.license = "MIT" 会有一个警告
s.license = { :type => "MIT", :file => "LICENSE" }s.source_files:写法及含义:
"CFMobAdSDK/*
"CFMobAdSDK/*.{h,m}"
"CFMobAdSDK/**/*.h"
“” 表示匹配所有文件
“.{h,m}” 表示匹配所有以.h和.m结尾的文件
“**” 表示匹配所有子目录
-
s.source 常见写法
/// git commit -m =>"13287dd",讲pod版本与git仓库中的某一次提交绑定 s.source = { :git => "https://github.com/lixianshen/CFMobAdSDK", :commit => "13287dd" } /// 将这个Pod版本与Git仓库中某个版本的comit绑定 s.source = { :git => "https://github.com/lixianshen/CFMobAdSDK", :tag => 1.0.0 } /// 将这个Pod版本与Git仓库中相同版本的comit绑定 s.source = { :git => "https://github.com/lixianshen/CFMobAdSDK", :tag => s.version }
4.上传编辑好的.podspec
5.tag标记,并且上传
```
/// 第一次需要在前面加一个v
git tag "v1.0.0"
git push --tags
```
6.验证.podspec
方式一
// 加上--verbose验证失败会显示详细的报错信息
pod spec lint CFMobAdSDK.podspec --verbose
方式二
pod spec lint
验证开始
-> CFMobAdSDK
成功:
验证失败的一些情况:
1.下面这种情况,只要在终端运行命令:echo "2.3" > .swift-version
2.- ERROR | [iOS] file patterns: The source_files
pattern did not match any file.
解决方法: 文件路径不对, 也就是设置 s.source_files 字段时, 发生了错误
3.- ERROR | [iOS] file patterns: The vendored_frameworks
pattern did not match any file.
解决方法: framework路径不对, 也就是设置 s.vendored_frameworks 字段时, 发生了错误
7.注册cocoapods trunk
trunk需要
cocoaPods
的版本在0.33版本,用pod --version
,如果版本低,先升级sudo gen install cocoapods
和pod setup
-
注册的三种方式:
- pod trunk register [email protected]
Eloy Durán
--description=Personal Laptop
- pod trunk register [email protected] --description=
Work Laptop
- pod trunk register [email protected]
- pod trunk register [email protected]
这个时候,你填写的邮箱会收到一封邮件,把链接复制,在浏览器打开就可以了,如果没有打开这个链接,下面的步骤是不能进行的
- 查看注册信息:
pod trunk me
- Name: lixianshen
- Email: [email protected]
- Since: May 1st, 01:51
- Pods:
- CFMobAdSDK
- Sessions:
- May 1st, 01:51 - September 7th, 08:30. IP: 125.121.226.128 Description:
Simple
- May 2nd, 18:35 - September 7th, 18:43. IP: 125.118.107.149
- May 2nd, 20:55 - September 7th, 21:05. IP: 125.118.107.149
- May 4th, 02:19 - September 9th, 02:20. IP: 125.118.107.149
8.发布自己的.podspec到cocoapods
pod trunk push CFMobAdSDK.podspec
-
如果有警告用:pod trunk push CFMobAdSDK.podspec --allow-warnings
1.先验证是否正确
2.发布成功
3.检查自己发布的pod
检查之前先删除缓存中的json文本
~/Library/Caches/CocoaPods/search_index.json
如果不删除,会搜索不到自己发布的,如果让你朋友也要查到也要删除现有的缓存4.搜索记录
如果想删除已发的版本,需要使用下面的命令:
pod trunk delete CFMobAdSDK 版本号
例如
pod trunk delete CFMobAdSDK 1.0.1
到这基本结束了:下面是几个和本内容相关的比较好的链接:
trunk 命令详解:
trunk制作cocoapods的官方网站
Making CocoapodsFramework和.a的制作
Framework+a
结束语:
如果发现问题,或者有不懂的地方,请留言