The Emerge Developer Hub

Welcome to the Emerge developer hub. You'll find comprehensive guides and documentation to help you start working with Emerge as quickly as possible. Let's jump right in!

Get Started    

What is App Size?

Learn the different ways of measuring size, and how Emerge calculates the most relevant size for you.

App size can be measured in different stages, and each contribute to a different part of the user experience. You'll likely come across a few different measurements of app size, so it's a good idea to know what they each mean.

App Thinning

Since iOS 9, Apple has implemented App Thinning which detects the device type when downloading an app and ensures that only the code and assets needed for that iPhone/iPad are included in the app's size.

If you view an App Store page in a web browser, the size shown will be the universal app size, which means it's not thinned for any particular device. If you view the same app using the App Store on your iOS device you'll see the smaller thinned size.

The archive that you upload to the App Store and Emerge contains your app prior to any App Thinning.

Facebook's size on the App Store website

Facebook's size on the iOS App Store


iOS apps can be built for multiple architectures, most commonly 32 and 64 bit. The iPhone 5 was the last 32 bit iPhone, and iOS 11+ only supports 64 bit devices. Apple Watch apps also contain their own architectures. With App Thinning, only the architecture needed for a device will be included. This can cut the size of the code in your app in half. You can use the lipo command to view and modify architectures in a binary. For example, you can list the architectures included in a binary like this:

lipo -archs MyAppBinary


Assets such as images, colors and .plist configuration files can come in different variants for different devices. This could be different images for each screen density, or even different configurations depending on the GPU class. Similar to how App Thinning works with architectures, it removes assets from your app that aren't needed for a given device. However, unlike architectures, asset thinning only works if assets are stored in Asset Catalogs.

Emerge will tell you if you have images that need to be moved into an Asset Catalog. You can slice a compiled Asset Catalog for a specific variant using the assetutil command. For example, you can view the items in an Asset Catalog like this:

assetutil -I Assets.car


Bitcode is a mechanism for including an intermediate representation of your code, between source code and the final executable. If enabled, extra data will be included in the binary that you upload. That data is stored in a segment labeled __LLVM. To check if this segment is included in a binary run:

otool -L MyAppBinary | grep "__LLVM"

If all binaries in your app use bitcode, Apple will use this data to re-compile the binary to a more optimized format that can reduce the size and deliver a final app without a bitcode segment. If you don't use bitcode you may need to implement these optimizations yourself. Emerge knows when your binary is not optimized and can suggest these changes automatically to you.

You can strip the bitcode in your binary using bitcode_strip.

xcrun bitcode_strip -r MyAppBinary -o MyAppBinaryThinned


All binaries downloaded from the App Store include encryption. On previous iOS versions, this encryption had a drastic effect on app download size, because an encrypted binary increased entropy and won't compress as well. On newer iOS versions this has been fixed, and app encryption doesn’t result in such a large increase to download size.

Encryption is applied after uploading to Apple, so all measurements you take of your app's size will be on an app that is not encrypted.

Download vs. Install Size

Apps are compressed before they are downloaded, so the actual number of bytes transferred will be lower than the amount of storage taken up by an installed app. Users can see both these numbers, but install size is more prominently displayed.

The install size is what you see when viewing the details for an app on the App Store:

Install Size

By default, download size will only be displayed if an app is over the Apple determined limit of 200 MB and the user is not on Wi-Fi. Hidden in the iOS Settings app, users can configure the App Store to always warn them of the download size of an app before starting the download, still only when not connected to Wi-Fi.

Download Size

Users can also review the app’s install size in the Settings app.

It's important to reduce install size, because this is what many users see when deciding if an app should be downloaded or what apps to delete.

Emerge Size

Emerge simplifies all the complicated details about how App Size can be measured. Emerge’s app size metric is roughly equivalent to the unencrypted install size of your app on the latest iPhone hardware running the latest iOS version. Since this is what users see before downloading your app and before deciding if an app should be deleted, we think it’s the most important metric to track and reduce.

Additionally, there are common ways to bloat install size without affecting download size but we don't see the inverse as often. To make sure your app doesn't use space inefficiently we show you the install size, as long as it isn't increasing you should be in good shape.

Updated 4 months ago

What is App Size?

Learn the different ways of measuring size, and how Emerge calculates the most relevant size for you.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.