iOS高级技术

组件化之二 使用Cocoapods创建私有podspec

2017-05-12  本文已影响104人  大猿媛

组件化之一 frameWork

前言

Cocoapods是非常好用的一个iOS依赖管理工具,使用它可以方便的管理和更新项目中所使用到的第三方库,以及将自己的项目中的公共组件交由它去管理。实际开发中,像组件化之一中讲的一样,大型项目中有很多公共化组件可以做成私有化库,独立于项目工程,减少耦合和维护成本

整体先说明一下创建一个私有的podspec包括如下那么几个步骤:

  1. 创建并设置一个私有的Spec Repo,事先创建好该私有的Spec Repo的仓库。
  2. 创建Pod所需要的项目工程文件,并且有可访问的项目版本控制地址。
  3. 创建Pod所对应的podspec文件。
  4. 本地测试配置好的podspec文件是否可用。
  5. 向私有的Spec Repo中提交podspec。
  6. 在个人项目中的Podfile中增加刚刚制作的好的Pod并使用。
    更新维护podspec。

版本控制这里用git,个人没有私有账户,所以过程中创建的都是public项目

1、创建一个spec仓库,作为私有化Spec Repo的远端地址,先来说第一步,什么是Spec Repo?它是所有的Pods的一个索引,就是一个容器,所有公开的Pods都在这个里面,它实际是一个Git仓库remote端在GitHub上
屏幕快照 2017-05-11 下午8.01.57.png

创建私有化Spec Repo,进入.cocoaPods文件你会看到创建的结果

# pod repo add [Private Repo Name] [GitHub HTTPS clone URL]
$ pod repo add WSPodTestSpec https://github.com/Anny-github/WSPodTestSpec.git
屏幕快照 2017-05-11 下午8.07.18.png
屏幕快照 2017-05-11 下午8.10.40.png
创建Pod工程

1、如果你已经有了一个git上的项目,就不用进行这一步了,如果没有,先cd到目标文件夹,再z执行pod lib create podTestLibrary
之后他会问你四个问题,1.是否需要一个例子工程;2.选择一个测试框架;3.是否基于View测试;4.类的前缀;4个问题的具体介绍可以去看官方文档,我这里选择的是1.yes;2.Specta/Expecta;3.yes;4.PTL。 问完这4个问题他会自动执行pod install命令创建项目并生成依赖。


屏幕快照 2017-05-11 下午8.25.20.png

以上是项目生成的目录结构及相关介绍。

2、完善项目文件
接下来就是向Pod文件夹中添加库文件和资源,并配置podspec文件,我把自己写的两个类放入Pod/Classes中,然后进入Example文件夹执行pod update命令,再打开项目工程可以看到,刚刚添加的组件已经在Pods子工程下Development Pods/LoadingViewLibrary中了


屏幕快照 2017-05-11 下午8.31.34.png

可以看到,pods中的LoadingViewLibrary的Classes中已经添加好了文件,现在要把修改push到远端,这个时候,我们发现还没有对应的git仓库,所以上面创建仓库一样,再创建一个pod文件的仓库,LoadingViewLibrary


屏幕快照 2017-05-12 上午9.18.21.png 如此一来,就可以把本地的LoadingViewLibrary推到远端了
git add .
git commit -m "initial Pod"
git remote add origin https://github.com/Anny-github/LoadingViewLibrary.git
git push origin master  //如果失败rejected,使用git push -f origin master 强制push

注:这里需要注意的是每当你向Pod中添加了新的文件或者以后更新了podspec的版本都需要重新执行一遍pod update命令。

因为podspec文件中获取Git版本控制的项目还需要tag号,所以我们要打上一个tag,并推送tag到远端。

git tag 0.0.1
git push --tags
修改并验证podspec文件

podspec文件将lib中用到的包括资源、源码、需要引用的framework,以及第三库等等组织起来,是我们创建私有Pod的重要文件

1、接下来开始编辑podspec文件了,它是一个Ruby的文件,把编辑器的格式改成Ruby就能看到语法高亮,下面我贴上我的podspec文件,并在后面以注释的形式说明每个字段的含义,没有涉及到的字段可以去官方文档查阅

