Skip to content

Clarify ActivityAware v1 embedding support#186565

Open
mvincentong wants to merge 1 commit into
flutter:mainfrom
mvincentong:docs-activityaware-v1-embedding
Open

Clarify ActivityAware v1 embedding support#186565
mvincentong wants to merge 1 commit into
flutter:mainfrom
mvincentong:docs-activityaware-v1-embedding

Conversation

@mvincentong
Copy link
Copy Markdown

Fixes #59556

Description

ActivityAware is part of the v2 Android embedding, but the existing Javadocs did not say what happens for pre-1.12 projects still using the v1 embedding. This clarifies that v1 embedding projects invoke a plugin static registerWith path instead and do not call ActivityAware callbacks.

The change updates the ActivityAware Javadoc, the related FlutterPlugin overview, and the local pre-1.12 Android migration note.

Tests

  • git diff --check

Not run: engine Java formatting, because this checkout does not have the hermetic Java/google-java-format artifacts under engine/src/flutter/third_party without gclient sync.

Risk

Docs-only change. No generated output.

@mvincentong mvincentong requested a review from a team as a code owner May 15, 2026 08:34
@mvincentong mvincentong requested review from camsim99 and removed request for a team May 15, 2026 08:34
@github-actions github-actions Bot added platform-android Android applications specifically engine flutter/engine related. See also e: labels. team-android Owned by Android platform team d: docs/ flutter/flutter/docs, for contributors labels May 15, 2026
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the Android migration documentation and plugin Javadocs to clarify that ActivityAware callbacks are exclusive to the v2 embedding, requiring plugin authors to maintain registerWith for backward compatibility with pre-1.12 projects. The review feedback suggests improving technical precision by explicitly mentioning 'callbacks' instead of the interface name and optimizing Javadoc tags for better navigation and tool compatibility.

Comment thread docs/platforms/android/Upgrading-pre-1.12-Android-projects.md Outdated
@mvincentong mvincentong force-pushed the docs-activityaware-v1-embedding branch from 9c3425b to e8ebcae Compare May 15, 2026 08:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

d: docs/ flutter/flutter/docs, for contributors engine flutter/engine related. See also e: labels. platform-android Android applications specifically team-android Owned by Android platform team

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant