iOS Binary Framework Integration and CocoaPods Distribution Guide

The article explains how to speed up iOS project compilation by converting frequently used libraries into binary frameworks, eliminating the need to compile source code after the project is split.

Three main solutions are presented:

Separate repository management: Create a public SDK repository that stores generated frameworks and uses subspecs in the podspec to differentiate them. Example podspec structure is shown.

Podspec macro management: Use conditional logic inside a podspec to switch between source files and vendored frameworks, allowing source debugging without a separate SDK repository.

prepare_command with Carthage/CocoaPods packager/Python/Ruby: Leverage prepare_command to run custom scripts that build frameworks before pod installation, integrating tools like Carthage and shell scripts.

Each solution includes usage examples and code snippets:

{ "name": "MFSFrameworks", "version": "x.x.x", "summary": "MFSFrameworks Test", "subspecs": [ { "name": "MFSCache", "vendored_frameworks": "MFSCache/*.framework" }, { "name": "MFSNetwork", "source_files": "MFSNetwork/*.{h,m}", "vendored_frameworks": "MFSNetwork/*.framework" }, { "name": "MFSIdentifier", "source_files": "MFSIdentifier/**/*.{h}", "vendored_frameworks": "MFSIdentifier/*.framework" } ] }

Installation commands such as:

pod 'MFSFrameworks', 'x.x.x', :subspecs => ['MFSNetwork', 'MFSCache', 'MFSIdentifier']

and debugging mode activation:

IS_SOURCE=1 pod install

are provided, along with the steps to clean CocoaPods caches.

The article also covers Carthage usage, its limitations, and the installation of cocoapods‑packager via:

sudo gem install cocoapods-packager

Shell scripts for building universal frameworks are detailed, showing how to use xcodebuild and lipo to merge device and simulator binaries.

A complete workflow is described, from creating a Cocoa Touch Framework named iOSBinaryPractice , configuring shared schemes, setting the Mach‑O type, adding a Podfile, building example projects, and publishing the final podspec JSON.

Finally, the guide discusses handling debug versions with custom tags (e.g., 0.1.alpha ) and the challenges of naming and using such tags in CocoaPods.