Skip to content

docs: Warn about 16 KB alignment issue in 8.17.0#6397

Merged
antonis merged 1 commit into
mainfrom
changelog/8.17.0-16kb-warning
Jul 3, 2026
Merged

docs: Warn about 16 KB alignment issue in 8.17.0#6397
antonis merged 1 commit into
mainfrom
changelog/8.17.0-16kb-warning

Conversation

@antonis

@antonis antonis commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

📢 Type of change

  • Bugfix
  • New feature
  • Enhancement
  • Refactoring

📜 Description

Adds a known-issue warning to the 8.17.0 section of CHANGELOG.md, matching the existing 8.11.0 warning format, directing affected users to 8.17.1:

⚠️ Known Issue (Android): Apps built with the New Architecture on sentry-react-native 8.17.0 bundle a native library (libsentry-tm-perf-logger.so) that is not 16 KB page aligned, which breaks 16 KB page size compatibility on Android 15+ (and fails Google Play's 16 KB requirement). See #6394. Please use 8.17.1.

💡 Motivation and Context

8.17.0 shipped a New Architecture native library that is only 4 KB aligned, breaking 16 KB page size compatibility on Android 15+ and failing Google Play's 16 KB requirement (#6394). This warns users on the affected version to upgrade. The actual fix lives in #6396.

Related: #6394, #6396.

💚 How did you test it?

Documentation-only change. Verified the markdown renders as a warning callout and matches the existing 8.11.0 warning style.

📝 Checklist

  • I added tests to verify changes.
  • No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled.
  • I updated the docs if needed.
  • I updated the wizard if needed.
  • All tests passing.
  • Public API changes reviewed by another Mobile SDK team member or implemented according to the develop docs spec.
  • No breaking changes.

🔮 Next steps

The 8.17.1 release/tag referenced by the warning must be published for the link to resolve. Merge alongside cutting 8.17.1 (which should include #6396).

🤖 Generated with Claude Code

Adds a known-issue warning to the 8.17.0 changelog section pointing users
to 8.17.1, which ships the fix for the misaligned
libsentry-tm-perf-logger.so native library.

See #6394

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Semver Impact of This PR

None (no version bump detected)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).


  • docs: Warn about 16 KB alignment issue in 8.17.0 by antonis in #6397
  • chore(deps): update Sentry Android Gradle Plugin to v6.14.0 by github-actions in #6395

🤖 This preview updates automatically when you update the PR.

@github-actions

github-actions Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor
Fails
🚫 Pull request is not ready for merge, please add the "ready-to-merge" label to the pull request

Generated by 🚫 dangerJS against 40d3288

@antonis antonis marked this pull request as ready for review July 3, 2026 09:03
@antonis antonis merged commit c681cc5 into main Jul 3, 2026
80 of 89 checks passed
@antonis antonis deleted the changelog/8.17.0-16kb-warning branch July 3, 2026 09:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants