flutteradgents library

Classes

AdgentsReportFormAttachmentsScope

Données de prévisualisation pour AdgentsReportFormBuilder (capture écran annotée).

AdgentsReportPayload

Container for le rapport utilisateur (texte + capture + métadonnées).

AdgentsReportScope

A feedback widget that uses a custom widget and data type for prompting the user for their feedback. This widget should be the root of your widget tree. Specifically, it should be above any Navigator widgets, including the navigator provided by MaterialApp.

AdgentsReportSession

Controls the state of the feeback ui.

AdgentsReportSheetGrip

Poignée visuelle pour une feuille de saisie draggable.

AdgentsReportStrings

This class must be extended by all custom translations.

AdgentsReportStyle

See the following image to get a better understanding of the properties.

AdgentsReportStyleScope

Provides an instance of AdgentsReportStyle for all descendants.

AdgentsReportTicketFormDraft

Brouillon du formulaire ticket (restauré après annotation ou nouvelle capture).

ArAdgentsReportStrings

Default arabic localization

AtlassianOAuthLoginStart

Réponse de GET /api/v1/auth/oauth/atlassian/authorization-url.

BgAdgentsReportStrings

Default bulgarian localization

BnAdgentsReportStrings

Default bangla localization

DeAdgentsReportStrings

Default german localization

ElAdgentsReportStrings

Default greek localization

EnAdgentsReportStrings

Default english localization

EsAdgentsReportStrings

Default spanish localization

FaAdgentsReportStrings

Default persian localization

Flutteradgents

Package entry points: open the feedback flow + submit issues.

FlutteradgentsConfigurationError

Shown when FlutteradgentsSettings.simple cannot be built (e.g. empty projectId).

FlutteradgentsHosts

Enveloppe l’app avec AdgentsReportScope (capture intégrée) et fournit FlutteradgentsInherited (réglages + session + client HTTP).

FlutteradgentsInherited

FlutteradgentsOAuthReturnListener

Écoute les deep links natifs (AppLinks) et, sur le web, l’URL initiale (Uri.base) pour finaliser OAuth via FlutteradgentsSession.signInWithOAuthExchangeCode.

FlutteradgentsOAuthReturnOutcome

Résultat du traitement d’une URL de retour OAuth (oauth_exchange ou oauth_error).

FlutteradgentsSecretTapScope

Déclenche l’action après requiredTapCount appuis dans la fenêtre resetDuration.

FlutteradgentsSession

Session JWT en mémoire + refresh token persisté ; met à jour l’en-tête Authorization du Dio.

FlutteradgentsSettings

Paramètres du SDK : URL de l’API (résolue automatiquement si omise) et projet cible.

FrAdgentsReportStrings

Default french localization

GlobalAdgentsReportStringsDelegate

This is a localization delegate, which includes all of the localizations already present in this library.

HeAdgentsReportStrings

Default Henrew localization

IssueCreateResult

Réponse JSON de création d’issue (permet de savoir si Jira a bien reçu le ticket).

JaAdgentsReportStrings

Default japanese localization

JiraAssignableUser

Utilisateur renvoyé par GET …/jira/assignable-users (proxy Jira assignable search).

JiraAssignableUsersApi

GET /api/v1/projects/{projectId}/jira/assignable-users

PlAdgentsReportStrings

Default polish localization

PtAdgentsReportStrings

Default portuguese localization

RuAdgentsReportStrings

Default russian localization

SvAdgentsReportStrings

Default swedish localization

TrAdgentsReportStrings

Default turkish localization

UkAdgentsReportStrings

Default ukrainian localization

ZhAdgentsReportStrings

Default Simplified Chinese localization

Enums

AdgentsReportMode

Available modes of the feedback ui.

AtlassianOAuthSignInOutcome

Result of the Atlassian OAuth flow (JWT sign-in).

FlutteradgentsClientPlatform

Plateforme client pour les issues (alignée sur l’API Spring Platform).

IssueSyncStatus

Statut renvoyé par POST …/issues (aligné sur IssueStatus côté API).

Constants

kFlutteradgentsDefaultHostedApiBaseUrl → const String

Hôte API hors debug quand aucun dart-define d’URL n’est fourni.

kFlutteradgentsDefaultOAuthPath → const String

