cocoapods-util介绍
cocoapods-util是一个iOS开发提效的cocoapods插件。
取名util的原因是我想做一个通用的插件,把一些iOS中常用的命令或问题整理起来。
插件中除了package命令是根据cocoapods-packager插件做了修改而来,其余命令都是属于自己总结开发场景下的需求实现的,希望对各位iOSer有所帮助。
目前已支持功能有:
- pod repo push命令优化,解决push私有库慢、验证时间长易失败的问题
- 查看Pods组件安装列表(详细情况)以及各pod组件间的依赖关系
- 根据podspec文件打包生成二进制(.a、.framework、.xcframework)
- 把现有framework生成xcframework
- 二进制源码链接调试
- 去除project.pbxproj文件重复引用
好了,话不多说,看一下插件怎么安装使用吧。
安装
$ gem install cocoapods-util
使用介绍
通过此命令查看util插件支持的所有功能
$ pod util --help
命令介绍
1. repo push
介绍
推送私有pod仓库的命令,可以跳过验证、跳过编译过程,用于快速发布私有pod。
- 可以通过添加--skip-validate的选项跳过验证步骤。
- 可以通过添加--skip-build的选项跳过编译,但是会验证tag,需要确保tag已存在。
$ pod util repo push --help
该命令是一个提效命令,在推送自己私有仓库的时候可以通过设置--skip-validate选项跳过验证直接推送到私有仓库。
插件只是在原来的命令基础上扩展了两个参数,执行命令的时候如果不配置这两个参数,那么和原命令完全一样。
示例
只需要在正常执行pod repo push命令的时修改成pod util repo push。
$ pod util repo push [yourSpecs] [xxx.podspec] --skip-validate
2. install list
介绍
查看Pods安装的列表(详细情况)
- 可以省去开发者自己去阅读Podfile.lock文件的时间,直接友好的提示
- 可以清晰的看出引用的组件个数、组件依赖情况、组件被依赖的情况、组件分支tag信息、仓库地址等有效信息
- 建议在Podfile文件所在目录执行此命令
$ pod util install list --help
示例
$ pod util install list --showmore
Tips:我在最新的插件版本中重新实现了此命令,使用cocoapods中Installer类提供的依赖解析方法来解析组件的依赖,实现更简单,可以递归的查找到所有依赖的组件。
3. xcframework
介绍
可以把现有的framework生成xcframework。
该命令可以分析出是某个平台的framework(如ios、osx、watchos),直接在framework同级目录生成xcframework。
根据不同平台的framework,分别提取真机、模拟器对应架构的二进制,最终再组合成xcframework文件。
示例
把现有的Alamofire.framework生成Alamofire.xcframework
$ pod util xcframework Alamofire.framework --force
4. package
介绍
通过podspec文件生成library、framework、xcframework。
- 支持swift和混编
- 支持自定义配置dependency(如配置某个组件为branch依赖)
- 支持排除模拟器
- 支持多平台(ios、osx、watchos、tvos)
- 支持自定义设置工程的build settings(如:排除ios模拟器64位架构、设置支持的架构等)
- 支持设置modular_headers
$ pod util package --help
示例
生成xcfrmework、framework或library
克隆AFNetworking的源码到本地,进入AFNetworking源码的根目录下,执行下面的命令
$ pod util package AFNetworking.podspec --force --local --xcframework
$ pod util package AFNetworking.podspec --force --local --framework
$ pod util package AFNetworking.podspec --force --local --library
排除模拟器
如果你不需要编译模拟器架构,可以添加--exclude-sim
$ pod util package AFNetworking.podspec --force --local --xcframework --exclude-sim
平台设置
如果你只需要编译ios架构下的xcframework,可以添加--platforms=ios
$ pod util package AFNetworking.podspec --force --local --xcframework --exclude-sim --platforms=ios
build settings配置
如果你想要做一些build settings特殊配置,可以添加 --build-settings,如设置编译选项排除模拟器arm64架构。理论上来讲,可以像直接操作工程一样,灵活的配置build settings
- 如设置排除arm64位架构
$ --build-settings='{"EXCLUDED_ARCHS[sdk=iphonesimulator*]":"arm64"}'
- 设置编译swift生成swiftinterface文件
$ -build-settings='{"BUILD_LIBRARY_FOR_DISTRIBUTION":"YES"}'
- 或者你想设置多个编译选项
$ -build-settings='{"EXCLUDED_ARCHS[sdk=iphonesimulator*]":"arm64","BUILD_LIBRARY_FOR_DISTRIBUTION":"YES","VALID_ARCHS":"arm64"}'
自定义dependencies
如果你依赖的组件并没有发布到私有仓库,只是分支依赖。 如果你依赖的组件和官方源有冲突,你需要修改指定source源,这时候你可以通过配置--dependency-config={}
选项指定仓库分支、tag或指定source源。
$ --dependency-config='{"PodA":{"git":"xxx","branch":"xxx"},"PodB":{"source":"xxx"}}'
5. linksource
介绍
源码二进制链接功能。
$ pod util linksource --help
这个命令实现比较简单,但是也不太实用。简单来说就是源码路径在多台电脑上很难统一,还会有权限问题。
6. uniq
介绍
对xcodeproj --> project.pbxproj文件做重复引用的去重。
该命令的来源是我发现工程的.pbxproj文件变得非常大,最大时发现有10M的大小,在执行pod的更新时会卡在install的执行过程User Project Integration
这一步很长的时间。
我检查了一下这个工程文件,发现这里面有许多重复的引用,这是由于项目长期merge代码的过程中没有很好的解决冲突,保留了相同的引用,所以才有了这个命令。
我尝试对pbxproj文件做了去重,文件大小从10M减小到了1.7M,再执行pod install安装时就不会再卡在User Project Integration
这一步骤了。
$ pod util uniq --help
文章来源:https://www.toymoban.com/news/detail-466879.html
示例
$ pod util uniq project.xcodeproj
反馈
如果使用中有什么问题,可以提交评论,也可以去我的项目地址中去提交issue,我看到后会尽快回复。文章来源地址https://www.toymoban.com/news/detail-466879.html
到了这里,关于iOS开发提效cocoapods插件cocoapods-util的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!