ID Notification

Introduzione

Questo componente permette di inviare notifiche locali e notifiche push alle applicazioni registrate per riceverle.

Nota importante

Attenzione dal 20 giugno 2024 le notifiche push di FireBase utilizzano le API Firebase Cloud Messaging (FMC) versione 1 e non più le legacy che sono state deprecate.
Pertanto la versione minima di Instant Developer Foundation utilizzabile per le applicazioni che devono utilizzare le notifiche push è la 24.0

Configurazione sistema per notifiche su Android e iOS (dalla versione 24.0)

Per poter inviare notifiche locali, non è richiesta nessuna configurazione particolare. È sufficiente inviare una notifica dall'applicazione offline quando eseguita dentro alla shell nativa (pacchetto di installazione o browser Caravel).

Per poter inviare notifiche push in applicazioni offline eseguite dentro al browser Caravel, non è richiesta nessuna configurazione particolare.

Per poter inviare notifiche push in applicazioni offline eseguite dentro alla shell nativa ottenuta creando il pacchetto di installazione occorre effettuare i seguenti passaggi:

• registrarsi sulla console di Firebase;

• creare un nuovo progetto;

• aggiungere l'applicazione iOS o Android fornendo le informazioni richieste;

• per le applicazioni Android scaricare il file google-services.json e copiarlo nella custom dentro alla cartella "Devices\Android\app" e aggiungerlo nel filelist.txt;
• per le applicazioni iOS scaricare il file GoogleService-Info.plist e copiarlo nella custom dentro alla cartella "Devices\iOS\__InstMob__" (non è necessario inserirne il nome nel file FileList.txt poichè il file è già presente, vuoto, nel template standard);
• nell'applicazione mittente delle notifiche impostare la proprietà JsonKey con la "Chiave API web" ottenibile dalla Console di Firebase.

Proprietà JsonKey

Per impostare la proprità JsonKey occorre creare una nuova chiave nella console di FireBase.
Per prima cosa si devono aprire le Impostazioni progetto cliccando sull'icona a forma di ingranaggio nel menu di sinistra (Panoramica del progetto).
Poi cliccare sulla scheda Account di servizio che apre una nuova tab del browser con l'amministrazione degli account di servizio.
Qui occorre cliccare sulla voce di menu a sinistra Account di servizio e se non è già presente un account occorre crearlo con il bottone in alto CREA ACCOUNT DI SERVIZIO.
Nella riga dell'account di servizio cliccare sull'icona con i tre puntini a destra e selezionare la voce Gestisci chiavi che vi porta nella videata delle chiavi.
Qui si deve cliccare sul bottone Aggiungi chiave e selezionare Crea nuova chiave.
A questo punto viene chiesto di scegliere il tipo di chiave e si seleziona json.
La conferma genera una nuova chiave json ed effettua il download del file in formato json.
Il file contiene queste informazioni:
{
"type": "service_account",
"project_id": "test-notifiche-00000",
"private_key_id": "0000000000000000000000000000000000000000",
"private_key": "-----BEGIN PRIVATE KEY-----\n qui si trova un testo con la private key =\n-----END PRIVATE KEY-----\n",
"client_email": "firebase-adminsdk-00000@test-notifiche-00000.iam.gserviceaccount.com",
"client_id": "000000000000000000000",
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://oauth2.googleapis.com/token",
"auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
"client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/firebase-adminsdk-00000%40test-notifiche-00000.iam.gserviceaccount.com",
"universe_domain": "googleapis.com"
}

Questo testo va utilizzato per compilare la JsonKey.

Configurazione sistema per notifiche su Chrome

Per poter inviare notifiche push in applicazioni eseguite dentro Chrome ottenute creando il pacchetto di installazione, occorre:

• ottenere il ClientID e il ClientSecret:
  • fare login nella console di Google usando lo stesso account Google che verrà usato per caricare l'applicazione nel Chrome Store
  • creare un nuovo progetto espandendo il menu a tendina in alto a sinistra e selezionando Create...
  • dal menu sulla sinistra, selezionare la voce Services e abilitare Google Cloud Messaging for Chrome API
  • dal menu sulla sinistra, selezionare la voce API Access e cliccare sul bottone Create an OAuth 2.0 client ID...
  • compilare i campi e cliccare sul bottone Next
  • nel campo Application type, selezionare Web application
  • cliccare su more options, di fianco a Your site or hostname, e scrivere il seguente URL: https://developers.google.com/oauthplayground
  • cliccare sul bottone Create client ID
  • nella pagina che comparirà saranno presenti il ClientID e il ClientSecret da utilizzare per l'invio delle notifiche
• ottenere il primo AccessToken e il RefreshToken
  • fare login sull'Oauth 2.0 Playground di Google con lo stesso account Google che verrà usato per caricare l'applicazione nel Chrome Store
  • cliccare sul bottone con il simbolo dell'ingranaggio nell'angolo in altro a destra
  • selezionare Use your own OAuth credentials, scrivere nei rispettivi campi il ClientID e il ClientSecret e cliccare su Close
  • nella sezione Step 1, sulla sinistra, scrivere nel campo input your own scope il seguente scope: https://www.googleapis.com/auth/gcm_for_chrome e cliccare sul bottone Authorize APIs
  • si aprirà una nuova pagina in cui vengono chieste le autorizzazioni. Cliccare sul bottone Allow access
  • nella sezione Step 2, cliccare sul bottone Exchange authorization code for tokens
  • nei campi Refresh token e Access token ci saranno i valori da utilizzare per l'invio delle notifiche
• creare il pacchetto da inviare al Chrome Store
  • scaricare il pacchetto ed estrarre i file
  • nel file background.js sostituire il serverUrl e il clientURL.
    Il serverURL è l'indirizzo del server che riceverà il device notification id inviato dall'applicazione al momento dell'avvio.
    Il clientURL è l'indirizzo che verrà aperto quando l'utente cliccherà sulla notifica.
    
  • se necessario, personalizzare i file del pacchetto. A questo link è possibile trovare una guida.
  • zippare il pacchetto e fare login sulla Chrome Developer Dashboard
  • cliccare sul bottone A new item, cliccare su Choose file, scegliere il pacchetto appena creato e cliccare su Upload
  • se non ci sono errori, si aprirà una pagina in cui possono essere specificati tutti i dettagli relativi all'applicazione. Dopo aver riempito almeno i campi obbligatori, cliccare sul bottone Publish per pubblicare l'applicazione sul Chrome Web Store.
    Se è la prima volta che si pubblica un'applicazione sul Chrome Store, verrà richiesto il pagamento di una quota di registrazione pari a 5$.