Chemin du deep link OAuth (souvent oauth → monschema://oauth).

kFlutteradgentsDefaultOAuthScheme → const String

Schéma du deep link OAuth par défaut : même valeur dans AndroidManifest / Info.plist. Si votre app en utilise un autre, passez oauthScheme à FlutteradgentsSettings.simple.

kFlutteradgentsFeedbackExtraAssigneeAccountId → const String

accountId Jira (multipart jiraAssigneeAccountId sur POST …/issues).

kFlutteradgentsFeedbackExtraDescription → const String

kFlutteradgentsFeedbackExtraTitle → const String

Clés AdgentsReportPayload.extra (formulaire titre + description).

kFlutteradgentsSdkDefaultFlavor → const String

Valeur du champ environment côté API pour les issues (mode FlutteradgentsSettings.simple).

kIssueTitleMaxLength → const int

Functions

completeSessionWithAtlassianOAuth({required BuildContext context, required FlutteradgentsSession session, String? inviteToken, String? oauthLoginReturnUri, bool allowServerDefaultReturnUri = false, String? projectId}) → Future<AtlassianOAuthSignInOutcome>

Starts Atlassian OAuth (browser), then obtains a JWT via oauth_exchange or a dialog.

detectFlutteradgentsClientPlatform({bool? forTestsIsWeb, TargetPlatform? forTestsTarget}) → FlutteradgentsClientPlatform

Détecte la plateforme d’exécution (alignée sur l’enum API Platform).

effectiveClientPlatform(FlutteradgentsSettings settings) → FlutteradgentsClientPlatform

Plateforme effective : réglage explicite ou détection auto.

enrichIssueDescriptionWithFullMetadata(String userDescription, FlutteradgentsSettings settings) → Future<String>

Enrichit la description : bloc unique en anglais avec emojis (environment, platform, device, build number, version, app name).

environmentForApi(FlutteradgentsSettings settings) → String?

Champ environment multipart : priorité au flavor, sinon FlutteradgentsSettings.defaultEnvironment.

flutteradgentsIssueFeedbackBuilder(BuildContext context, AdgentsReportFormSubmit onSubmit, ScrollController? scrollController, {Uint8List? gifAttachmentPreviewBytes, VoidCallback? onBackToGifPreview}) → Widget

Default AdgentsReportFormBuilder: title + description + optional Jira assignee (API-aligned).

flutteradgentsNavigatorContextForOverlay(BuildContext scope) → BuildContext?

Contexte adapté pour Navigator.push / Flutteradgents.showFeedback : d’abord Navigator.maybeOf, sinon premier NavigatorState dans le sous-arbre de scope.

isNativeOauthDeepLinkReturnUri(String? returnUri) → bool

true if returnUri uses a scheme other than http / https (e.g. myapp://oauth).

issueDescriptionForApi(AdgentsReportPayload feedback) → String

Description pour l’API.

issueJiraAssigneeAccountIdForApi(AdgentsReportPayload feedback) → String?

Assigné Jira optionnel pour la création du ticket.

issueTitleForApi(AdgentsReportPayload feedback) → String

Titre pour POST …/issues : champ dédié ou repli sur le texte unique historique.

normalizeUserIssueDescription(String userDescription) → String

User-entered text only ; English placeholder if empty.

pushFlutteradgentsSignInPage(BuildContext context, {required FlutteradgentsSession session, String? inviteToken}) → Future<bool>

Full-screen sign-in page (JWT). Returns true via Navigator.pop on success.

showFlutteradgentsSignInDialog(BuildContext context, {required FlutteradgentsSession session, String? inviteToken}) → Future<bool>

Simple dialog: Atlassian OAuth or email / password; returns true if sign-in succeeded.

Typedefs

AdgentsReportFormBuilder = Widget Function(BuildContext, AdgentsReportFormSubmit , ScrollController?)

Contenu du panneau / feuille de saisie.

AdgentsReportFormSubmit = Future<void> Function(String feedback, {Map<String, dynamic>? extras, Uint8List? gifAttachment})

Soumission du formulaire de rapport (texte + extras + GIF optionnel depuis le formulaire).

AdgentsReportListener = FutureOr<void> Function(AdgentsReportPayload)

Après capture + envoi du AdgentsReportPayload.

FlutteradgentsBeginGifRecordingFlow = void Function(BuildContext navigatorAnchorContext)

Ancre BuildContext (souvent celui du Navigator) pour ouvrir feuilles / snackbars après GIF.

FlutteradgentsBeginGifRecordingForTicketForm = void Function(BuildContext navigatorAnchorContext, void onGifReady(Uint8List gifBytes))

Enregistrement GIF depuis le formulaire ticket : le GIF est renvoyé dans onGifReady sans ouvrir une 2ᵉ feuille.

FlutteradgentsOnOAuthReturn = void Function(BuildContext context, FlutteradgentsOAuthReturnOutcome outcome)

FlutteradgentsShowScreenCaptureControlSheet = void Function(BuildContext navigatorAnchorContext)

Feuille de contrôle après fermeture du ticket (annotation sur l’écran).

Exceptions / Errors

FlutteradgentsApiException