Phonegap CLI

Questa guida mostra come creare un’applicazione phonegap android, ios o windows phone che supporta le notifiche push di Puship attraverso la piattaforma 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).
In alternativa puoi utilizzare il build online seguendo la guida Phonegap Online Build.

  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() {
	this.receivedEvent('deviceready');
	
	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) => {
		Puship.Register(data.registrationId, "YOUR-PUSHIP-APP-CODE");
	});

	push.on('notification', (data) = > {
		alert(JSON.stringify(data));
		// data.message,
		// data.title,
		// data.count,
		// data.sound,
		// data.image,
		// data.additionalData
	});

	push.on('error', (e) => {
		alert(e.message);
	});
	
}
  4. Crea 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 seguento le guide Apple, Google Play e Microsoft Store.
  6. Potrebbe essere necessario abilitare l’accesso al server puship anche nel file index.html:
  7. Lancia il comando per aggiungere le piattaforme che stai supportando: 
    cordova platform add android
//il parametro piattaforma può essere: android, ios
  8. Lancia il comando di build per tutte le piattaforme aggiunte: 
    cordova build
  9. Per avviare l’applicazione.
    • Android: lancia il comando cordova run android
    • iOS: Apri il progetto all’interno della cartella platforms/ios con xcode e premi sul pulsante Run
    • Windows Phone:lancia il comando cordova run wp8

Ad applicazione avviata dovresti visualizzare il messaggio “device registered”. 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 è disponibile un video che spiega passo passo come creare un’applicazione e attivare le notifiche push con Puship.

 


 

Per qualunque problema con la configurazione puoi scaricare l’esempio disponibile qui

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