Pod::Spec.new do |s|
  s.name             = 'LoadingViewLibrary'
  s.version          = '0.0.1'
  s.summary          = 'test for private pod.'
  s.description      = <<-DESC
       test private pod,this is a class used to loading view
                       DESC

  s.homepage         = 'https://baidu.com'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'Anny-github' => 'wenshanshan1991@163.con' }
  s.source           = { :git => 'https://github.com/Anny-github/LoadingViewLibrary.git', :tag => '0.0.1'}
  s.ios.deployment_target = '8.0'

  s.source_files = 'LoadingViewLibrary/Classes/**/*'

  # s.resource_bundles = {
  #   'LoadingViewLibrary' => ['LoadingViewLibrary/Assets/*.png']
  # }

  s.public_header_files = 'LoadingViewLibrary/Classes/**/*.h'
  s.frameworks = 'UIKit'
  # s.dependency 'AFNetworking', '~> 2.3'
end

2、编辑完podspec文件后,需要对其进行验证,如果有任何WARNING或者ERROR都是不可以的,它就不能被添加到Spec Repo中,不过xcode的WARNING是可以存在的,验证需要执行一下命令,两个任选一个都可以

pod lib lint                    //不予许警告和错误
pod lib lint --allow-warnings   //允许警告

可能会遇到的问题,提示会将有错误的用>指出来,一般会有标点等格式错误,最重要的是s.source_files和source不能搞错


屏幕快照 2017-05-12 上午9.35.56.png

验证通过是这个样子的:


屏幕快照 2017-05-12 上午9.39.21.png 现在只能ssh说明个podspec符合验证,但是不一定能使用。
本地创建xcode工程TestPodSpec,测试创建的pod能否可用

1、创建Podfile文件,链接本地pod地址,可以通过Finder的前往,查看这个地址是否存在,能找到证明链接地址没错


屏幕快照 2017-05-12 上午9.44.30.png
platform :ios,'8.0'
target 'TestPodSpec' do
pod 'LoadingViewLibrary' , :podspec => '/Users/Hammer/Desktop/LoadingViewLibrary/LoadingViewLibrary.podspec'
inhibit_all_warnings!
end

2、保存好Podfile后,pod install,下面是成功了


屏幕快照 2017-05-12 上午9.48.25.png

打开TestPodSpec.xcworkspace,查看Pods目录下,是否install好了本地的私有库LoadingViewLibrary


屏幕快照 2017-05-12 上午9.48.09.png
看到上面,就证明安装成功,运行demo测试一下。
提交本地podspec到Specs仓库

向Spec Repo提交podspec需要完成两点一个是podspec必须通过验证无误,在一个就是删掉无用的注释(这个不是必须的,为了规范还是删掉吧)。 向我们的私有Spec Repo提交podspec只需要一个命令

pod repo push  WSPodTestSpec LoadingViewLibrary.podspec

至此,我们的私有podspec已经创建完成,这个时候就可以像pod search AFNetworking一样,搜索自己的podspec库了,死不死挺过瘾😁


屏幕快照 2017-05-12 上午9.58.47.png
问题小结

1、执行pod lib create (组件库) 出错

提示错误:rubygems/core_ext/kernel_require.rb:120:in `require': cannot load such file -- colored2  
         (LoadError)

 解决办法:
     输入上面提示的colored2的两条gem命令即可解决问题
   sudo gem install colored2
   sudo gem update --system

2、添加组件库到私有spec repo仓库后 执行 pod search搜索不到。

方法一:
        先确认你本地仓库上面确实有你新创建的组件库,这时候可以先删除search缓存文件
    rm ~/Library/Caches/CocoaPods/search_index.json
    ,删除后从新执行pod search ***

    方法二:
    1.切换到某个项目(含有podfile文件)下
    2.执行pod update(提示不能更新)
    3.尝试 pod repo update —verbose获取详细信息,我记得是提示我删除一个 index.lock文件,
4.删除后从新 执行  pod repo update —verbose  会更新本地私有库和master仓库
5.执行pod search ***   创建search索引,可以搜到

3、提交本地podspec到Specs仓库的时候出错,提示repo 文件夹下的spec repo is not clean

方法一: cd到spec repo 文件夹下,执行 git  clean -f
方法二:cd到spec repo 文件夹下,执行  git  stash

2.其他关于pod的问题:
Cocoapods环境配置 :http://blog.csdn.net/cbl643966855/article/details/51120497Cocoapods使用私有库遇到的坑:http://www.jianshu.com/p/1e5927eeb341http://blog.csdn.net/andanlan/article/details/50515434Cocoapods安装或更新出错:http://blog.csdn.net/lindir/article/details/52980526Cocoapods search无法搜索:http://blog.csdn.net/yuanmengong886/article/details/57083919

上一篇下一篇

猜你喜欢

热点阅读