Terminato sviluppo della versione 1.0.0 ! Ricontrollare tutto e correggere possibili errori ortografici e rimuovere cartelle inutili.

Novità App

• Selezione/Rimozione PDF: aggiunta la possibilità di selezionare un pdf dalla memoria del cellulare. Non serve più aggiungerlo tra gli asset e poi generare la build. Il PDF può anche essere rimosso per poterne scegliere un altro. Il PDF viene salvato nella memoria interna dell'app quindi l'originale può anche essere rimosso. C'è una pagina apposta per la selezione del PDF.
• Sistema di Aggiornamenti: Introdotto sistema di aggiornamenti che all'avvio dell'app controlla se c'è una nuova release nella repo di GitHub (controlla se la versione dell'ultima release è più aggiornata della versione in locale). Il controllo della nuova versione viene fatto all'avvio dell'app ma può essere ripetuto in qualsiasi momento tramite un bottone. Il sistema di aggiornamento rimanda alla pagina GitHub della repo.
• Migliorata performance PDF: è stato migliorato il modo in cui viene visualizzato il PDF. Ora il PDF viene pre-caricato e solo quando tutte le pagine sono renderizzate vengono mostrate. Questo per evitare qualunque tipo di lag durante la lettura del PDF. È meglio aspettare un po di tempo e avere tutto che funziona che poter vedere subito le prime pagine ma aspettare tempo quando devo saltare da una sezione all'altra. Questa fase può richiedere abbastanza tempo e non può essere interrotta. Lagga tutto ma ho cercato di fare in modo di non farlo notare 🦧 .

Novità Repo

• Aggiunte gif che mostrano il funzionamento delle principali funzioni
• Aggiunta sezione Features dove vengono elencate le principali funzioni
• Modificata sezione Build from Source
• Aggiunte emoji ai tioli
• Aggiunta sezione Future Updates

Issues

• 🟡 Problema con Visualizzatore PDF: il widget che mostra tutte le pagine del PDF ha un problema con la gestione del contesto e dell'albero dei widget. È stata trovata una soluzione temporanea sostituendo una dipendenza con una repo fatta da un utente su Github https://github.com/ncvescera/KeepReading/blob/9dca6ea5a3a440e4cc501a7076db6db1ee63cbab/KeepReading/pubspec.yaml#L46-L50
• 🔴 Problema con il renderer PDF: renderizzare tutte le pagine prima di mostrarle può risultare un compito molto faticoso e che richiede abbastanza tempo. Non è possibile mettere questa fase in un thread separato (Isolate) dato che sembra esserci un errore nel codice del PDF renderer: issue renderer. Ho fatto di tutto per non far vedere il lag mostruoso che viene generato evitando di mostrare widget con cui l'utente possa interagire. Il problema principale è che questa fase non può essere interrotta ! Se l'utente vuole rimuovere il pdf deve per forza aspettare che venga tutto caricato.

Per come è scritto il codie per poter invocare una funzione di un Widget da un altro widget gli va passata come parametro. https://github.com/ncvescera/KeepReading/blob/ad27ef0fa2a72fee6f2ef5a19789cba0b5aabf25/KeepReading/lib/page/home_page.dart#L56-L67 Questa riga mostra questo esempio: la funzione _checkUpdateOnStart viene passata al Widget che poi la usa al suo interno in qualche punto https://github.com/ncvescera/KeepReading/blob/ad27ef0fa2a72fee6f2ef5a19789cba0b5aabf25/KeepReading/lib/page/home_page.dart#L64

Questo, fin quando si tratta di passare una funzione ad un widget va bene, ma inizia a sorgere un problema di comprensione del codice quando quella funzione deve essere passata ad un Widget che la passa ad un Widget che la passa ad un Widget ecc.

Ho trovato un modo per semplificare il tutto che permette di invocare una funzione direttamente dal Widget che ne ha bisogno senza dover ricorrere a questo passaggio. Lo svantaggio è che va esposto lo stato del Widget che contiene la funzione in questione e serve quindi una gestione degli attributi e degli altri metodi migliroe (le variabili/metodi che devono essere privati vanno messi privati per bene).

Il metodo funziona così:

Espongo lo stato del widget dove è contenuta la funzione che voglio che venga utilizzata da altri widget.

class HomePage extends StatefulWidget {
  const HomePage({
    Key? key,
    required this.appName,
  }) : super(key: key);

  final String appName;
 
  // esposizione dello stato del widget
  static of(BuildContext context, {bool root = false}) => root
      ? context.findRootAncestorStateOfType<_HomePageState>()
      : context.findAncestorStateOfType<_HomePageState>();
  // ------------- //
  @override
  State<HomePage> createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  void myFunction() {
     print('FUNZIONO');
  }

  ...

Utilizzo quindi la funzione che voglio all'interno di un altro widget.

... 

class _MyAppBarState extends State<MyAppBar> {

  void aFunction() {
     HomePage.of(context).myFunction();
  }
 
  ...

TODO:

• [ ] Testare questo metodo e vedere se migliora effettivamente la lettura del codice e non peggiora le performance
  • [ ] Implementarlo !