iOS 玩转CocoaPods

wongstar
897 阅读5分钟

####导语：

有时候看到其他人 source开源时候用pod xxx 配置在你的Podfile文件中，执行下pod install 或者 pod update ，代码瞬间就到你的pod库, 顿时觉得高大上。那是怎么做到的呢？

Agenda:

  • CocoaPods 的由来
  • Github 使用
  • PodSpec介绍
  • PodSpec上传
  • 遇到的坑及解决方案

###一,CocoaPods 的由来 Android app目前通过gradle来管理和配置你的source,比如需要用到Eventbus只要在build.gradle中配置下

dependencies {
    compile 'org.greenrobot:eventbus:3.0.0'
}

iOS必须要有类似的神器啊：CocoaPod就是这把神器. 在CocoaPod没出来之前iOS要用引用第三库的做法如下： 比如引用AFNetWorking库，需要去下载源码，然后需要配置对应的编译环境等。当AFNetWorking库升级，所有过程又来一遍。过程太过复杂啦。 CocoaPods因上面的原因应运而生，它目前是iOS最有名的类库管理工具了，通过cocoaPods，只需要一行命令就可以完全解决，当然前提是你必须正确设置它。目前绝大部分有名的开源类库，都支持CocoaPods。所以，作为iOS程序员的我们，掌握CocoaPods的使用是必不可少的基本技能了。

如果你mac上没有安装pod ， sudo gem install cocoapods 具体怎么安装可以参考如下链接： http://www.jianshu.com/p/9e4e36ba8574

开发iOS应用用到pod 的主要命令如下：

pod help-->查看pod命令的帮助
pod search --> Search for pods（搜索pod）
pod trunk   -->   Interact with the CocoaPods API (e.g. publishing new specs) 上传source到trunk
pod spec     -->     Manage pod specs//管理pod spec
pod install  -->Install project dependencies according to versions from a  Podfile.lock //安装项目中的依赖项目
pod update -->Update outdated project dependencies and create new Podfile.lock//跟新依赖项目并且更新Podfile.lock
pod init -->Generate a Podfile for the current directory//创建pod file文件

其中Podfile.lock的扮演的角色非常重要，具体作用可以参考如下链接 http://m.blog.csdn.net/muzhenhua/article/details/45174071

####二，Github 使用 为嘛要介绍GitHub呢？CocoaPods只是做为项目的具体管理者，podspec文件就放在cocoapod官网上，供大家搜索。但是实际源码则是存储在Github上，那怎么使用Github就非常关键啦。

  • 创建项目 登录你的Github,然后去创建一个新的仓库，如下图创建GKFramework参考

    image.png

  • 上传项目 下载该仓库，通过git clone 。clone一个仓库下来 怎么clone如下图clone with https.

    image.png

在终端输入

//git clone后面的是你对应的git 地址
git clone https://github.com/wongstar/GKFramework.git

然后在这个仓库中修改或者添加你需要对应类或者文件等。

然后通过下面命令

//add 所有的到仓库
git add *
//提交commit信息
git commit
//提交本地到远端
git push origin master
  • 打tag tag是后续spec中需要用到，以后升级至需要升级对应tag.
//获取当前有多少tag
git tag
//创建tag 0.0.1版本
git tag 0.0.1
  • update tag到Github上 上传tag到Github服务器上，这个比较简单
 git  push origin 0.0.1
  • 查看tag 如下图所示 ：点击branch 然后查看Tags栏目
    image.png

至此源码已经上传到Github服务器上去了，但是Pod服务器上目前还没有对应的描述，下面接着介绍PodSpec,以及如何上传到cocoapod服务器上去. ####三,PodSpec介绍

在mac 上创建一个podspec,在Terminal终端上输入下面命令：

//注GKFramework.podspec是你的框架名称
pod spec create GKFramework.podspec

然后编辑podspec文件。如下GKFramework.podspec

Pod::Spec.new do |s|
  s.name         = "GKFramework" //定义名称
  s.version      = "0.0.5" //tag版本
  s.summary      = "A Sample.so you can use it" //简介,以后search到简介
  s.description  = <<-DESC
                   this is gk framework, use it for test your framework. we can use it as framework.
                   DESC
