Manage builds

View builds and metadata

You can view all the builds you upload for an app and metadata for each build, including the size of variants created by Apple. Some builds may not appear after the app is released.

Learn how to get build information with the App Store Connect API.

Required role: Account Holder, Admin, App Manager, or Developer. View role permissions.

View build metadata

  1. From Apps, select your app.

  2. Click the TestFlight tab to view all builds.

  3. In the sidebar, select the platform you want to view build metadata for.

    Note: Builds are organized by version number. View the builds you uploaded for each version by clicking on the disclosure triangle next to the version number. To view build groups, click the build number.

  4. To view the build metadata, click the app icon or build string that appears in the Build column.

    Version section on the iOS Builds page.
  5. From the build page, click the Build Metadata tab.

    The Build Metadata page shows the file sizes of a build, such as the compressed file size, essential content size, additional in-app content size, and other build-related information.

View the file sizes of a build

After you upload a build to App Store Connect, it goes through a process called app thinning, which creates variants of your app for different devices and operating system versions. You can view the amount of space a variant occupies on the customer’s device directly in App Store Connect.

Note: When your app is approved for distribution, it’s encrypted with Digital Rights Management (DRM) and recompressed. The app file size for your binary may be larger than it is for the binary you uploaded in App Store Connect. The exact final size for your app can't be determined in advance.

  1. From Apps, select your app.

  2. Click the TestFlight tab to view all builds.

  3. In the sidebar, select the platform you want to view builds for.

  4. On the right, in the Build column, click the app icon or build string for the build you want to view.

  5. From the build page, click the Build Metadata tab.

  6. Below General Information, click App File Sizes.

    Estimated App file sizes table on the iOS Build Metadata page.

    A table appears showing the different variant sizes.

    • The device type is the target device for the variant. Universal refers to the variant that runs on all supported operating systems and target devices that are delivered to customers running iOS 8 or earlier, apps purchased in volume through Apple School Manager and Apple Business Manager or through Mobile Device Management (MDM), or apps downloaded using iTunes 12.6 or earlier.

    • The install size is the amount of disk space the app consumes on the customer’s device. The install size also appears on your app’s product page in the Information section.

    • The download size is the compressed size of the app that’s downloaded over the air, using cellular bandwidth or Wi-Fi.

If any of the device variant sizes exceed the 200 MB over-the-air download limit, a yellow warning appears next to the build string in the Builds table and next to the variant size in the App File Sizes table. Click the warning icon to read the full warning. Apple will also send you an email with this information.

View the device requirements for a build

Apple uses your build settings to calculate the minimum version of the operating system required for your app to run. You can verify a build’s device requirements on the Build Metadata page.

Device Requirements section in the iOS Build page.
  • The Minimum iOS Version is the MinimumOSVersion provided in your build.

  • The Minimum macOS Version is the minimum version of macOS required for your app to run, as determined by Apple.

    Apple automatically calculates the minimum macOS version using the LSMinimumSystemVersion provided in your build, if applicable, and the closest related macOS for the MinimumOSVersion provided in your build. If you’ve selected a minimum macOS version in Pricing and Availability and the value is higher than the LSMinimumSystemVersion or the closest related macOS for the MinimumOSVersion, this version will be shown instead.

  • The LS Minimum System Version is the optional LSMinimumSystemVersion provided in your build.

Download dSYM files

If you include bitcode when you upload your app to App Store Connect, Apple generates debug symbol (dSYM) files, which you’ll need to download in Xcode or App Store Connect before you can view logs in Xcode.

Note: Starting with Xcode 14, bitcode is no longer required for tvOS or watchOS apps, and Apple no longer accepts bitcode submissions from Xcode 14. dSYM files can only be downloaded for existing bitcode submissions and are no longer available for submissions from Xcode 14 or later.

Learn how to analyze crash reports using dSYM files.

To download dSYM files for a build in App Store Connect:

  1. From Apps, select your app.

  2. Click the TestFlight tab to view all builds.

  3. In the sidebar, select the platform you want to view build metadata for.

    Note: Builds are organized by version number. View the builds you uploaded for each version by clicking the Versions tab and then the disclosure triangle next to the version number. To view build groups, click the Build Groups tab.

  4. To view the build metadata, click the app icon or build string in the Build column.

    Version section on the iOS Builds page.
  5. From the build page, click the Build Metadata tab.

  6. Under General Information, click Download dSYM.

    General Information section in the iOS Builds Metadata page. A pointer points to the Download dSYM link.