View builds and metadata

1. In Apps, select the app you want to view.

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. To view the builds you uploaded for each version, click the disclosure triangle next to the version number. To view build groups, click the build number.

4. To view a build's metadata, select the app icon or build string in the expanded table under the version number in the Build column.

   

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

   The Build Metadata page displays 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.

After you upload a build to App Store Connect, it goes through app thinning, a process that 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.

1. In Apps, select the app you want to view.

2. Click the TestFlight tab to view all builds.

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

4. To view a build’s file size, select the app icon or build string in the expanded table under the version number in the Build column.

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

6. Under General Information, click App File Sizes.

   

   A table appears displaying 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 icon 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 also sends you an email with this information.

You can view a build’s version and build number, upload status, and creation date under the Build Uploads section in App Store Connect. The upload status provides detailed insights into delivery progress, including warnings, errors, and other information.

If the upload status of a build is unclear, submit a Feedback Assistant ticket (Developer Tools & Resources > TestFlight) or contact us. Be sure to include details like version and build numbers, upload date and time, and relevant logs, in your issue report.

1. In Apps, select the app you want to view.

2. Click the TestFlight tab to view all builds.

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

4. To view a build’s delivery progress, expand Build Uploads and refer to its status under the Status column.

   Tip: Use the All Statuses dropdown at the top right of the Build Uploads table to filter by status.

   

5. Select the status to view details of any errors, warnings, or information. If your build shows a Failed status, resolve all issues before re-uploading.

   Note:

   • For builds with a Complete status, you can access more details (including metadata) by selecting the build string in the Version & Build column or clicking Complete.

   • Even if the status is Complete, there may still be warnings or other details you should review and address before your next upload.

   • If you upload a build and it remains in the Processing state for more than 24 hours, there may be an issue. To resolve the issue, submit a Feedback Assistant ticket or contact us.

Apple calculates the minimum operating system version required for your app to run based on your build settings. You can verify a build's device requirements on the Build Metadata 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.

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.

Learn how to analyze crash reports using dSYM files.

In App Store Connect, to download dSYM files for a build:

1. In Apps, select the app you want to view.

2. Click the TestFlight tab to view all builds.

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

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

4. To view a build's dSYM files, select the app icon or build string in the expanded table under the version number in the Build column.

   

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

6. Under General Information, click Download dSYM.