iOS 组件化开发实践

一、 对组件的理解

组件是由一个或多个类构成，能完整描述一个业务场景，并能被其他业务场景复用的功能单位。组件就像是PC时代个人组装电脑时购买的一个个部件，比如内存，硬盘，CPU，显示器等，拿出其中任何一个部件都能被其他的PC所使用。

所以组件可以是个广义上的概念，并不一定是页面跳转，还可以是其他不具备UI属性的服务提供者，比如日志服务，内存管理服务等等。说白了我们目标是站在更高的维度去封装功能单元。对这些功能单元进行进一步的分类，才能在具体的业务场景下做更合理的设计。

组件化开发，就是将一个臃肿，复杂的单一工程的项目, 根据功能或者属性进行分解，拆分成为各个独立的功能模块或者组件 ; 然后根据项目和业务的需求，按照某种方式, 任意组织成一个拥有完整业务逻辑的工程。

它的优点

• 项目结构清晰
• 代码逻辑清晰
• 快速集成
• 代码复用率高
• 迭代效率高

二、 创建私有库流程

1. 创建私有组件 -- 相当于是从github上下载组件模板

pod lib create XYImageDetail

在创建的过程中需要配置一些参数

------------------------------

To get you started we need to ask a few questions, this should only take a minute.

If this is your first time we recommend running through with the guide: 
 - https://guides.cocoapods.org/making/using-pod-lib-create.html
 ( hold cmd and double click links to open in a browser. )


What platform do you want to use?? [ iOS / macOS ]
 > iOS

What language do you want to use?? [ Swift / ObjC ]
 > ObjC

Would you like to include a demo application with your library? [ Yes / No ]
 > No

Which testing frameworks will you use? [ Specta / Kiwi / None ]
 > None

Would you like to do view based testing? [ Yes / No ]
 > Yes
 Putting demo application back in, you cannot do view tests without a host application.

What is your class prefix?
 > XY

根据提示即会生成pod工程模板（如下图所示）

image.png

代码文件放在目录"/XYImageDetail/XYImageDetail/Classes/"中

2.编辑podspec文件

两种打开方式：
第一种是cd到工程根目录vim XYImageDetail.podspec；
第二种是Xcode 打开Example，在第个文件夹Podspec Metadata中可以直接编辑

Pod::Spec.new do |s|
  s.name             = 'XYImageDetail'
  s.version          = '0.1.0'
  s.summary          = '简短描述:图片浏览器'

# 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://github.com/周述坚/XYImageDetail'   #  这个链接是需要可以访问的链接
  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
  s.license          = { :type => 'MIT', :file => 'LICENSE' }
  s.author           = { '周述坚' => '[email protected]' }
  s.source           = { :git => 'https://github.com/周述坚/XYImageDetail.git', :tag => s.version.to_s }
  # s.social_media_url = 'https://twitter.com/'

  s.ios.deployment_target = '9.0'
  #  下面这是资源路径
  s.source_files = 'XYImageDetail/Classes/**/*'
  
  # s.resource_bundles = {
  #   'XYImageDetail' => ['XYImageDetail/Assets/*.png']
  # }

  # s.public_header_files = 'Pod/Classes/**/*.h'
  #  下面是添加依赖库
  # s.frameworks = 'UIKit', 'MapKit'
  # s.dependency 'AFNetworking', '~> 2.3'
end

3. 创建远程代码仓库

由于在创建私有库的时候，就已经创建了.git文件，创建完远程代码仓库后，与本地创建的私有库相关联。

git remote add origin http://github.com/zhoushujian/xyimagedetail.git
git add .
git commit -m "Initial commit"
git push origin master

此时代码就已经传到远程代码仓库。

4. 给私有库打tag

git tag '0.1.0'
git push --tags

这里需要注意的是tag的版本号需要与XYImageDetail.podspec中的s.version = '0.1.0'保持一致。

5. 创建远程索引库

在git上创建一个远程仓库来作为pod的索引库，来存放.podspec文件，可以是私有的也可以是公开的
创建完之后 会有一个远程仓库地址例如：

https://github.com/zhoushujian/XYSpecs.git

查看本地索引库

pod repo

添加自己的本地索引库,并关联创建好的远程git仓库

pod repo add XYImagedetail https://github.com/zhoushujian/XYSpecs.git

在push 之前首先验证一下本地的.podspec文件，如果验证不通过，是上传不了的。

pod lib lint --allow-warnings  // 本地验证
pod spec lint  --allow-warnings // 远程验证

把本地.podspec文件push到远程索引库

pod repo push XYImageDetail XYImageDetail.podspec // 如果有警告无法通过，可以在后面加--allow-warnings 

至此，私有库创建完成

注意：在后期对组件进行迭代更新的时候，注意要给私有库打tag。否则在pod的时候，依然是旧版本。另外，如果在本机pod install时，提示上传的组件未找到，可以尝试pod repo update 命令。再进行pod install。