美文网首页
一步一步创建自己的CocoaPods库(一)

一步一步创建自己的CocoaPods库(一)

作者: StevenYung | 来源:发表于2018-03-01 10:18 被阅读0次

    记录一下自己第一次创建CocoaPods库的经历,以及遇到的一些问题,废话不多,干货满满

    1. 创建工程

    打开终端,cd到你要创建文件的位置,如:Documents/work/pod

    cd Documents/work/pod
    pod lib create SYPodTest
    
    pod创建过程.png

    第一次创建会问你几个问题

    • 第一个是问你使用什么平台开发 [iOS还是macOS],根据需要选择即可,这里选择iOS。
    • 第二个是问你使用什么开发语言 [Swift还是Objc],这里选择Objc。
    • 第三个问是否创建一个demo应用包含在工程里,根据需要,如果需要demo示例,选择Yes,否则No。
    • 第四个问是否需要测试Framework,这里选择None。
    • 第五个问是否需要做界面调试,这里选择No。
    • 最后一个问工程文件的前缀,根据需要,我这里使用SY前缀。
    创建完成后会在pod文件夹生成一个项目,里面包含了Demo和配置文件: image.png

    2. 编辑配置文件

    • podspec文件,即Pod Specification(Pod描述文件),描述指定版本的pod库信息,包括:pod库源码地址、文件列表、配置信息、描述信息等。具体可参考官方文档
    • README项目描述文件,这个文件可以使用Markdown语法,主要展示在GitHub工程上的首页。README文件对于使用这个pod库的人来说,有和没有这个文件,区别是很明显的
    • LICENSE要想是Spec仓库接收,就必须包含一个license。pod lib create 自动创建使用的是 MIT license。可以根据需要可以使用不同的License。

    这里主要修改podspec文件

    • s.name 项目名称,这里是SYPodTest
    • s.version版本号,0.0.11.0.0
    • s.summary对项目简单扼要的描述,比如功能,作用等
    • s.description对项目详细全面的介绍,写在<<-DESCDESC中间,不用注意缩进
    • s.homepage项目主页地址
    • s.license License类型和名称
    • s.author作者及联系邮箱
    • s.source源码地址
    • s.ios.deployment_target目标版本号
    • s.source_files代码路径
    • s.resource_bundles资源文件如图片等的路径,如果有将注释去掉
    • s.public_header_files公共头文件路径
    • s.frameworks依赖的Framework
    • s.dependency依赖的第三方库,如AFNetworking等,如果有第三方依赖,将注释去掉
      image.png

    3. 创建远程仓库

    image.png
    创建好后将本地代码提交到远程仓库
    git add .
    git commit -m "Initial Commit"
    

    添加远程仓库

    git remote add origin https://github.com/xxx/SYPodTest.git
    git push -u origin master
    
    到这里报错了 image.png

    按提示尝试

    git pull origin master
    

    还是有问题

    image.png
    报错原因是首次上传代码,本地分支和远程分支不一致,远程创建仓库的时候勾选了gitignore甚至可能还有License,导致不能合并,百度之,解决办法是,参考这里
    git pull --rebase origin master
    

    继续提交代码

    git push -u origin master
    

    pod验证

    pod lib lint SYPodTest.podspec
    

    到这里又报错了

    image.png
    Google之,还是StackOverflow好用,还有这里。这里插一句吐槽,论精准我只服Google,百度差评,搜半天,翻了好几个才找到答案的
    解决办法是:Xcode > Preferences > Locations选择Command Line Tools image.png
    继续刚才的操作,终于成功了
    pod lib lint SYPodTest.podspec
    
    image.png

    4. 提交Pod

    1. 打Tag

    git tag 0.1.0
    

    提交到远程仓库

    git push origin --tag
    

    2. 验证

    pod spec lint SYPodTest.podspec
    
     -> SYPodTest (0.1.0)
    
    Analyzed 1 podspec.
    
    SYPodTest.podspec passed validation.
    

    3. 提交pod到Specs仓库

    pod trunk push SYPodTest.podspec
    

    这里又报错了

    image.png
    意思是你需要注册一个session,参考这里
    pod trunk register 电子邮箱 '您的姓名' --description='description'
    

    继续刚才报错的步骤,成功了

    pod trunk push SYPodTest.podspec
    
    image.png

    5. pod search 检验是否可用

    pod search SYPodTest
    

    出现下面这个问题:

    [!] Unable to find a pod with name, author, summary, or description matching `SYPodTest`
    

    这主要是因为在本地索引里面没有, 解决办法

    1. pod setup (不行,实用方法二)
    2. pod repo update(不行,试用方法三)
    3. 前往这个路径下~/Library/Caches/CocoaPods删除search_index.json文件 , 或者使用终端命令删除:
    rm ~/Library/Caches/CocoaPods/search_index.json
    

    完成后,重新搜索
    到这里,自己的CocoaPods仓库终于创建完成!

    参考文章

    https://www.jianshu.com/p/41611b14942b

    相关文章

      网友评论

          本文标题:一步一步创建自己的CocoaPods库(一)

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