Configurar o compartilhamento de contexto com arquivos .aiexclude
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Ao ativar o compartilhamento do contexto do projeto com o Gemini no Android Studio,
você pode controlar quais arquivos específicos da base de código são compartilhados usando
arquivos .aiexclude. Os recursos de IA no Android Studio não podem acessar arquivos fora do projeto atual e das raízes de controle de versão anexadas a ele. Com isso em mente, você pode colocar arquivos .aiexclude em qualquer lugar do projeto e nas raízes do VCS para controlar quais arquivos os recursos de IA podem acessar.
Assim como um arquivo .gitignore, um arquivo .aiexclude rastreia arquivos que não devem ser compartilhados com o Gemini no Android Studio, incluindo a experiência de conversa e os recursos de IA que operam no editor, como o preenchimento de código. Um arquivo
.aiexclude opera em arquivos no diretório que o contém ou abaixo dele.
Como escrever arquivos .aiexclude
Um arquivo .aiexclude segue a mesma sintaxe de um
arquivo .gitignore.
Exemplos
Confira alguns exemplos de configurações de arquivo .aiexclude:
- O padrão
KEYS bloqueia todos os arquivos chamados "KEYS" sem extensão de arquivo no diretório ou abaixo dele que contém o arquivo .aiexclude.
KEYS
- O padrão
KEYS.* bloqueia todos os arquivos chamados "KEYS" com qualquer extensão de arquivo no diretório ou abaixo dele que contém o .arquivo aiexclude.
KEYS.*
- O padrão
*.kt bloqueia todos os arquivos Kotlin ou arquivos com a extensão .kt no diretório ou abaixo dele que contém o arquivo .aiexclude.
*.kt
- O padrão
/*.kt bloqueia todos os arquivos .kt no diretório .aiexclude, mas não abaixo dele.
/*.kt
- O padrão
my/sensitive/dir/ bloqueia todos os arquivos no diretório my/sensitive/dir e abaixo dele. O caminho do arquivo é relativo ao diretório que contém o arquivo .aiexclude.
my/sensitive/dir/
- O padrão
my/sensitive/dir/**/.txt bloqueia todos os arquivos .txt no diretório my/sensitive/dir/ ou abaixo dele.
my/sensitive/dir/**/.txt
- O padrão
my/sensitive/dir/*.txt bloqueia todos os arquivos .txt no diretório my/sensitive/dir, mas não nos subdiretórios.
my/sensitive/dir/*.txt
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-31 UTC.
[null,null,["Última atualização 2025-07-31 UTC."],[],[],null,["# Configure context sharing with .aiexclude files\n\nWhen you opt in to sharing your project context with Gemini in Android Studio,\nyou can control which files specifically from the codebase are shared using\n`.aiexclude` files. AI features in Android Studio cannot access files outside of\nthe current project and the version control roots attached to it. With this in\nmind, you can place `.aiexclude` files anywhere within the project and its VCS\nroots to control which files AI features are allowed to access.\n\nMuch like a `.gitignore` file, an `.aiexclude` file tracks files that shouldn't\nbe shared with Gemini in Android Studio, including the chat experience as well\nas AI features that operate in the editor, like [code completion](/studio/gemini/code-completion). An\n`.aiexclude` file operates on files at or below the directory that contains it.\n\nHow to write `.aiexclude` files\n-------------------------------\n\nAn `.aiexclude` file follow the same syntax as a\n[`.gitignore` file](https://git-scm.com/docs/gitignore).\n\nExamples\n--------\n\nHere are example `.aiexclude` file configurations:\n\n- The pattern `KEYS` blocks all files called \"KEYS\" with no file extension at or below the directory that contains the `.aiexclude` file.\n\n KEYS\n\n- The pattern `KEYS.*` blocks all files called \"KEYS\" with any file extension at or below the directory that contains the .`aiexclude` file.\n\n KEYS.*\n\n- The pattern `*.kt` blocks all Kotlin files, or files with the extension `.kt`, at or below the directory that contains the `.aiexclude` file.\n\n *.kt\n\n- The pattern `/*.kt` blocks all `.kt` files in the `.aiexclude` directory, but not below.\n\n /*.kt\n\n- The pattern `my/sensitive/dir/` blocks all files in the `my/sensitive/dir` directory and below. The file path is relative to the directory that contains the `.aiexclude` file.\n\n my/sensitive/dir/\n\n- The pattern `my/sensitive/dir/**/.txt` blocks all `.txt` files at or below the directory `my/sensitive/dir/`.\n\n my/sensitive/dir/**/.txt\n\n- The pattern `my/sensitive/dir/*.txt` blocks all `.txt` files in the directory `my/sensitive/dir`, but not in sub-directories.\n\n my/sensitive/dir/*.txt"]]
