组件化最新CocoaPods私有库制作

前言

之前项目中的一些组件需要拆分开来，因为这些组件在不同的APP中都需要使用（比如：图片上传模块，工具类库等）。因此为了统一管理且不暴露核心的代码，我们决定借助CocoaPods建立私有仓库进行统一管理，也就是所说的组件化。组件化好处是分工更加明确，提高开发效率，复用性更好，能迅速的组成更多的APP。

制作私有库

1、创建私有仓库

这里我在coding上建立了一个私有仓库

https://git.coding.net/kitimy/QMiOSRepo.git

2、添加私有仓库到本地pod库

pod repo add QMiOSRepo https://git.coding.net/kitimy/QMiOSRepo.git

成功之后，我们可以查看一下：
open ~/.cocoapods/repos

在这里多了一个我们的私有库QMiOSRepo

3、创建工程QMKit的git私有仓库

https://git.coding.net/kitimy/QMKit.git

4、在本地建立pod工程

pod lib create QMKit

在创建的过程中会有一系列的询问：

What is your email?
What language do you want to use?? [ Swift / ObjC ]
Would you like to include a demo application with your library? [ Yes / No ]
Which testing frameworks will you use? [ Specta / Kiwi / None ]
Would you like to do view based testing? [ Yes / No ]
What is your class prefix?

完成一系列询问后，可以看到在当前目录多出了QMKit文件夹

5、编辑podspec文件
podspec 描述自己组件工程的代码目录和资源目录在哪，还有自己组件工程所依赖其他框架，到时候就会根据podspec的指引去引入自己的仓库代码。这里我们在QMKit目录可以看见一个名为QMKit.podspec的文件。

#
# Be sure to run `pod lib lint QMKit.podspec' to ensure this is a
# valid spec before submitting.
#
# Any lines starting with a # are optional, but their use is encouraged
# To learn more about a Podspec see http://guides.cocoapods.org/syntax/podspec.html
#
 // s代表索引库
Pod::Spec.new do |s|
  // 设置名称
  s.name             = 'QMKit'
  // 设置版本号
  s.version          = '0.1.0'
 // 设置摘要
  s.summary          = 'A short description of QMKit.'

# This description is used to generate tags and improve search results.
#   * Think: What does it do? Why did you write it? What is the focus?
#   * Try to keep it short, snappy and to the point.
#   * Write the description between the DESC delimiters below.
#   * Finally, don't worry about the indent, CocoaPods strips it!

  s.description      = <<-DESC
TODO: Add long description of the pod here.
                       DESC
   // 设置仓库主页
  s.homepage         = 'https://git.coding.net/kitimy/QMKit.git'
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  
  // 设置许可证，不能乱填，必须是有这样的协议
 s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'QinminiOS' => '544652424@qq.com' }

  // QMKit的git私有仓库地址
  s.source           = { :git => 'https://git.coding.net/kitimy/QMKit.git', :tag => s.version.to_s }
  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'

  s.ios.deployment_target = '8.0'
  // 设置 源文件路径
  s.source_files = 'QMKit/Classes/**/*'
  
  # s.resource_bundles = {
  #   'QMKit' => ['QMKit/Assets/*.png']
  # }

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

6、提交代码，并打tag

git add .
git commit -m "first commit"
git remote add origin https://git.coding.net/kitimy/QMKit.git
git push -u origin master
git tag 0.0.1
git push --tags

7、检测pod库是否可用

pod lib lint
如果有警告可以使用命令忽略：
pod lib lint --allow-warnings

• 如果遇到 [!] An unexpected version directory App.lproj was encountered for the etc... 这个类似的错误说明cocoapods版本比较低用gem install cocoapods --pre更新重试

• 如果遇到其他问题我们可以用pod lib lint --verbose查看编译错误并进行排查。

8、向QMiOSRepo提交QMKit.podspec

进入QMKit目录，执行以下命令

pod repo push QMiOSRepo QMKit.podspec

9、检测一下pod库是否可用

新建QMTest项目，编写Podfile文件，指定先查找我们的仓库QMiOSRepo.git

source 'https://git.coding.net/kitimy/QMiOSRepo.git'

platform:ios, '8.0'
target 'QMTest' do
pod 'QMKit', '~> 0.1.0'
end

• 如果出现这个错误： [!] An unexpected version directory Assets was encountered for the
  ~/.cocoapods/repos/QMiOSRepo Pod in the QMiOSRepo repository. 可能是私有仓库地址不对，也可能是向QMiOSRepo提交QMKit.podspec失败。

资源处理

如果组件中使用了资源，一定要把组件生成framework，不能生成静态库,否则资源拿不到。

• 在使用pod lib create创建的组件工程，会创建Assets文件夹，把图片、资源放这个目录。

• 然后podspec指定资源文件路径s.resource_bundles

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

• Podfile文件中添加描述use_frameworks!，作用是生成frameworks库。

use_frameworks!

source 'https://git.coding.net/kitimy/QMiOSRepo.git'

platform:ios, '8.0'
target 'QMTest' do
pod 'QMKit', '~> 0.1.1'
end

• 加载图片资源。资源最终会拷贝到QMKit.framework中的QMKit.bundlke中。

NSBundle *bundle = [NSBundle bundleForClass:[self class]];
NSString *path = [bundle pathForResource:@"QMKit.bundle/1.png" ofType:nil];
 _imageView.image = [UIImage imageWithContentsOfFile:path];

参考文章

http://guides.cocoapods.org/making/private-cocoapods.html