最近在学习组件化。
组件化有一个方案是利用cocoapods进行管理组件。
这就涉及到了specs私有库的创建、维护和使用。
1. 开启显示隐藏文件
为了方便查看某些文件是否完成
//打开隐藏的命令:
defaults write com.apple.finder AppleShowAllFiles -bool true
//关闭隐藏的命令:
defaults write com.apple.finder AppleShowAllFiles -bool false
2. 创建远程组件索引库
该库包含了所有组件的索引以及版本信息。
命名最好以Specs结尾,我采用了coding的免费私有库。
3. 创建本地组件索引库
终端输入:pod repo add REPO_NAME SOURCE_URL
REPO_NAME:仓库名字,最好和远程索引仓库保持一致,
SOURCE_URL:为仓库地址。
回车后,Finder利用~/.cocoapods/repo查看,可以看到系统已经为我们创建好了文件夹和基本配置。
4. 创建 lib
4.1创建远程代码库
4.2 本地创建项目,将库文件引入工程, 关联远端的库.
终端输入:pod lib create REPO_NAME
4.3 将库文件引入工程,
完成后,将你的代码库代替Classes里的ReplaceMe.m
终端进入Example文件夹
pod install
可以看到项目中已经导入添加在Classes里的代码
4.4 将本地 lib 关联到远端库
git add .
git commit -m "first commit"
git remote add origin SOURCE_URL
git tag '0.0.1'
git push --tags
git push -f origin master
5. 配置 podspec 文件
5.1 修改.podspec文件
#
# Be sure to run `pod lib lint basedModule.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 https://guides.cocoapods.org/syntax/podspec.html
#
Pod::Spec.new do |s|
s.name = '组件名字'
s.version = '组件版本'
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
组件详细描述
DESC
s.homepage = '组件代码主页'
# s.screenshots = '组件代码库地址'
s.license = { :type => 'MIT', :file => 'LICENSE' }
s.author = { '作者' => '作者地址' }
s.source = { :git => '组件代码库地址', :tag => s.version.to_s }
# s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
s.ios.deployment_target = '最低版本'
s.source_files = '组件名字/Classes/**/*'
# s.resource_bundles = {
# '组件名字' => ['组件名字/Assets/*.png']
# }
# s.public_header_files = 'Pod/Classes/**/*.h'
# s.frameworks = 'UIKit', 'MapKit'
# s.dependency 'AFNetworking', '~> 2.3'
end
5.2 检测spec是否可用
pod lib lint --allow-warnings
pod spec lint --allow-warnings
--allow-warnings
:忽略所有警告,并通过校验。
--no-clean
:检查任何问题。
--verbose
:查看详细的验证过程来帮助定位错误
--use-libraries
:通过含有.a静态库的验证
5.3 提交 podspec 至私有 Spec 仓库
在 podspec 文件目录执行
pod repo push REPO_NAME MODULE_NAME.podspec --allow-warnings
6.更新 Pod
如果在开发过程中发现某基础组件存在 bug 需要更新 Pod,具体操作步骤如下:
修改 podspec 文件中的 s.version;
修复 bug 并对项目打 tag,tag 名称和 s.version 一直并 push 到远程仓库。
验证 podspec 文件的有效性;
推送 podspec 文件到远程仓库;
执行 pod search RRCache 验证结果;
创建时会遇到的一些问题
- 查找有无
ERROR
,有的话,修复相应的BUG - 没有
ERROR
,但是有很多WARN
,很多WARN
无法
解决的,加上--allow-warnings
可以解决 - 如果有静态库或者是framework,加上
--use-libraries