From 4ad7ed580f1b4cdd4bf9297f6c93392277412281 Mon Sep 17 00:00:00 2001 From: Denis Andrasec Date: Tue, 26 Nov 2024 16:22:41 +0100 Subject: [PATCH 1/4] add to troubleshooting guide --- docs/platforms/flutter/troubleshooting.mdx | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/platforms/flutter/troubleshooting.mdx b/docs/platforms/flutter/troubleshooting.mdx index 77686ae8e0f06..6f7b44f1f303e 100644 --- a/docs/platforms/flutter/troubleshooting.mdx +++ b/docs/platforms/flutter/troubleshooting.mdx @@ -33,6 +33,14 @@ flutter build apk --target-platform=android-arm --split-per-abi The configuration for symbolication of Native events (C/C++) is documented in our [Android Native Development Kit](/platforms/android/configuration/using-ndk/) content. If you are having issues with symbolication in Flutter, check that your configuration is correct, as discussed in our Flutter content that covers [Uploading for Android NDK](/platforms/flutter/upload-debug/#uploading-for-android-ndk) +## Support 16 KB Page Sizes on Android + +Starting with Android 15, AOSP supports devices with a 16 KB page size. If your app uses NDK libraries (directly or via an SDK), you’ll need to rebuild it for compatibility with these devices. + +Update to Sentry Flutter SDK version `8.11.0` and above order to support 16 KB page sizes on Andorid devices. + +Please read the [Andorid developer documentation](https://developer.android.com/guide/practices/page-sizes) to update and test your app with 16 KB page size support. + ## Native Symbolication on iOS/macOS Flutter `split-debug-info` and `obfuscate` flags are supported on iOS/macOS. They require compiling your app using Flutter, version `3.7.0` and above and the Sentry Flutter SDK, version `6.10.0` and above. From f7ca7126643e78db6f5607ec18266136b7409474 Mon Sep 17 00:00:00 2001 From: Denis Andrasec Date: Tue, 26 Nov 2024 16:35:41 +0100 Subject: [PATCH 2/4] add warning alert in flutter index --- docs/platforms/flutter/index.mdx | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/platforms/flutter/index.mdx b/docs/platforms/flutter/index.mdx index 6b8772ae93e5f..31c798af1e996 100644 --- a/docs/platforms/flutter/index.mdx +++ b/docs/platforms/flutter/index.mdx @@ -88,6 +88,11 @@ try { } ``` + + Use Sentry Flutter SDK version `8.11.0` and above to support 16 KB page sizes on Andorid devices, or your app will crash. + Refer to [Troubleshooting](/platforms/flutter/troubleshooting/#support-16-kb-page-sizes-on-android) for more information. + + ## Next Steps - Learn about the features of Sentry's Flutter SDK From c46505d02615513af194b92b1b31073bac63da42 Mon Sep 17 00:00:00 2001 From: Denis Andrasec Date: Mon, 2 Dec 2024 14:13:57 +0100 Subject: [PATCH 3/4] fix android typos --- docs/platforms/flutter/troubleshooting.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/platforms/flutter/troubleshooting.mdx b/docs/platforms/flutter/troubleshooting.mdx index 6f7b44f1f303e..aaf6622afd70e 100644 --- a/docs/platforms/flutter/troubleshooting.mdx +++ b/docs/platforms/flutter/troubleshooting.mdx @@ -37,9 +37,9 @@ The configuration for symbolication of Native events (C/C++) is documented in ou Starting with Android 15, AOSP supports devices with a 16 KB page size. If your app uses NDK libraries (directly or via an SDK), you’ll need to rebuild it for compatibility with these devices. -Update to Sentry Flutter SDK version `8.11.0` and above order to support 16 KB page sizes on Andorid devices. +Update to Sentry Flutter SDK version `8.11.0` and above order to support 16 KB page sizes on Android devices. -Please read the [Andorid developer documentation](https://developer.android.com/guide/practices/page-sizes) to update and test your app with 16 KB page size support. +Please read the [Android developer documentation](https://developer.android.com/guide/practices/page-sizes) to update and test your app with 16 KB page size support. ## Native Symbolication on iOS/macOS From cce45150b159c0964bf58c9284f19055f1ec1df4 Mon Sep 17 00:00:00 2001 From: Denis Andrasec Date: Mon, 9 Dec 2024 11:04:07 +0100 Subject: [PATCH 4/4] remove from getting started and move to top --- docs/platforms/flutter/index.mdx | 5 ----- docs/platforms/flutter/troubleshooting.mdx | 16 ++++++++-------- 2 files changed, 8 insertions(+), 13 deletions(-) diff --git a/docs/platforms/flutter/index.mdx b/docs/platforms/flutter/index.mdx index 31c798af1e996..6b8772ae93e5f 100644 --- a/docs/platforms/flutter/index.mdx +++ b/docs/platforms/flutter/index.mdx @@ -88,11 +88,6 @@ try { } ``` - - Use Sentry Flutter SDK version `8.11.0` and above to support 16 KB page sizes on Andorid devices, or your app will crash. - Refer to [Troubleshooting](/platforms/flutter/troubleshooting/#support-16-kb-page-sizes-on-android) for more information. - - ## Next Steps - Learn about the features of Sentry's Flutter SDK diff --git a/docs/platforms/flutter/troubleshooting.mdx b/docs/platforms/flutter/troubleshooting.mdx index aaf6622afd70e..733c581790908 100644 --- a/docs/platforms/flutter/troubleshooting.mdx +++ b/docs/platforms/flutter/troubleshooting.mdx @@ -6,6 +6,14 @@ sidebar_order: 9000 If you need help solving issues with Sentry's Flutter SDK, you can read the edge cases documented here. If you need additional help, you can [ask on GitHub](https://github.com/getsentry/sentry-dart/issues/new/choose). Customers on a paid plan may also contact support. +## Support 16 KB Page Sizes on Android + +Starting with Android 15, AOSP supports devices with a 16 KB page size. If your app uses NDK libraries (directly or via an SDK), you’ll need to rebuild it for compatibility with these devices. + +Update to Sentry Flutter SDK version `8.11.0` and above order to support 16 KB page sizes on Android devices. + +Please read the [Android developer documentation](https://developer.android.com/guide/practices/page-sizes) to update and test your app with 16 KB page size support. + ## "Missing API declaration" after App Store review Starting May 1, 2024, Apple requires all apps submitted to the App Store to provide a list of privacy-related APIs they use, including the reasons under which they use it. If you received an email from Apple with the message "ITMS-91053: Missing API declaration", your app doesn't fulfill the requirements. To solve this, follow our [Apple Privacy Manifest](/platforms/flutter/data-management/apple-privacy-manifest) guide. @@ -33,14 +41,6 @@ flutter build apk --target-platform=android-arm --split-per-abi The configuration for symbolication of Native events (C/C++) is documented in our [Android Native Development Kit](/platforms/android/configuration/using-ndk/) content. If you are having issues with symbolication in Flutter, check that your configuration is correct, as discussed in our Flutter content that covers [Uploading for Android NDK](/platforms/flutter/upload-debug/#uploading-for-android-ndk) -## Support 16 KB Page Sizes on Android - -Starting with Android 15, AOSP supports devices with a 16 KB page size. If your app uses NDK libraries (directly or via an SDK), you’ll need to rebuild it for compatibility with these devices. - -Update to Sentry Flutter SDK version `8.11.0` and above order to support 16 KB page sizes on Android devices. - -Please read the [Android developer documentation](https://developer.android.com/guide/practices/page-sizes) to update and test your app with 16 KB page size support. - ## Native Symbolication on iOS/macOS Flutter `split-debug-info` and `obfuscate` flags are supported on iOS/macOS. They require compiling your app using Flutter, version `3.7.0` and above and the Sentry Flutter SDK, version `6.10.0` and above.