iOS,制作属于自己cocoapods,(framework,bundle)

缘由: 还是那个小活,需求方想用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" => "810646506@qq.com" }
    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：依赖库，不能依赖未发布的库.如AFNetWorking

• s.vendored_frameworks:包含的framework,也就是我们自己制作的pod

• s.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

.swift-version.png">

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 eloy@example.com Eloy Durán --description=Personal Laptop
  • pod trunk register eloy@example.com --description=Work Laptop
  • pod trunk register eloy@example.com

这个时候,你填写的邮箱会收到一封邮件,把链接复制,在浏览器打开就可以了,如果没有打开这个链接,下面的步骤是不能进行的

• 查看注册信息:

pod trunk me
复制代码

  - Name:     lixianshen
  - Email:    810646506@qq.com
  - 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 Cocoapods

  • Framework和.a的制作 Framework+a

结束语:

如果发现问题,或者有不懂的地方,请留言