- Introduzione
- Per gli studenti del Sobrero
- Identificatori delle release
- Installazione
- Statistiche in-app
- Licenza
Questa repo contiene il codice sorgente del mySobrero 2.0 - Una rivistazione dell'originale mySobrero rilasciato nel 2015, e oramai non più funzionante.
A differenza del mySobrero originale, compatibile solo con Android, il nuovo mySobrero è compatibile con la maggioranza delle piattaforme attuali: Android ed iOS come piattaforme mobile, Windows, macOS e Linux come piattaforme desktop e Web per le rimanenti piattaforme. La compatibilità cross-platform è garantita da Flutter, framework open-source sviluppato da Google per permettere l'esecuzione della stessa app, dalla stessa base di codice, su molteplici piattaforme.
mySobrero oltre ad essere stato completamente riprogettato da zero, è dotato delle ultime tecnologie per lo sviluppo di app: l'utente non è più limitato al solo registro elettronico, ma le sue credenziali gli danno accesso a tutti i servizi digitali che l'applicazione offre. Se prima era solo una alternativa al registro elettronico, mySobrero adesso è diventato il centro della vita studentesca: oltre a visualizzare i voti, esso permette di leggere le ultime notizie della scuola, partecipare a sondaggi e pubblicare i propri annunci in una bacheca virtuale (Resell@Sobrero).
Tutti i dati vengono salvati su cloud, garantendo oltre alla coerenza dei dati tra dispositivi diversi loggati con lo stesso account, anche la sicurezza degli stessi, essendo salvati su Firebase di Google, piattaforma di eccellenza per lo sviluppo di app cloud.
mySobrero è un progetto enorme, in continua evoluzione dal 2015, e come aumentano gli studenti frequentanti il Sobrero di anno in anno, anche le esigenze aumentano. La varietà degli studenti del Sobrero non assicura la perfetta compatiblità con mySobrero, è per questo che la segnalazione degli errori al team di sviluppo è fondamentale per mantenere elevata l'esperienza utente.
Se si è verificato un errore nell'applicazione oppure si ha qualche idea per l'applicazione, è disponibile il form di supporto a questo link: https://forms.gle/tDt4RZD1XWK5kkH39 (compilabile solo con account @sobrero)
Le release di mySobrero vengono distinte in 4 sottocategorie:
Le release col tag Internal sono le meno stabili, ma allo stesso tempo le più aggiornate e con features nuove. Spesso le build col tag Internal possono fallire nel CI (e anche in un ambiente locale). Sono sempre disponibili versioni per piattaforme non ancora disponibili al pubblico (iOS, macOS, web).
Le release col tag Alpha sono simili alle Internal ma con la sicurezza che possano essere compilate. Su queste build vengono effettuati più test e sono più stabili di quelle Internal.
Esse sono disponibili solo nella scheda Releases di Github, e possono essere compilate anche per piattaforme non ancora disponibili al pubblico.
Le release col tag Beta sono considerate stabili, con feature nuove. Esse sono intese per gli appassionati che vogliono sperimentare con le nuove funzioni dell'Applicazione. Esse sono disponibili solo negli store dei dispositivi (Apple App Store, Google Play Store)
Le release production sono quelle disponibili al pubblico, disponibili solo negli store. Una build per essere considerata Production deve passare tutte e 3 le fasi precedenti.
L'installazione di mySobrero prevede diversi step, sia per preparare l'ambiente di sviluppo che per preparare il dispositivo di destinazione.
mySobrero è basato completamente sul framework Flutter, per procedere con la compilazione dell'applicazione bisogna preparare l'ambiente di sviluppo Flutter nel computer.
L'ambiente Flutter è compatibile con la maggior parte dei sistemi operativi desktop: Windows, macOS, Linux e Chrome OS.
Predisporre l'ambiente di sviluppo secondo le guide linea descritte dalla guida ufficiale: https://flutter.dev/docs/get-started/install
Verificare che l'ambiente di sviluppo sia configurato correttamente lanciando il comando
flutter doctor
da terminale, se il programma segnala errori, utilizzare le guide ufficiali di Google per risolverli.
Assicurarsi che git sia installato sul computer.
Avviare una finestra di terminale (o CMD se su Windows), collocarsi nella cartella dove si vuole che venga clonato il repository e lanciare il seguente comando:
git clone https://github.com/federunco/mySobrero.git mysobrero-repo
Dopo che il comando ha clonato tutto il repository, esso sarà disponibile nella directory "mysobrero-repo".
Indipendentemente dal sistema operativo di destinazione, è consigliabile utilizzare Android Studio come ambiente di sviluppo, essendo attualmente l'IDE supportato maggiormente per lo sviluppo Flutter. Bisognerà inoltre installare il plugin Flutter e Dart per Android Studio.
In base al sistema operativo di destinazione, bisognerà installare diversi strumenti:
- Android
- Android SDK (incluso in Android Studio)
- Dispositivo Android con le impostazioni da sviluppatore abilitate
- Java JDK
- iOS
- Xcode 11 (da App Store, disponibile solo su macOS)
- CocoaPods
Se si sta compilando mySobrero su macOS, dopo aver installato Xcode 11 eseguire i seguenti comandi da terminale:
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch
sudo xcodebuild -license
Testare la configurazione di macOS lanciando il seguente comando (avvio del simulatore)
open -a Simulator
Una volta configurato l'ambiente di sviluppo, aprire il progetto con Android Studio, aprire il file pubspeck.yaml e cliccare "Packages get", qui Android Studio sincronizzerà il progetto con le dipendenze richieste. Se si ha a disposizione il file reapi3.dart (non ancora open-source), spostarlo nella cartella lib.
Ora è possibile compilare l'applicazione: selezionare nel menù in alto a destra il dispositivo di destinazione, dopo averlo collegato al computer, e cliccare dal menù "Run" l'opzione "Flutter run main.dart in Release mode". Il processo di compilazione è lungo, soprattutto la prima volta, attendere col dispositivo di destinazione collegato al computer per tutta la durata dell'operazione.
mySobrero basa i suoi servizi cloud su un server sviluppato appositamente per l'uso esclusivo con l'app. Ogni utente viene autenticato ed allineato tramite il token di accesso a RE generato dall'app, senza trasmettere nessun ID Studente o Password, rendendo estremamente sicura la piattaforma. I dati degli utenti sono protetti con la crittografia SSL (in sviluppo la convalida dei certificati SSL in app), e il server è stato sviluppato secondo le migliori pratiche per evitare attacchi di tipologia SQL-Injection, PHP Injection ecc. Se l'utente accede su più dispositivi allo stesso momento, verrà disconnesso da tutti i dispositivi che non sono quello che ha generato il token di accesso per ultimo, evitando disservizi generati dal disallineamento dei dati.
mySobrero implementa un sistema di SSO (Single Sign On) per accedere a servizi scolastici senza utilizzare password. Il protocollo di autenticazione è basato su SAML2 (possibilità di integrazione con WordPress, Active Directory ecc.) su un endpoint ancora da definire, e solo le app autorizzate a livello server possono usufruirne, proteggendo le informazioni sensibili degli studenti da applicazioni pericolose.
mySobrero raccoglie statistiche anonime riguardo l'utilizzo dell'app, la frequenza di apertura, gli orari e le schermate aperte. Inoltre viene registrata la classe di appartenenza per effetturare statistiche a livello di istituto riguardo l'utilizzo dell'applicazione. I dati raccolti sono compatibili con il regolamento GDPR dell'istituto, installando l'applicazione si accetta il trattamento dei dati.
Copyright 2020 (c) I.S. "A. Sobrero" / Federico Runco
Il codice sorgente è rilasciato in licenza secondo GNU General Public License v3.0, che garantisce le quattro regole fondamentali del software libero anche sui fork dell'applicazione. Per maggiori dettagli riguardo la licenza, consultare il file LICENSE.