app store connect + thinning

Author: trevor-e

docs/platforms/apple/guides/ios/size-analysis/index.mdx

@@ -34,6 +34,10 @@ description: Upload iOS builds to Sentry for size analysis.
 
 <Include name="size-analysis/app-thinning" />
 
+## App Store Connect File Sizes
+
+<Include name="size-analysis/app-store-connect-file-sizes" />
+
 ## What's next?
 
 We strongly recommend integrating Size Analysis into your CI pipeline. Follow our guide on [getting set up in CI](/product/size-analysis/integrating-into-ci/).

includes/size-analysis/app-store-connect-file-sizes.mdx

@@ -0,0 +1 @@
+App Store Connect has a feature for `App File Sizes` which provides a report of your app size thinned for various device types. While we strive to be consistent with these numbers, you may see differences between the reported Sentry size and the Apple size. It's important to note that the reported Apple sizes are not consistent with the rest of their tooling, such as the Size Report generated by Xcode, and these are all estimated sizes. You can [learn more about these differences here](https://github.com/EmergeTools/app-store-size-example) for additional information.

includes/size-analysis/app-thinning.mdx

@@ -2,7 +2,7 @@ App Thinning is Apple's technology that automatically optimizes the delivery of
 
 Sentry Size Analysis **does not perform any app thinning** as part of the analysis, the underlying app is untouched and results shown as-is.
 
-If you want results targeting a specific device type, apply app thinning **before** uploading to Sentry. This can be configured via Export Options when building the app. First create an `export_options.plist` file with the desired device type:
+If you want results targeting a specific device type (recommended), apply app thinning **before** uploading to Sentry. This can be configured via Export Options when building the app. First create an `export_options.plist` file with the desired device type:
 
 ```xml {filename:export_options.plist}
 <?xml version="1.0" encoding="UTF-8"?>
@@ -12,11 +12,11 @@ If you want results targeting a specific device type, apply app thinning **befor
 <key>method</key>
 <string>ad-hoc</string>
 <key>team_id</key>
-<string>sentry-team</string>
+<string>your-team-id</string> <!-- set to your ID -->
 <key>thinning</key>
-<string>iPhone17,1</string>
+<string>iPhone17,1</string> <!-- set to your device type -->
 </dict>
 </plist>
 ```
 
-And then pass this to `xcodebuild` via the `-exportOptionsPlist export_options.plist` flag when building the app. This will produce a `app-thinning.plist` file in your build directory with information on the app variants created. Pick the appropriate IPA when uploading to Sentry.
+And then pass this file to `xcodebuild` via the `-exportOptionsPlist export_options.plist` flag when building the app. This will produce a `app-thinning.plist` file in your build directory with information on the created app variants and where they are located on disk. Pick the appropriate IPA when uploading to Sentry.