一、 对组件的理解
组件是由一个或多个类构成,能完整描述一个业务场景,并能被其他业务场景复用的功能单位。组件就像是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工程模板(如下图所示)
代码文件放在目录"/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 = { '周述坚' => '394002732@qq.com' }
s.source = { :git => 'https://github.com/周述坚/XYImageDetail.git', :tag => s.version.to_s }
# s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
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。