Swift开源框架发布到CocoaPods

iOS开发中大多使用CocoaPods进行第三方框架的管理,关于如何使用CocoaPods我们就不多说了,今天主要介绍如何把自己写的库文件支持CocoaPods让更多的开发者发现和使用。

下面以我自己用Swift实现下拉刷新,上滑加载更多的框架https://github.com/Lves/LLRefresh为例,介绍如何使它支持CocoaPods

一、 先创建一个iOS项目

先创建一个Single View Application项目,命名LLRefreshDemo,主要用于测试我们的框架。

《Swift开源框架发布到CocoaPods》 cocoapods01.png

二、 创建Target

我们接下来要给项目创建一个target,选择Cocoa Touch Framework,我们自己的框架代码全部放在新建的target中。

  • 选中项目,File ->new -> Target

《Swift开源框架发布到CocoaPods》 cocoapods02.png

  • 选择Framework&Library中的Cocoa Touch Framework然后给自己框架起个名字(注意:起名字前可以到Cocoapods上搜索有没有,和别人的框架重名就不好了),这里我们命名为LLRefresh

《Swift开源框架发布到CocoaPods》 cocoapods03.png

  • 创建完成后就会,点击项目在target中就可以看到类似如下结构,现在就可以在LLRefreshDemo中引入Module

    import LLRefresh
    

《Swift开源框架发布到CocoaPods》 cocoapods04.png

  • 创建完就可以在新建的target中进行Swift开发了,有几个注意点

    • 如何想让外部使用、继承的或者StructEnum要加上open 或者 public关键字,否则外部调用将找不到。

    • 外部公开的函数也要添加 openpublic关键字

    • 库写好后,先运行新建的LLRefreshTarget,然后在demo编写测试,demo运行通过后就可以准备发布到Cocoapods

《Swift开源框架发布到CocoaPods》 cocoapods05.png

三、创建.podspec描述文件

在项目根目录创建LXLRefresh.podspec文件,这里的文件名就是你要发布到cocoapods上的名字,供他人搜索、安装(因为LLRefresh有人使用,所以我们的库采用LXLRefresh)。创建命令如下:

1. 创建Podspec描述文件
pod spec create LXLRefresh

创建完成后,项目目录结构如下:

《Swift开源框架发布到CocoaPods》 cocoapods06.png

2. 修改描述文件

我的描述文件如下,仅供参考。你也可以到Github上搜索著名的框架,看看他们怎么写的。

《Swift开源框架发布到CocoaPods》 cocoapods07.png

  • s.name 是我们库的名称
  • s.module_name 是用户使用时引用的module名,如果库名和module名相同可省略。
  • s.version 是库原代码版本号,这里的version要和github上的tag名相同,如何打tag我们第四部介绍
  • s.summary 是对我们库的一个简单的介绍
  • s.homepage 声明库的主页
  • s.license 是所采用的授权版本
  • s.author 是库的作者
  • s.platform 是我们库所支持的软件平台,这在我们最后提交进行编译 时有用
  • s.source 声明原代码的地址。我这里是托管在github上,所以这里将地址copy过来就行了。
  • s.source_file 是库包含的源文件目录
  • s.resource 是资源文件,例如图片,音视频等

四、 添加tag

我们在上一步填写的s.version就是gittag版本号。给库添加tag只需要两部,在命令行一次执行。

git tag '0.0.1'
git push --tag

五、 发布到coacoapods

终于到了最后一步了,如果你没有注册过Trunk账号,先注册一个账号才能发布,如何注册过跳过第一步。

  • 打开命令行,进入项目根目录。
pod trunk register '邮箱' '用户名' --description='描述'
  • 验证有效性
pod spec lint PodName.podspec
  • 发布到pod trunk
pod trunk push PodName.podspec --allow-warnings

命令行看到类似如下输出,说明已经成功了。现在可以去建个demo,使用cocoapods安装自己的库测试一下了。

《Swift开源框架发布到CocoaPods》 cocoapods08.png

恭喜你,到此说明你真的读完了。欢迎大家https://github.com/Lves/LLRefresh帮忙给star一下🙏🙏🙏。

最新文章第一时间发布在微信公众号:乐Coding。关注请微信搜索公众号:lecoding或者乐Coding,或者扫描下方二维码关注。

《Swift开源框架发布到CocoaPods》 lecoding icon.jpg

    原文作者:LvesLi
    原文地址: https://www.jianshu.com/p/d4a018949f55
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