Skip to main content
Version: Next

Integració Flutter

Patrons recomanats per integrar l'SDK Eixam a la teva app amfitriona Flutter.

Patró recomanat​

Crea una instància de l'SDK durant el bootstrap de l'app i injecta-la al teu estat o contenidor de dependències:

class AppBootstrapper {
  Future<EixamConnectSdk> createSdk(EixamSession session) {
    return EixamConnectSdk.bootstrap(
      EixamBootstrapConfig(
        appId: session.appId,
        environment: EixamEnvironment.sandbox,
        initialSession: session,
      ),
    );
  }
}

Regla de l'app amfitriona lleugera​

Mantén la teva app amfitriona lleugera. L'SDK posseeix la lògica central de seguretat i runtime — la teva app posseeix la UX i la navegació.

La teva app amfitriona ha de:

  • Posseir la UX i la navegació
  • Sol·licitar permisos intencionalment
  • Subscriure's als streams de l'SDK
  • Cridar els mètodes de l'SDK

La teva app amfitriona no ha de:

  • Recrear lògica operacional de backend que ja posseeix l'SDK
  • Parsejar el protocol BLE directament en widgets
  • Codificar en dur lògica de transport o topics

Actualització de sessió​

await sdk.setSession(
  const EixamSession.signed(
    appId: 'partner-app',
    externalUserId: 'partner-user-123',
    userHash: 'signed-session-hash-rotated',
  ),
);
await sdk.refreshCanonicalIdentity();

Recomanacions de cicle de vida​

  • Fes el bootstrap una sola vegada per inici d'app
  • Mantén una sola instància de l'SDK activa
  • Actualitza la sessió explícitament quan el login o logout canviï la identitat