创建cocoapods 开源库

作者: YLeaves | 来源:发表于2018-12-04 16:25 被阅读11次

    近来有些时间便整理了下创建cocoapods 开源库的流程。
    因为懒,所以写的就比较简洁。

    注册CocoaPods账号

    需要一个CocoaPods账号来发布更新代码库

    • 查看账号信息

      pod trunk me
      

      输出结果:
      若未注册则进行下面注册操作,已注册的可以跳至主要步骤。


      未注册.png
      已注册.png
    • 注册命令

      pod trunk register 邮箱地址 ‘用户名’ —description='描述信息'
      

      打开注册邮箱点击验证链接打开网页,如果出现下面的提示说明注册成功。


      注册成功.png

    主要步骤

    • 在Github上传相关的代码库
    • 添加库文件并构建项目发布版Tag
    • 创建podspec配置文件
    • 验证配置文件是否可用
    • trunk push 代码到 CocoaPods
    • 检索已上传的库

    1.在Github上新建仓库并添加MIT License(许可证/授权)文件。

    创建git仓库.png

    2.克隆项目至本地,添加库文件、编辑README.md,然后点击release构建项目发布tag或使用命令。(注:后面配置文件需要设置一致)

    git tag '0.0.1'git push --tags
    
    构建发布tag.png
    3.创建podspec配置文件。
    打开终端进入项目目录执行创建podspec命令:
    pod spec create 库名称 // pod spec create YCSegmentView
    
    目录结构.png
    编辑podspec配置文件,可参考官网文档
    简单介绍:
    s.name:名称 //需要和.podspec的名称一样,否则验证报错
    s.version:版本号//需要和构建的tag版本一致,否则上传cocopods报错
    s.ios.deployment_target:支持的pod最低版本
    s.summary: 简介
    s.description:描述//内容换行编辑,接着DESC写验证不通过
    s.homepage:项目主页地址//这里要填写可以访问到的地址,不然验证不通过
    s.license:开源协议// { :type => "MIT", :file => "LICENSE" }
    s.author:作者信息
    s.social_media_url:社交网址
    s.source:项目的地址//这里不支持ssh的地址,验证不通过,只支持HTTP和HTTPS,最好使用HTTPS
    s.social_media_url:多媒体介绍地址
    s.platform:支持的平台及版本
    s.source_files:需要包含的源文件
    s.public_header_files:公开头文件地址
    s.resources: 资源文件
    s.requires_arc: 是否支持ARC
    s.frameworks:所需的framework//多个用逗号隔开
    s.dependency:依赖库//该项目所依赖的其他库,如果有多个需要填写多个s.dependency
    

    参考配置

    Pod::Spec.new do |s|
        s.name         = "YCSegmentView"
        s.version      = "0.0.1"
        s.summary      = "Padging controller"
        s.description  = <<-DESC
        Conveniently create pagination effects
                        DESC
        s.homepage     = "https://github.com/YLeaves/YCSegmentView"
        s.license      = { :type => "MIT", :file => "LICENSE" }
        s.author             = { "YLeaves" => "619837152@qq.com" }
        s.platform     = :ios, "7.0"
        s.source       = { :git => "https://github.com/YLeaves/YCSegmentView.git", :tag => "#{s.version}" }
        s.source_files  = "YCSegmentView/*.{h,m}" 
    end
    

    4.验证配置文件
    执行以下命令:

    pod lib lint 配置文件//pod lib lint YCSegmentView.podspec
    

    若出现ERROR提示,对应修改配置文件内容。
    若只有WARN输出,可以将这些警告忽略,忽略警告命令:

    pod lib lint 配置文件 —allow-warnings//pod lib lint YCSegmentView.podspec —allow-warnings
    

    当显示 xxx passed validation 时表示验证通过


    验证通过.png

    5.push 代码到 CocoaPods
    执行以下命令:

    pod trunk push 配置文件//pod trunk push YCSegmentView.podspec
    

    上传成功如下所示

    上传成功.png
    6.检索已上传的库
    通过以下命令检索已上传的库
    pod search 库名//pod search YCSegmentView
    

    若检索不出可以清除缓存检索目录。

    rm ~/Library/Caches/CocoaPods/search_index.json
    
    结语

    以上就是发布开源库至cocopods的流程。后续若更新库功能,需重新构建发布tag和配置文件的s.version版本。然后再执行trunk push 更新cocopods库即可。

    At last

    YCSegmentView 是基于UIPageViewController实现的分页视图
    通过UIPageViewController懒加载控制器视图进行代码解耦,避免一次性渲染所有子视图。欢迎download下载提意见,Star,感谢阅读。

    相关文章

      网友评论

        本文标题:创建cocoapods 开源库

        本文链接:https://www.haomeiwen.com/subject/njxmcqtx.html