Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

[📚] firebase_ai works on Windows, but pub.dev and the docs don't list it

Cerrado Apto para principiantes
  • ¿Algo no está bien?
#18,720 1 comentario 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
72/100
Tipo de issue
Documentación
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
dart, flutter
Área
documentation

Línea de trabajo

Comienza con la documentación de firebase_ai, pubspec y platform_header_helper.dart; después compara la lista de plataformas documentada con el comportamiento de Windows descrito aquí. Documenta la compatibilidad con Windows y sus limitaciones de API-key y App Check; si se actualiza la declaración de plataforma, confirma que pub.dev incluye Windows y prueba el paquete en Windows.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Needs Attention platform: windows plugin: ai type: documentation
Summary

firebase_ai works on Windows desktop, but nothing says so. The pub.dev page lists Android, iOS, macOS and web, and the Firebase AI Logic Flutter docs don't mention Windows. We assumed it was unsupported and kept it disabled on Windows in our app until we tested it.

What we tested

Windows 10 22H2, debug builds:

  • A minimal Flutter app with firebase_ai 3.15.0 and again with 4.0.0: Firebase.initializeApp(options: DefaultFirebaseOptions.windows), then FirebaseAI.agentPlatform(location: 'us-central1').generativeModel(model: 'gemini-2.5-flash-lite'). generateContent and generateContentStream both returned complete responses. No signed-in user, no App Check.
  • Our production app on 3.15.0, as an integration test with a signed-in Firebase Auth user: generateContent and generateContentStream at us-east5 both returned complete responses.

We also called the REST endpoint directly with the Windows app's API key and no identity headers; global, us-central1, us-east5 and europe-west4 all answered.

Why it works

The package's only native code is the getPlatformHeaders method channel, which supplies the API-key identity headers (X-Android-Package / X-Android-Cert, x-ios-bundle-identifier). On Windows no plugin is registered, so getPlatformSecurityHeaders() in platform_header_helper.dart catches the missing channel and sends no identity headers, the same path web takes. Everything else is plain Dart HTTP.

pub.dev derives its platform tags from flutter.plugin.platforms in the pubspec. There is no windows entry, so the package shows as unsupported there.

Suggestion
  • Document Windows as supported, with the two caveats that come from having no native plugin: the API key can't be restricted to a Windows app identity (it behaves like the web key), and there is no Windows App Check provider, so enforcing App Check for AI Logic would block Windows clients.
  • Optionally declare Windows in the pubspec (a dartPluginClass, or whatever you prefer) so pub.dev lists the platform.

Happy to test a change on Windows.

Lenguaje dominante
Dart
Estrellas
9.3k
Forks
4.1k
Merge medio
1 d 14 h
PR fusionados (30 d)
39

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de firebase/flutterfire

Todos los issues de firebase/flutterfire

Issues similares

Más issues de Dart

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.