组件化开发之创建CocoaPod

组件化的架构设计,是将每个模块作为一个组件.每个组件都当做一个独立工程,并建立主项目来集成所有组件.集成方式是在主项目中通过CocoaPods来集成,将所有组件当做第三方库集成到项目中.

创建Pod库文件

• 使用命令创建本地Pod库
  输入 -pod lib create XMLYMain- 命令后,会询问语言类型\是否创建Demo等信息,依次输入最终会创建一个如下图所示的文件目录.

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

文件目录结构.png

创建过程中没有提示我输入author等信息,应该是我之前已经在MBP上配置过github账号的原因

文件作用

• license 文件
  CocoaPods 强制要求所有的 Pod 依赖库都必须有 license 文件,否则验证不会通过.这里一般是MIT类型的license.

• Example
  刚才创建的时候Would you like to include a demo application with your library?选择了Yes.这个文件就是命令帮我们创建的Demo工程文件.用来向其他使用者展示该Pod的使用.

• XMLYMain
  与创建的Pod库同名,里面有两个文件夹Assets和Classes

  • Assets - 存放Pod库中所需的资源文件(如.png .plist)
  • Classes - 存放Pod库的实例类

• XMLYMain.podspec
  .podspec 是Pod库的配置文件,其中属性已经自动生成.我们需要注意的是s.version,以后每次对Pod库的修改都需要修改version,并创建提交修改的tag.

Pod::Spec.new do |s|
  s.name             = 'XMLYMain'
  s.version          = '0.1.0'
  s.summary          = 'XMLYMain'

  s.description      = <<-DESC
'XMLYMain':项目的主要框架
                       DESC

  s.homepage         = 'https://github.com/caiiiac/XMLYMain'
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { 'caiiiac' => 'caiiiac@163.com' }
  s.source           = { :git => 'https://github.com/caiiiac/XMLYMain.git', :tag => s.version.to_s }
  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'

  s.ios.deployment_target = '8.0'

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

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

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

• 验证的时候可能会遇到的问题 - WARN | summary: The summary is not meaningful.
  请参照上面修改.podspec文件里的s.summary和s.description字段

提交Pod到github

• 关联github
  首先在github上创建同名项目,cd命令进入本地XMLYMain目录

cd XMLYMain
git remote add origin https://github.com/caiiiac/XMLYMain.git
git push -u origin master

WX20170717-164105@2x.png

• 添加文件并设tag
  将自己开发的.h .m文件保存到XMLYMain -> Classes目录中
  将需要的资源文件保存到XMLYMain -> Assets目录中

git add .
git commit -m "0.1.0 init"
git push origin master
git tag '0.1.0'
git push --tags

• 验证Pod
  pod lib lint
  如果一切正常就会输出

-> XMLYMain (0.1.0)
XMLYMain passed validation.

部署Pod

这里我们将会使用到Trunk,CocoaPods 使用 trunk 服务让我们来提交 Pod.

• 注册Trunk
  pod trunk register caiiiac@163.com 'caiiiac' --description='trunk with MacBook Pro' --verbose
  注意将邮箱 - 名字 - 描述文字改成自己的

稍候CocoaPods 会给你的邮箱发送验证链接,验证成功后，可以用 pod trunk me 命令查看自己的注册信息

• 部署Pod
  通过pod trunk push XMLYMain.podspec命令部署你的Pod
  注意将podspec的文件换成你自己的文件名,成功后会出现提示信息

 🎉  Congrats

 🚀  XMLYMain (0.1.0) successfully published
 📅  July 17th, 03:53
 🌎  https://cocoapods.org/pods/XMLYMain
 👍  Tell your friends!

搜索你的Pod

• 运行 pod reop update 来更新本地索引库
• 使用 pod search XMLYMain 命令来查找你刚刚部署成功的Pod

如果还是搜索不到,提示Unable to find a pod with name, author, summary, or description matching XMLYMain

• 解决方法: 前往缓存目录/Users/你的目录名/Library/Caches/CocoaPods 删除search_index.json文件,当你再次pod search的时候会重新生成.