Add note about Xcode auto-incrementing build numbers

src/content/docs/troubleshooting.mdx

@@ -18,6 +18,14 @@ Common causes of this problem are:
 Patches are only compatible with the release version they were created for. If
 you create a patch for version `1.0.0+1`, it will not work on version `1.0.0+2`.
 
+:::note
+This can happen unexpectedly on iOS due to Xcode's automatic incrementing of
+build numbers. If you are seeing this issue on iOS, ensure that the build number
+of the release and the patch match. See [our iOS releasing
+guide](/guides/release/ios/#upload-to-the-app-store) for instructions on how to
+disable automatic build number incrementing.
+:::
+
 #### How to tell if this is the problem
 
 You will see `Shorebird updater: no active patch` in your device logs.