//s.description 定义具体的描述
  s.homepage     = "https://github.com/wongstar/GKFramework"
  s.license      = { :type => "MIT", :file => "LICENSE" }//具体license
  s.author             = { "wongstar" => "wongstar.iac@gmail.com" }
  s.platform     = :ios, "8.0"//build的平台
  s.ios.deployment_target = "7.0"//最低开发

  s.source       = { :git => "https://github.com/wongstar/GKFramework.git", :tag => "#{s.version}" }
  s.source_files  = 'Classes/**/*'
  #s.public_header_files='GKFramework/Classes/**/*.h'



end


 s.description  = <<-DESC
                   this is gk framework, use it for test your framework. we can use it as framework.
                   DESC
s.description定义了描述该pod是用来做什么的。注意这里的写法

s.description格式要求必须是下面的这样描述 <<-DESC 这里面你定义的描述.必须用这个格式 DESC

  s.source       = { :git => "https://github.com/wongstar/GKFramework.git", :tag => "#{s.version}" }

必须定义s.source，git链接必须是你上传过的source, tag定义为你在github上对source打的tag.

s.source_files  = 'Classes/**/*' 定义为：Classes目录下的所有文件

s.dependency：依赖库，不能依赖未发布的库
eg: s.dependency  = 'AFNetworking'

####四,PodSpec上传

  • 在 cocoapods 注册
//email代表你的email，username代表你的用户名
 pod trunk register email "username"

执行完上面的命令，你的邮箱会收到一封确认信，点击确认验证一下就ok啦。

  • 判断podspec正确行？
//GKFramework.podspec为你对应的podspec文件
pod  spec lint GKFramework.podspec

如果是正确的spec会出现下面的提示：

image.png

  • 上传到cocoapod服务器
//注：GKFramework.podspec为你对应spec的名称
pod trunk push GKFramework.podspec

上传成功如下图所示：

image.png

  • search 你的库. 网址为：https://cocoapods.org/ 如图五：search GKFramework
    图五.png
    ####五,遇到的坑及解决方案
  • source file没找到 [iOS] file patterns: The source_files pattern did not match any file. 确保你的source file是否配置正确，如你的spec目录和source对应的关系
  • cocoapods环境问题 unknown: Encountered an unknown error (Simulator iPhone 4s is not available.) during validation 执行下面命令
sudo gem install cocoapods --pre

如果执行上面的有问题出现 ERROR: While executing gem ... (Errno::EPERM) Operation not permitted - /usr/bin/xcodeproj 执行下面命令

sudo gem install -n /usr/local/bin cocoapods
  • Swift 版本问题 [!] The validator for Swift projects uses Swift 3.0 by default, if you are using a different version of swift you can use a .swift-version file to set the version for your Pod. For example to use Swift 2.3, run:
echo "2.3" > .swift-version.

验证失败，会出现一系列错误，但也不是无根可寻，其中出现错误频率最多的提示是

  • source files没找到 ERROR | [iOS] file patterns: The source_files pattern did not match any file.

此错误的原因是没有找到匹配的文件。

解决方案： 手动创建文件，具体操作方法如下 终端输入： open /Users/icepoint/Library/Caches/CocoaPods/Pods/External/GKFramework/035cb9aa62b9d49f904fad1119b83da4-aebfe 进入相应文件夹，创建文件夹与source_files文件路径对应 GKFramework/GKFramework/Classes 文件结构如下： GKFramework └── 035cb9aa62b9d49f904fad1119b83da4-aebfe
├── GKFramework │ └── GKFramework │ └──Classes └── LICENSE #开源协议 默认MIT

Classes文件夹存放自己的库文件

  • pod search GKFramework 搜索不到 Unable to find a pod with name, author, summary, or description matching GKFramework. 解决办法： 1.pod install --repo-update 2.或者全部删除:使用命令:rm ~/Library/Caches/CocoaPods/search_index.json 重新search GKFramework
avatar
文章
阅读
粉丝