Skip to content

Conversation

@sfshaza2
Copy link
Contributor

Fixes #12960. Clarifies that the .android folder is ephemeral and that native code should be placed in Plugins or the Host App.

@sfshaza2 sfshaza2 requested a review from a team as a code owner January 21, 2026 18:40
@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @sfshaza2, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request enhances the clarity of the Flutter documentation regarding the integration of Flutter modules into Android applications. The primary goal is to prevent developers from incorrectly placing native code within the ephemeral .android directory by providing explicit warnings and guiding them towards the correct patterns of using Flutter Plugins for module-specific code or the host app for app-specific native functionality.

Highlights

  • Documentation Update: The documentation for integrating Flutter modules into existing Android applications has been updated to provide clearer guidance on where to place native code.
  • .android Folder Clarification: A new warning explicitly states that the .android directory is ephemeral, generated for testing purposes, and should not be used for custom native functionality as its contents will be overwritten by flutter pub get or module builds.
  • Native Code Placement Guidance: Clear instructions are now provided for developers: module-specific native code should be implemented in Flutter Plugins, while app-specific native code should be added directly to the existing Android host application.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
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 significantly improves the documentation by clarifying where to place native code in Flutter modules. The new warning block is much clearer and more direct than the previous note, effectively highlighting a common pitfall for developers. The guidance on using plugins for module-specific code and the host app for app-specific code is excellent. The added explanation about the .android directory's purpose and its use of Java is also very helpful. Overall, this is a high-quality documentation update.

@sfshaza2 sfshaza2 requested a review from camsim99 January 21, 2026 18:47
@flutter-website-bot
Copy link
Collaborator

flutter-website-bot commented Jan 21, 2026

Visit the preview URL for this PR (updated for commit e50d50e):

https://flutter-docs-prod--pr12968-fix-issue-12960-native-code-ohpeimeg.web.app

Copy link
Contributor

@camsim99 camsim99 left a comment

Choose a reason for hiding this comment

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

LGTM :) just left two wording suggestions

sfshaza2 and others added 4 commits January 22, 2026 11:58
Co-authored-by: Camille Simon <43054281+camsim99@users.noreply.github.com>
_Description of what this PR is changing or adding, and why:_

This adds the new compressed rules files to our docs page.
(flutter/flutter#179817)

_Issues fixed by this PR (if any):_

_PRs or commits this PR depends on (if any):_

## Presubmit checklist

- [x] If you are unwilling, or unable, to sign the CLA, even for a
_tiny_, one-word PR, please file an issue instead of a PR.
- [x] If this PR is not meant to land until a future stable release,
mark it as draft with an explanation.
- [x] This PR follows the [Google Developer Documentation Style
Guidelines](https://developers.google.com/style)—for example, it doesn't
use _i.e._ or _e.g._, and it avoids _I_ and _we_ (first-person
pronouns).
- [x] This PR uses [semantic line
breaks](https://github.com/dart-lang/site-shared/blob/main/doc/writing-for-dart-and-flutter-websites.md#semantic-line-breaks)
  of 80 characters or fewer.

---------

Co-authored-by: Shams Zakhour <44418985+sfshaza2@users.noreply.github.com>
@sfshaza2 sfshaza2 merged commit bf52953 into main Jan 23, 2026
10 checks passed
@sfshaza2 sfshaza2 deleted the fix/issue-12960-native-code-docs branch January 23, 2026 17:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

GENERATING AAR USING PROJCT TYPE MODULE.

5 participants