Baike.dev
All toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
C

cocoapods-bin

> 编程语言
Open source

CocoaPods 组件二进制化辅助插件（双私有源）

303 stars0 likes0 views
WebsiteGitHub

About

CocoaPods 组件二进制化辅助插件（双私有源）

此库已不维护，如有需求可使用 MeetYouDevs/cocoapods-imy-bin

cocoapods-bin

组件二进制化插件。

基于 CocoaPods 的组件二进制化实践

Demo 工程

更新

0.1.28

新增本地组件依赖配置文件 BinPodfile ，

场景: 不希望把本地采用的源码/二进制配置传到远程仓库。

使用: 在 Podfile 同级目录下创建 BinPodfile ，并将其加入 .gitignore 。BinPodfile 中的配置选项优先级比 Podfile 高，支持和 Podfile 相同的配置语句，如 :

# BinPodfile

use_binaries!
set_use_source_pods ['YYModel']

概要

本插件所关联的组件二进制化策略：

预先将打包成 .a 或者 .framework 的组件（目前接入此插件必须使用 .framework，最好是静态 framework）保存到静态服务器上，并在 install 时，去下载组件对应的二进制版本，以减少组件编译时间，达到加快 App 打包、组件 lint、组件发布等操作的目的。

使用本插件需要提供以下资源：

  • 静态资源服务器（可参考 binary-server）
  • 源码私有源（保存组件源码版本 podspec）
  • 二进制私有源（保存组件二进制版本 podspec）

在所有组件都依赖二进制版本的情况下，本插件支持切换指定组件的依赖版本。

推荐结合 GitLab CI 使用本插件，可以实现自动打包发布，并显著减少其 pipeline 耗时。关于 GitLab CI 的实践，可以参考 火掌柜 iOS 团队 GitLab CI 集成实践。虽然后来对部分 stage 和脚本都进行了优化，但总体构建思路还是没变的。

准备工作

安装 cocoapods-bin：

$ gem install cocoapods-bin

初始化插件：

➜  ~ pod bin init

开始设置二进制化初始信息.
所有的信息都会保存在 /Users/songruiwang/.cocoapods/bin.yml 文件中.
你可以在对应目录下手动添加编辑该文件. 文件包含的配置信息样式如下：

---
code_repo_url: [email protected]:ios/cocoapods-spec.git
binary_repo_url: [email protected]:ios/cocoapods-spec-binary.git
binary_download_url: http://iosframeworkserver-shopkeeperclient.app.2dfire.com/download/%s/%s.zip
download_file_type: zip

源码私有源 Git 地址
旧值：[email protected]:ios/cocoapods-spec.git
 >

按提示输入源码私有源、二进制私有源、二进制下载地址、下载文件类型后，插件就配置完成了。其中 binary_download_url 需要预留组件名称与组件版本占位符，插件内部会依次替换 %s 为相应组件的值。

cococapod-bin 也支持从 url 下载配置文件，方便对多台机器进行配置：

➜  ~ pod bin init --bin-url=http://git.xxxxxx.net/qingmu/cocoapods-tdfire-binary-config/raw/master/bin.yml

配置文件模版内容如下，根据不同团队的需求定制即可：

---
code_repo_url: [email protected]:ios/cocoapods-spec.git
binary_repo_url: [email protected]:ios/cocoapods-spec-binary.git
binary_download_url: http://iosframeworkserver-shopkeeperclient.app.2dfire.com/download/%s/%s.zip
download_file_type: zip

配置时，不需要手动添加源码和二进制私有源的 repo，插件在找不到对应 repo 时会主动 clone。

插件配置完后，就可以部署静态资源服务器了。对于静态资源服务器，这里不做赘述，只提示一点：在生成二进制 podspec 时，插件会根据 download_file_type 设置 source 的 :type 字段。在下载 http/https 资源时，CocoaPods 会根据 :type 字段的类型采取相应的解压方式，如果设置错误就会抛错。这里提到了 二进制 podspec 的自动生成，后面会详细介绍。

这里额外说下打包工具 cocoapods-packager 和 Carthage ，前者可以通过 podspec 进行打包，只要保证 lint 通过了，就可以打成 .framework，很方便，但是作者几乎不维护了，后者需要结合组件工程。具体使用哪个可以结合自身团队，甚至可以自己写打包脚本，或者使用本插件的打包命令。

使用插件

接入二进制版本后，常规的发布流程需要做如下变更：

# 1 打出二进制产物 && 提交产物至静态文件服务器
pod bin archive YOUR_OPTIONS
curl xxxxxxx

# 2.1 发布二进制 podspec
pod bin repo push --binary YOUR_OPTIONS

# 2.2 发布源码 podspec
pod bin repo push YOUR_OPTIONS

如果团队内部集成了 CI 平台，那么上面的每大步都可以对应一个 CI stage，源码和二进制版本可并行发布，对应一个 stage 中的两个 job。

基本信息

cocoapods-bin 命令行信息可以输入以下命令查看: 

➜  ~ pod bin --help
Usage:

    $ pod bin [COMMAND]

      组件二进制化插件。利用源码私有源与二进制私有源实现对组件依赖类型的切换。

Commands:
    + archive   将组件归档为静态 framework.
    + init      初始化插件.
    + lib       管理二进制 pod.
    + list      展示二进制 pods .
    > open      打开 workspace 工程.
    + repo      管理 spec 仓库.
    + search    查找二进制 spec.
    + spec      管理二进制 spec.
    + umbrella  生成伞头文件 .

构建二进制产物

➜  ~ pod bin archive --help
Usage:

    $ pod bin archive [NAME.podspec]

      将组件归档为静态 framework，仅支持 iOS 平台 此静态 framework 不包含依赖组件的 symbol

Options:

    --code-dependencies     使用源码依赖
    --allow-prerelease      允许使用 prerelease 的版本
    --use-modular-headers   使用 modular headers (modulemap)
    --no-clean              保留构建中间产物
    --no-zip                不压缩静态 framework 为 zip
    ...

pod bin archive 会根据 podspec 文件构建静态 framework ，此静态 framework 不会包含依赖组件的符号信息。命令内部利用 cocoapods-generate 插件生成工程，并移植了 cocoapods-packager 插件的部分打包功能，以构建前者生成的工程，默认条件下，命令会生成一个 zip 压缩包。

二进制 podspec

cocoapods-bin 针对一个组件，同时使用了两种 podspec，分别为源码 podspec 和二进制 podspec，这种方式在没有工具支撑的情况下，势必会增加开发者维护组件的工作量。做为开发者来说，我是不希望同时维护两套 podspec 的。为了解决这个问题， 插件提供了自动生成二进制 podspec 功能，开发者依旧只需要关心源码 podspec 即可。

一般来说，在接入插件前，组件源码 podspec 是已经存在的，所以我们只需要向二进制私有源推送组件的二进制 podspec 即可。如果有条件的话，二进制和源码 podspec 的发布可以走 GitLab CI ，这也是我推荐的做法。

下面介绍下和二进制 podspec 相关的 cocoapods-bin 命令。

pod bin spec create

➜  ~ pod bin spec create --help
Usage:

    $ pod bin spec create

      根据源码 podspec 文件，创建对应的二进制 podspec 文件.

Options:

    --platforms=ios                                生成二进制 spec 支持的平台
    --template-podspec=A.binary-template.podspec   生成拥有 subspec 的二进制 spec 需要的模版
                                                   podspec, 插件会更改 version 和 source
    --no-overwrite                                 不允许覆盖
	...

pod bin spec create 会根据源码 podspec ，创建出二进制 podspec 文件。如果组件存在 subspec ，需要开发者提供 podspec 模版信息，以生成二进制 podspec。插件会根据源码 podspec 更改模版中的 version 字段，并且根据插件配置的 binary_download_url 生成 source 字段，最终生成二进制 podspec。

以 A 组件举例，如果 A 的 podspec 如下：

Pod::Spec.new do |s|
  s.name             = 'A'
  s.version          = '0.1.0'
  s.summary          = 'business A short description of A.'
  s.description      =  'MIT', :file => 'LICENSE' }
  s.author           = { 'qingmu' => '[email protected]' }
  s.source           = { :git => 'http://git.2dfire-inc.com/qiandaojiang/A.git', :tag => s.version.to_s }
  s.ios.deployment_target = '8.0'
  s.source_files = 'A/Classes/**/*'
  s.public_header_files = 'A/Classes/**/*.{h}'
  s.resource_bundles = {
      'A' => ['A/Assets/*']
  }
end

那么生成的 A.binary.podspec.json 如下：

…

如果 A 拥有 subspec：

…

