Tutte le piattaforme

Questa guida è valida per tutti gli ambienti compatibili con il plugin phonegap-push-plugin (cordova/ionic/phonegap cli/phonegap online build/etc…) e spiega come abilitare un’applicazione per androidios o windows a supportare le notifiche push di Puship.

Cos’è il Puship plugin

E’ un plugin cordova con una sola libreria javascript che utilizza il famoso phonegap-plugin-push. Questo fa si che il push-plugin venga aggiornato solo quando vengono rilasciate nuove funzionalità. Non avrai un’altro plugin da manutenere ed aggiornare ed è sempre compatibile con i nuovi SO.

Configurazione

  1. Installa e configura il phonegap-plugin-push seguendo queste guide: installazioneesempi. (devi riuscire ad eseguire l’applicazione facendogli scatenare l’evento push.on(‘registration’) )
  2. In base all’ambiente in cui stai sviluppando aggiungi il push-plugin con la modalità relativa:

cordova plugin add puship-plugin

phonegap plugin add puship-plugin

ionic cordova plugin add puship-plugin

Aggiungi le seguenti righe nel file www/config.xml

<plugin name="cordova-plugin-device" />
<plugin name="cordova-plugin-geolocation" />
<plugin name="phonegap-plugin-push" source="npm" />
<plugin name="puship-plugin" source="npm" />

<preference name="phonegap-version" value="cli-8.1.1" />
<preference name='pgb-builder-version' value='2' />

  1. Aggiungi al file js/index,js le righe dalla 22 alla 33
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.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
    });
},
  1. Seguendo la guida a questo link crea un’applicazione nel Puship Manager, copiati il Puship App ID e sostituiscilo al “YOUR-PUSHIP-APP-CODE” presente nello script sopra.
  2. Attiva il servizio di notifica che necessiti seguendo le guide AppleGoogle Play e Microsoft Store.
  3. Esegui l’applicazione

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