Eva Login Module
================

**Introduzione**
~~~~~~~~~~~~~~~~

Eva Login Module è una libreria scritta in Dart, utilizzata per i processi di login di un progetto Flutter, fornisce 3 diversi processi di Login

* Classic
* OTP (One Time Password)
* Azure

**Getting Started**
~~~~~~~~~~~~~~~~~~~

Aggiungi al file ``podspec.yaml``

.. code-block::

    dependencies:
      flutter:
        sdk: flutter
      eva_login:
        git:
          ref: develop
          url: git@gitlab.localmonks.net:adam/flutter/eva-modules/eva-login.git

Esegui ``flutter pub get`` sulla cartella del progetto

**Usage**
~~~~~~~~~~

Eva Login Module fornisce una classe widget per ogni metodo di autenticazione



**Login OTP**

Il widget fornito per l'autenticazione OTP è ``LoginOtpRoute``
e richiede 8 parametri di inizializzazione

* ``appLogo``: variabile di tipo ``SvgPicture``, utilizzata per mostrare un logo personalizzato nel processo di login
* ``targetRoute``: variable di tipo ``Widget``, indica la route di destinazione completato il processo di login
* ``endPoint`` e ``apiVersion``: variabili di tipo ``String``, l'endpoint verso il quale effettuare le richieste http di login
* ``domain``, ``appName``, ``appVersion``; variabili di tipo ``String``, richiesti per l'autenticazione xmpp

di seguito un esempio di utilizzo:

.. code-block:: dart

  Get.off(() => LoginOtpRoute(
    appLogo: SvgPicture.asset("app_logo.svg"),
    targetRoute: const HomePageRoute(),
    endPoint: "https://<endpoint>",
    apiVersion: "v1",
    domain: "<domain>",
    appName: "<appName>",
    appVersion: "0.0.1",
    services: AdamRestServicesPool(),
  ));


**Login Classic**

Il widget fornito per l'autenticazione Classic è ``EvaClassicLoginRoute``
e richiede 4 parametri di inizializzazione

* ``targetRoute``: variable di tipo ``Widget``, indica la route di destinazione completato il processo di login
* ``loginSuccessCallback``: variable di tipo ``Function``, callback che viene invocata completata la login
* ``logoAsset``: variabile di tipo ``String``, utilizzata per mostrare un logo personalizzato durante il processo di login

esempio di utilizzo:

.. code-block:: dart

  Get.off(() => EvaClassicLoginRoute(
    logoAsset: "app_logo.svg",
    targetRoute: const HomePageRoute(),
    loginSuccessCallback: (result) {
      //some logic here
    },
    services: AdamRestServicesPool(),
  ));


**Login Azure**

Questa sezione è ancora da completare, in quanto il processo di autenticazione Azure non è, al momento della scrittura di questa documentazione, disponibile.