cocoapods-util介绍

cocoapods-util是一个iOS开发提效的cocoapods插件。

取名util的原因是我想做一个通用的插件，把一些iOS中常用的命令或问题整理起来。

插件中除了package命令是根据cocoapods-packager插件做了修改而来，其余命令都是属于自己总结开发场景下的需求实现的，希望对各位iOSer有所帮助。

目前已支持功能有：

1. pod repo push命令优化，解决push私有库慢、验证时间长易失败的问题
2. 查看Pods组件安装列表（详细情况）以及各pod组件间的依赖关系
3. 根据podspec文件打包生成二进制（.a、.framework、.xcframework）
4. 把现有framework生成xcframework
5. 二进制源码链接调试
6. 去除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

示例

$ pod util uniq project.xcodeproj

反馈

如果使用中有什么问题，可以提交评论，也可以去我的项目地址中去提交issue，我看到后会尽快回复。