Caliper

Caliper: iOS App Size Analyzer

Caliper is a powerful iOS app size analysis tool designed to help developers optimize their applications by providing detailed insights into bundle sizes at the module level. This tool effectively parses LinkMap files, tracks asset usage, and identifies module ownership, ultimately enabling improved app performance and efficient resource management.

Key Features

• Comprehensive Binary Size Analysis: Accurately determine the binary sizes of individual modules using LinkMap files.
• Asset Tracking: Get a thorough breakdown of images, storyboards, and other resources used in the app.
• Module Ownership Management: Identify which team owns specific modules, ensuring accountability and streamlined optimization efforts.
• Version Tracking: Extract Swift package version information from the Package.resolved file for precise dependency management.
• Interactive Reports: Generate search-optimized HTML reports that allow for filtering and sorting of module data.
• Size Metrics: View both compressed (IPA) and uncompressed (installed) size metrics to understand space utilization.
• Automatic App Detection: Automatically tags the primary app module, facilitating rapid analysis.

Quick Start Example Usage

To analyze an IPA file with comprehensive features, use the following command:

.build/release/caliper \
  --ipa-path MyApp.ipa \
  --link-map-path MyApp-LinkMap.txt \
  --ownership-file module-ownership.yml \
  --package-resolved-path Package.resolved

This command generates a report.json and a report.html, providing a complete overview of the app's size mechanics.

Interactive Reporting

Caliper's reporting capabilities offer an intuitive web interface where users can:

• Search and filter through modules
• Sort data by size, binary size, or module name
• Expand module details for deeper insights
• Analyze resource breakdowns by file type
• Identify the largest files within each module
• Filter modules by ownership or type (internal vs. external)

Try the Demo

Interested users can check out a demo of Caliper's HTML report by visiting the Demo HTML report.

Caliper is inspired by Spotify's Ruler and has been tailored specifically for iOS utilization, with features that accommodate the nuances of the iOS development ecosystem, such as asset catalog parsing and advanced LinkMap analysis. This makes it an essential tool for any iOS developer looking to maintain optimal app performance while ensuring smooth CI/CD integration.