那么就需要开发者提供 A.binary-template.podspec（此模版中的写法假定组件的所有 subspec 都打进一个 .framework 里，如果 subpsec 都有属于自己的 .framework ，就可以采用其他写法。），这里要注意源码版本 subspec 集合需要为二进制版本 subspec 集合的子集，否则会出现源码拉取失败或抛出 subspec 不存在错误的情况：

…

最终生成的二进制 podspec 如下：

…

pod bin spec lint

…

pod bin spec lint 默认使用二进制依赖进行 lint，在添加 --binary 会去 lint 当前组件的二进制 podspec（动态生成）。在添加 --code-dependencies 将会使用源码依赖进行 lint ，个人推荐使用二进制依赖 lint，可以极大地减少编译时间。

pod bin repo push

…

pod bin repo push 用来发布组件，其余特性和 pod bin spec lint 一致。

Podfile DSL

首先，开发者需要在 Podfile 中需要使用 plugin 'cocoapods-bin' 语句引入插件 :

plugin 'cocoapods-bin'

顺带可以删除 Podfile 中的 source ，因为插件内部会自动帮你添加两个私有源。

cocoapods-bin 插件提供二进制相关的配置语句有 use_binaries!、use_binaries_with_spec_selector! 以及 set_use_source_pods，下面会分别介绍。

use_binaries!

全部组件使用二进制版本。

支持传入布尔值控制是否使用二进制版本，比如 DEBUG 包使用二进制版本，正式包使用源码版本，Podfile 关联语句可以这样写：

use_binaries! (ENV['DEBUG'].nil? || ENV['DEBUG'] == 'true')

当组件没有二进制版本时，插件会强制工程依赖该组件的源码版本。开发者可以通过执行 pod install--verbose option ，在分析依赖步骤查看哪些组件没有二进制版本：

…

也可以通过 Podfile.lock 中的 SPEC REPOS 字段，查看哪些组件采用了源码版本，哪些采用了二进制版本：

...
SPEC REPOS:
  "[email protected]:ios/cocoapods-spec-binary.git":
    - AFNetworking
    - Aspects
    - CocoaSecurity
    - DACircularProgress
   ...
  "[email protected]:ios/cocoapods-spec.git":
    - ActivityForRestApp
    - AMapFrameworks
    - AssemblyComponent
    ...
...

set_use_source_pods

设置使用源码版本的组件。

实际开发中，可能需要查看 YYModel 组件的源码，这时候可以这么设置：

set_use_source_pods ['YYModel']

如果 CocoaPods 版本为 1.5.3 ，终端会输出以下内容，表示 YYModel 的参照源从二进制私有源切换到了源码私有源：

Analyzing dependencies
Fetching podspec for `A` from `../`
Downloading dependencies
Using A (0.1.0)
Installing YYModel 1.0.4.2 (source changed to `[email protected]:ios/cocoapods-spec.git` from `[email protected]:ios/cocoapods-spec-binary.git`)
Generating Pods project
Integrating client project
Sending stats
Pod installation complete! There is 1 dependency from the Podfile and 2 total pods installed.

use_binaries_with_spec_selector!

过滤出需要使用二进制版本组件。

假如开发者只需要 YYModel 的二进制版本，那么他可以在 Podfile 中添加以下代码：

use_binaries_with_spec_selector! do |spec|
  spec.name == 'YYModel'
end

需要注意的是，如果组件有 subspec ，使用组件名作为判断条件应如下：

use_binaries_with_spec_selector! do |spec|
  spec.name.start_with? == '组件名'
end

如果像上个代码块一样，直接对比组件名，则插件会忽略此组件的所有 subspec，导致资源拉取错误，这种场景下，最好通过 set_use_source_pods 语句配置依赖。

一个实际应用是，三方组件采用二进制版本，团队编写的组件依旧采用源码版本。如果三方组件都在 cocoapods-repo 组下，就可以使用以下代码过滤出三方组件：

use_binaries_with_spec_selector! do |spec|
 git = spec.source && spec.source['git']
 git && git.include?('cocoapods-repo')
end

其他设置

插件默认开启多线程下载组件资源，如果要禁用这个功能，Podfile 添加以下代码即可：

install! 'cocoapods', { install_with_multi_threads: false }

Issues· 10 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Ruby

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 18, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集，为前端与全栈提供静态类型
P
Python
通用编程语言，广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言