From 22f07778ae56144183db33b0c5c9c9653a2d97b7 Mon Sep 17 00:00:00 2001 From: Eric Seidel Date: Tue, 31 Mar 2026 23:09:32 -0700 Subject: [PATCH 1/2] docs: add caution about optional applicationIdSuffix in Android flavors guide Add a caution admonition noting that applicationIdSuffix is optional and may cause issues with services like Firebase that depend on consistent package names. Closes #156 --- src/content/docs/code-push/guides/flavors/android.mdx | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/src/content/docs/code-push/guides/flavors/android.mdx b/src/content/docs/code-push/guides/flavors/android.mdx index 54762056..0c8e0b15 100644 --- a/src/content/docs/code-push/guides/flavors/android.mdx +++ b/src/content/docs/code-push/guides/flavors/android.mdx @@ -94,6 +94,14 @@ buildTypes { +:::caution + +The `applicationIdSuffix` property is optional. If you use services that depend +on a consistent package name (e.g., Firebase), removing `applicationIdSuffix` +may be necessary to avoid configuration issues. + +::: + Lastly, edit `android/app/src/main/AndroidManifest.xml` to use the `applicationLabel` so that we can differentiate the two apps easily: From 48ccba218dba1620dd80e2f8115e717da71d4cb6 Mon Sep 17 00:00:00 2001 From: Eric Seidel Date: Tue, 31 Mar 2026 23:11:05 -0700 Subject: [PATCH 2/2] docs: add FAQ entry about iOS Simulator not being supported Closes #171 --- src/content/docs/code-push/faq.mdx | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/src/content/docs/code-push/faq.mdx b/src/content/docs/code-push/faq.mdx index d54804e0..1c8f747e 100644 --- a/src/content/docs/code-push/faq.mdx +++ b/src/content/docs/code-push/faq.mdx @@ -294,6 +294,17 @@ the latest version from the server if needed. If you have a use case for code push with Fluter web, we'd [love to know](mailto:contact@shorebird.dev)! +### Does Shorebird work on the iOS Simulator? + +No. Shorebird's code push does not work on the iOS Simulator. On physical iOS +devices, Shorebird uses a custom ARM interpreter to run patched Dart code. The +iOS Simulator runs on your Mac's native architecture (x86_64 or Apple Silicon), +which is fundamentally different from the ARM environment on real iOS devices. +Because the patching mechanism is built specifically for the iOS device runtime, +it cannot function in the simulator. + +To test patches on iOS, you will need to use a physical iOS device. + ## Technical Details ### What does the Shorebird updater store on disk?