图文介绍项目支持cocoapods导入

Posted 2021-04-30 WILLIAMALEX

权当笔记, 之后发布SDK的时候需要使用到该功能, 这篇文章主要讲述如何使自己的工具类或者SDK支持cocoapods的方式导入. 大多数步骤都是在终端中使用命令行操作的. 所以下面就直接贴指令了. 可以去我的github看看podspec文件的配置

• 在github上创建仓库MOZI, 创建时需要注意的是一定要选择开源协议. 比如选择MIT.

• 创建本地仓库, 将远程仓库MOZI clone到桌面上, 并cd到该目录下.

• 创建一个podspec文件

  
  

 $ pod spec create MOZI

    

一, 编辑podspec文件(可以使用vim打开):vim MOZI.podspec, 打开podspec文件之后, 需要修改一些文件, 可以直接在github上参考开源项目的spodspec文件.比如参照AFN的podspec文件.

Pod::Spec.ne do |s|
s.name  = 'AFNetworking'
s.version  = '3.2.1'
s.license  = ‘MIT'
s.summary = 'A delightful ios and OS X networking framework.'
s.homepage = 'https://github.com/AFNetworking/AFNetworking'
s.social_media_url = 'https://twitter.com/AFNetworking'
s.authors = { 'Mattt Thompson' => '[e-mail]’ }
s.source  = { :git => 'https://github.com/AFNetworking/AFNetworking.git', :tag => s.version, :submodules => true }
s.requires_arc = true
s.public_header_files = 'AFNetworking/AFNetworking.h’
s.source_files = 'AFNetworking/AFNetworking.h'
s.prefix_header_contents = pch_AF
s.ios.deployment_target = ‘7.0'
end

注释:
s.name: 名称, pos.search时搜索的关键字, 需要注意的是这里的名称一定要和.podspec文件的名称要是一样的, 否则会报错哦
s.version: 当前的版本号
s.license: 开源协议
s.summary: 简介
s.description : 描述, 用于生成标签和提高搜索结果, 主要是类库的功能等, 尽量简短; 注意, 需要写在两个DESC中间
s.homepage: 项目主页的地址,
s.social_media_url: 社交地址
s.authors: 作者
s.requires_arc: 是否支持ARC
s.public_header_files: 项目的头文件
s.source: 项目地址
s.resources: 资源文件
s.dependency: 依赖库, 切记不能依赖未发布的库
# 依赖的系统框架
# s.framework = “SomeFramework”
# s.frameworks = "SomeFramework", “AnotherFramework"

#第三方依赖
s.dependency "Masonry", "~>0.6”
 如果有多个第三方库，就写多个 s.dependency

注释:
s.name: 名称, pos.search时搜索的关键字, 需要注意的是这里的名称一定要和.podspec文件的名称要是一样的, 否则会报错哦
s.version: 当前的版本号
s.license: 开源协议
s.summary: 简介
s.description : 描述, 用于生成标签和提高搜索结果, 主要是类库的功能等, 尽量简短; 注意, 需要写在两个DESC中间
s.homepage: 项目主页的地址,
s.social_media_url: 社交地址
s.authors: 作者
s.requires_arc: 是否支持ARC
s.public_header_files: 项目的头文件
s.source: 项目地址
s.resources: 资源文件
s.dependency: 依赖库, 切记不能依赖未发布的库
# 依赖的系统框架
# s.framework = “SomeFramework”
# s.frameworks = "SomeFramework", “AnotherFramework"

#第三方依赖
s.dependency "Masonry", "~>0.6”
 如果有多个第三方库，就写多个 s.dependency

注意点:

如果有多个依赖框架: 

 s.frameworks = "SomeFramework", “AnotherFramework"

如果有多个第三方依赖:  有多个第三方库，就写多个 s.dependency

s.dependency "Masonry", "~>0.6”

s.dependency "AFNetworking", "~>0.6”

s.dependency "YYKit", "~>0.6”

- 创建tag值

7.1, $ git add . 
7.2, $ git commit -m “0.0.1”
7.3, $ git tag 0.0.1
7.4, $ git push —tags
7.5, $ git push origin master

- 验证podspec文件是否配置正确

$ pod spec lint MOZI.podspec

> 注意点:

1, 如果终端中存在警告可以使用忽略警告的命令行: pod spec lint MOZI.podspec --allow-warnings

2, 如果验证不通过, 终端中会有详细的error, 根据提示来做就好了, 重新验证, 直到没有错误为止.

3, 如果通过验证, 终端中会有提示”通过验证的提示(passed validation)”

• 如果是第一次提交, 需要填写几个信息:

$ pod trunk register 这里写您的邮箱 '这里需要起个名字' --description=' 这里写一些描述’

eg: $ pod trunk register [e-mail] 'Alex' --description="I`m just a boy"完成之后, 会发一封邮件到您写的邮箱中, 点击链接即可.

完成之后, 会发一封邮件到您写的邮箱中, 点击链接即可.

提交到cocoapods:

$ pod trunk push MOZI.podspec --allow-warnings

(注意:由于我验证podspec文件时使用了--allow-warnings 所以这里后面也加上--allow-warnings)

- 通过终端去pod.search一下, 查看是否成功.

$ pod search MOZI

>  刚提交后项目用pod search命令会搜不到，因为本地的索引没有更新，使用下面命令删除索引文件, 删除之后再一次进行 pod search mozi

$ rm ~/Library/Caches/CocoaPods/search_index.json

```

- 删除search_index.json后再一次搜索

> 需要注意的几点:

1, 整个过程中最难的部分就是podspec文件的配置. 不懂的一般都是去github上看别人的podspec是怎么样配置的.

2, 在验证podspec文件是否配置正确的过程中, 如果有错, 终端会有提示你错在哪里, 根据提示来做就可以了.

3, s.source_files表示的是路径, 我在这里花费的时间相对其他地方多了一点.

4, podspec文件中写描述的时候, 不能有换行

总结

"不积跬步, 无以至千里", 希望每天都能进步一点. 多学习一些感兴趣的东西.