18app

⚠️ WORK IN PROGRESS ⚠️

Questo è il repository della app ufficiale per 18app, sviluppata con il framework Xamarin.Forms per iOS e Android.

Lo sviluppo della app è stato completato ed è in corso di pubblicazione negli app store. Segui la pagina Facebook ufficiale per ricevere aggiornamenti!

Informazioni per sviluppatori

Il codice è contenuto in una singola soluzione Visual Studio all'interno della directory src/. Dopo aver clonato il progetto, puoi aprirlo con Visual Studio.

Consulta la documentazione di Xamarin.Forms per installare tutti gli strumenti di sviluppo necessari.

Potrai quindi compilare e testare la app localmente usando emulatori o dispositivi fisici.

Informazioni aggiuntive per la compilazione

Per ovvi motivi nel repository GitHub non è presente un file che contiene le chiavi di connessione ai servizi di backend, quindi la compilazione non va a buon fine. Per risolvere basta creare nella cartella src/Italia.DiciottoApp il file Keys.cs col seguente contenuto:

namespace Italia.DiciottoApp
{
    public static class Keys
    {
        public static readonly bool IsInstabugEnabled = false;
        public static readonly string InstabugToken = "<InstabugToken>";

        public static string X_IBM_ClientId_ProdEnv => "<ProdClientIdGuid>";
        public static string X_IBM_ClientId_TestEnv => "<TestClientIdGuid>";

        public static string X_IBM_ClientSecret_ProdEnv => "<ProdClientSecretGuid>";
        public static string X_IBM_ClientSecret_TestEnv => "<TestClientSecretGuid>";
    }
}

Configurazione del servizio Google Maps

A partire dal 16 luglio 2018 i servizi Google Maps possono essere gratuitamente utilizzati solo da applicazioni Mobile, come riportato nella pagina Google Map service Price. Al fine di evitare un uso improprio Google richiede la registrazione dell'app, da effettuare come descritto nella documentazione Xamarin Forms Obtaining a Google Maps API Key. Poiché il servizio riconosce l'app chiamante mediante la chiave SHA-1 con la quale è stata compilata, non è necessario impostare alcun altro parametro (AppId o AppSecret) di sorta. In modo automatico, l'applicazione Android utilizzerà il servizio Google Maps, come sopra impostato, e l'applicazione iOS utilizzerà il servizio di mappe della Apple, che non richiede alcuna impostazione.

Come contribuire

I contributi sono benvenuti! Al momento siamo impegnati per il primo rilascio, quindi il codice cambia velocemente. Dopo il primo rilascio potremo valutare i contributi inviati sottoforma di Pull Request. Ti consigliamo di iniziare aprendo una issue in modo da discutere insieme il modo migliore per implementare la modifica, e di non includere troppe modifiche eterogenee nella stessa Pull Request.

Autori

Questa app è stata sviluppata dal Team per la Trasformazione Digitale in collaborazione con il Ministero per i Beni e le Attività Culturali e Sogei.

Progetto UX/UI: Matteo De Santi
Sviluppo Xamarin: Nicolò Carandini
Coordinamento: Alessandro Ranellucci

Licenza

Il codice sorgente è rilasciato sotto licenza GPL-3.0.

italia / 18app

readme