Skip to content

docs(flutter): Document Android 16KB Page Size #11963

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Dec 10, 2024
Merged

docs(flutter): Document Android 16KB Page Size #11963

Show file tree
Hide file tree
Changes from 4 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
4ad7ed5
add to troubleshooting guide
denrase Nov 26, 2024
f7ca712
add warning alert in flutter index
denrase Nov 26, 2024
2c94d93
Merge branch 'master' into denrase/flutter-android-16kb-page-size
denrase Dec 2, 2024
c46505d
fix android typos
denrase Dec 2, 2024
aee08cf
Merge branch 'master' into denrase/flutter-android-16kb-page-size
denrase Dec 9, 2024
cce4515
remove from getting started and move to top
denrase Dec 9, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions docs/platforms/flutter/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,11 @@ try {
}
```

<Alert level="warning" title="Android 16 KB Page Size">
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.
</Alert>

## Next Steps

- <PlatformLink to="/features">Learn about the features of Sentry's Flutter SDK</PlatformLink>
Expand Down
8 changes: 8 additions & 0 deletions docs/platforms/flutter/troubleshooting.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 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.
Expand Down
Loading