iOS组件化(基于Cocoapods)
- 组件化前提先确保已经 安装
Cocoapod - 组件化前提: 先将
git权限问题搞明白 - 组件库实际就是一个
git代码库 - 私有源库实际也是一个
git代码库, 不过里面只有以.podspec结尾的文件
注册 trunk
pod trunk register xxxx@gmail.com manajay
创建本地私有库
- 创建
pod lib create xxx Class中添加代码文件Assets中添加图片等资源 : 注意获取资源使用[NSBundle bundleForClass:self], 注意图片要全名, 如果使用了资源,那么podfile文件中添加描述use_frameworks!
更改本次的版本描述
podspec文件- 注意
version一定要对应git tag source_filesdependencyresource_bundles
验证本地的组件库是否有效
pod lib lint
测试一
pod lib lint --no-clean LJNetwork.podspec
-> LJNetwork (1.0.0)
- ERROR | attributes: Missing required attribute `summary`.
- ERROR | [iOS] unknown: Encountered an unknown error (The `LJNetwork` pod failed to validate due to 1 error:
- ERROR | attributes: Missing required attribute `summary`.
) during validation.
Pods workspace available at `/var/folders/86/kvr1rbk53zgb0xpkljyv2vn80000gn/T/CocoaPods-Lint-20180308-31173-4h194x-LJNetwork/App.xcworkspace` for inspection.
[!] LJNetwork did not pass validation, due to 2 errors.
修改 summary 后
测试二
pod lib lint --no-clean LJNetwork.podspec
-> LJNetwork (1.0.0)
- WARN | [iOS] swift: The validator used Swift 3.2 by default because no Swift version was specified. To specify a Swift version during validation, add the `swift_version` attribute in your podspec. Note that usage of the `--swift-version` parameter or a `.swift-version` file is now deprecated.
Pods workspace available at `/var/folders/86/kvr1rbk53zgb0xpkljyv2vn80000gn/T/CocoaPods-Lint-20180308-31243-i7bisy-LJNetwork/App.xcworkspace` for inspection.
[!] LJNetwork did not pass validation, due to 1 warning (but you can use `--allow-warnings` to ignore it).
注意如果出现WARN字样 可以使用pod repo push XXXSpec xxx.podspec --allow-warnings 忽略警告
测试三
pod lib lint --no-clean --allow-warnings LJNetwork.podspec
-> LJNetwork
-> LJNetwork (1.0.0)
- WARN | xcodebuild: ReachabilitySwift/Reachability/Reachability.swift:95:42: warning: plaform condition appears to be testing for simulator environment; use 'targetEnvironment(simulator)' instead
Pods workspace available at `/var/folders/86/kvr1rbk53zgb0xpkljyv2vn80000gn/T/CocoaPods-Lint-20180308-32416-1hp85wj-LJNetwork/App.xcworkspace` for inspection.
LJNetwork passed validation.
- 出现ERROR的话, 则必须解决
创建自己的私有远程管理库
- 创建一个私有的远程库
- 本地添加私有远程库的索引库
pod repo add XXXSpec https://git.XXX/XXXSpec.git - 本地的索引库检查
pod repo,除了'https://github.com/CocoaPods/Specs.git'还有自己的
关联远程库, 设置tag 并推送到 远程库
git tag xxx
git push -u origin master // 首次推送
git push --tags
如果tag和私有库的version不匹配, 注意删除tag,修改正确.
推送组件的 podspec文件到自己的私有远程管理库
- cd 到 组件
podspec文件目录下 pod repo push XXXSpec xxx.podspec推送该组件的podspec文件- 远程私有管理库中查看是否将
xxx.podspec文件推送到了远程
pod trunk --allow-warnings push LJNetwork.podspec
Updating spec repo `master`
Validating podspec
-> LJNetwork (1.0.0)
- WARN | xcodebuild: ReachabilitySwift/Reachability/Reachability.swift:95:42: warning: plaform condition appears to be testing for simulator environment; use 'targetEnvironment(simulator)' instead
Updating spec repo `master`
--------------------------------------------------------------------------------
🎉 Congrats
🚀 LJNetwork (1.0.0) successfully published
📅 March 8th, 02:04
🌎 https://cocoapods.org/pods/LJNetwork
👍 Tell your friends!
如果发现有授权失败的问题, 很有可能是你的私有源库XXXSpec的授权有问题, 最好检查一下.
私有库在Mac的地址为 ~/.cocoapods/repos/ ,在这个目录下查找XXXSpec即可.
而这里说的授权是根据访问方式确定的. 分为: Https和SSH访问
如果是Https:
最好查看一下git全局配置 git config --global --list
配置全局的用户名和 密码
git config --global user.name "username"
git config --global user.email username@copany.com
然后再确认一下私有源库的config配置
cat ~/.cocoapods/repos/XXXSpec/.git/config
确保 url 的路径要有username. 例如: url = https://username@xxxx.git
如果是SSH
~/.ssh 的路径下, 有当前私有库的私钥文件(一般以 rsa 结尾). 具体可以询问运维同学, 这里就不讲了.
使用 私有组件
- 首次使用组件, 先确保添加了私有仓库的管理源地址
pod repo add XXSpec https://xxx/XXSpec.git// 注意 这里因为是私有库 所以需要权限来获取私有管理库的资源
- 搜索自己的私有库组件
pod search
- 没有使用
Cocoapods的要先在 项目根目录创建Podfile文件 执行pod init - 编辑
Podfile文件
# 表示先去找私有，再找公有的 master
source 'https://git.XXX/XXXSpec.git'
source 'https://github.com/CocoaPods/Specs.git'
pod 'xxx'
- 打开生成的xxx.xcworkspace文件
组件升级
- 私有源远程库的升级
# 更新 podspec索引文件
pod repo update
- 项目中的组件升级 , 推荐指定
pod升级
# 升级所有组件 , 子命令 --no-repo-update为 不更新索引
pod update --no-repo-update
# 指定某个pod 升级 , 不更新索引
pod update xxxPod --no-repo-update
<补充> Cocoapods公有仓库推送
登录
pod trunk register mailname@gmail.com 'username' --description='xxxx'
[!] Please verify the session by clicking the link in the verification email that has been sent to manajay.dlj@gmail.com
用于已有用户的登录 获取session
- 检验登录状态
pod trunk me
- Name: Manajay
- Email: manajay.dlj@gmail.com
- Since: xxxx xxth, xxxx xx:xx
- Pods:
- NJAlertView
- LJNetwork
- Sessions:
- August xxth, xxxx xx:xx - December xxth, xxx xx:xx. IP: xxxxx Description: custom alertView
- June xxth, xxxx xx:xx - November xxth, xxxx xx:xx. IP: xxxx
- August xxth, xxx xx:xx - December xxth, xxxx xx:xx. IP: xxxxxxx
- March xxth, xx:xx - July xxth, xx:xx. IP: xxxxx Description: xx xx