Cordova CLI (Esempio)

Questa guida mostra come creare un’applicazione (android, iOS e windows) che supporta le notifiche push di Puship attraverso la piattaforma Cordova Command-Line Interface.
Prima di creare l’applicazione devi assicurarti di aver configurato correttamente la CLI con gli sdk per le piattaforme che desideri supportare (puoi trovare una guida con la CLI Cordova a questo link).

1. Vai sulla directory dove vuoi mantenere il codice sorgente e lancia il seguente comando per creare il progetto:

cordova create puship com.puship.example Puship
//il primo parametro (puship) definisce il nome della cartella del progetto
//il secondo parametro (com.puship.example) definisce il package del progetto
//il terzo parametro (Puship) definisce il nome dell'applicazione

2. Posizionati sulla cartella del progetto appena creato e lancia il seguente comando per installare il plugin puship:

cordova plugin add puship-plugin

3. Aggiungi il codice seguente nel metodo onDeviceReady del file js/index.js:

onDeviceReady: function() {
    app.receivedEvent('deviceready');
    
    const push = PushNotification.init({
    	android: {
    	},
        browser: {
            pushServiceURL: 'http://push.api.phonegap.com/v1/push'
        },
    	ios: {
    		alert: "true",
    		badge: "true",
    		sound: "true"
    	},
    	windows: {}
    });
    
    push.on('registration', (data) => {
    	//alert("registrationid: " + data.registrationId);
    	
    	//CODE TO ADD
    	//Puship.EnableLog(true);
    	Puship.Register(
        	data.registrationId,
        	'YOUR-PUSHIP-APP-CODE',
        	{
        		successCallback: function (pushipresult) {
        			alert("device registered with DeviceId:" + pushipresult.DeviceId());
        		},
        		failCallback: function (pushipresult) {
        			alert("error during registration: "+ JSON.stringify(pushipresult));
        		}
        	}
        );
    
    });
    
    push.on('notification', (data) => {
        alert(JSON.stringify(data));
    	// data.message,
    	// data.title,
    	// data.count,
    	// data.sound,
    	// data.image,
    	// data.additionalData
    });
    
    push.on('error', (e) => {
    	// e.message
    });
},

4. Segui la guida a questo link per creare una nuova applicazione nel Puship Manager per ottenere il Puship App ID e sostituisci “YOUR-PUSHIP-APP-CODE” presente nello script sopra.
5. Attiva il servizio di notifica che necessiti seguendo le guide Apple, Google Play e Microsoft Store.

6. Lancia il comando per aggiungere le piattaforme che stai supportando:

cordova platform add android
//The platform parameter can be android or ios

7. Lancia il comando di build per tutte le piattaforme aggiunte:

cordova build

8. Per avviare l’applicazione
   • Android: lancia il comando cordova run android
   • iOS: lancia il comando cordova run ios
   • Windows: lancia il comando cordova run windows

Ad applicazione avviata dovresti visualizzare il messaggio “device registered with…”. Puoi ora connetterti al Puship Manager e inviare notifiche push ai tuoi device!

Nota bene:

• Le notifiche push non sono supportate sull’emulatore ios.
• Le notifiche push sono supportate su emulatore android ma è necessario un setup particolare dell’emulatore, è quindi consigliato testare su device reale.
• Se vuoi integrare il servizio di notifiche push ad un progetto esistente parti dal punto 2

Di seguito sono disponibili dei video che spiegano passo passo come creare un’applicazione e attivare le notifiche push con Puship per Android e per iOS:

Di seguito trovi un esempio di progetto già configurato e con vari esempi di utilizzo dei metodo Puship, puoi anche clonarlo e partire da questo

Complete CLI Example

Per poter invece conoscere dettagliatamente come aggiungere tags, gestire la geolocalizzazione e tutto ciò che riguarda il resto delle api puship visita la documentazione comune per tutte le piattaforme:

Common library documentation