Phonegap Online Build

Nuevo Proyecto

Esta guía muestra como instalar un proyecto pre configurado par el utilizo de las notificaciones Push.

  1. Regístrate con un nuevo account en build.phonegap.com
  2. Una vez logado psuedes escoger si cargar el proyecto desde github.com o efectuar el upload desde el desktop.
    • Si decides de utilizar github tendrás solamente que logarte y efectuar un fork del proyecto Phonegap Puship Start, entonces pega el url del proyecto apena creado en el tab open-source
    • Si quieres mantener el código surgente en tu pc tendrás que descargar el proyecto en formado zip de este link y efectuar el upload desde el private tab
  3. Ahora crea una nueva aplicación en Puship Manager para obtener el Puship App ID y sustituye el valor “puship_id” presente en el file js/index.js.
  4. Activa el servicio de notificación que necesitas siguiendo las guías (Apple, Google Play y Microsoft Store). Para Google Play tendrás que modificar el file js/index.js y ajustar el senderID en el GCMCode
  5. Modifica el package del proyecto desde tu file www/config.xml y incluyes Access origin para habilitar el acceso al server puship:
    <widget 
    	xmlns="http://www.w3.org/ns/widgets" 
    	xmlns:gap="http://phonegap.com/ns/1.0" 
    	id="com.puship.example" 
    	version="1.0.0"> <!--modifica aquí el package-->
    ...
    <access origin="https://cloudapp.puship.com" /> <!-- Agregue la siguiente línea después del origen -->
  6. Efectúa nuevamente el upload del file zip o sincroniza el proyecto con github conforme a la modalidad que escogiste en el punto 2
  7. Si estas desarrollando par iOS tendrás que inserir el certificado del desarrollador, sigue el video al final de la página que explica cómo generarlo.
  8. Escanea con tu smartphone el barcode para descargar la aplicación, entonces avíala otra vez.

Cuando la aplicación será aviada tendrías que visualizar el mensaje “device registered”. Puedes ahora conectarte al Puship Manager y enviar notificaciones push a tus device!
 

Proyecto existente

Puedes ajuntar el suporto para las notificaciones push a un proyecto existente siguiendo los siguientes pasos:

  1. Ajunta el código siguiente en el método receivedEvent del file js/index.js:
    var Puship = window.plugins.puship;
    Puship.EnableLog = true;
    Puship.PushipAppId = puship_id; //un ejemplo de puship_id podía ser "h1mCVGaP9dtGnwG”
    
    if (Puship.Common.GetCurrentOs()==Puship.OS.ANDROID){
    	var GCMCode = your_sender_id; //este es el senderID fornido por google. Ejemplo “28654934133”
    	Puship.GCM.Register(GCMCode,
    	{
    		successCallback: function (pushipresult){
    			navigator.notification.alert("device registered with DeviceId:" + pushipresult.DeviceId);
    		},
    		failCallback: function (pushipresult){
    			navigator.notification.alert("error during registration: "+ JSON.stringify(pushipresult));
    		}
    	});
    } else if (Puship.Common.GetCurrentOs()==Puship.OS.IOS){
    	Puship.APNS.Register(
    	{
    		successCallback: function (pushipresult){
    			navigator.notification.alert("device registered with DeviceId:" + pushipresult.DeviceId);
    		},
    		failCallback: function (pushipresult){
    			navigator.notification.alert("error during registration: "+ JSON.stringify(pushipresult));
    		}
    	});
    } else if (Puship.Common.GetCurrentOs()==Puship.OS.WP){
    	Puship.WP.Register(
    	{
    		successCallback: function (pushipresult){
    			navigator.notification.alert("device registered with DeviceId:" + pushipresult.DeviceId);
    		},
    		failCallback: function (pushipresult){
    			navigator.notification.alert("error during registration: "+ JSON.stringify(pushipresult));
    		}
    	});
    } else {
    	Console.log("Not supported platform");
    }
  2. Crea una nueva aplicación en Puship Manager para obtener el Puship App ID y sustituye el valor “puship_id” presente en el file js/index.js
  3. Activa el servicio de notificación que necesitas siguiendo las guías (Apple, Google Play y Microsoft Store). Para Google Play tendrás que modificar el file js/index.js y ajustar el senderID en el GCMCode.
  4. Ajunta las siguientes en tu file www/config.xml:
    <gap:plugin name="org.apache.cordova.console" /> <!-- solicitud -->
     <gap:plugin name="org.apache.cordova.device" /><!-- solicitud -->
     <gap:plugin name="org.apache.cordova.geolocation" /><!-- necesitada solo si utilizas la geolocalización -->
     <gap:plugin name="org.apache.cordova.dialogs" /><!-- solicitud -->
     <gap:plugin name="cordova-plugin-puship" source="npm" /> <!-- solicitud -->
    ...
     <access origin="https://cloudapp.puship.com" /><!-- ajunta la siguiente linea despues de la origen -->
  5. Efectúa nuevamente el upload del file zip o sincroniza el proyecto con github
  6. Si estas desarrollando par iOS tendrás que inserir el certificado del desarrollador, sigue el video al final de la página que explica cómo generarlo.
  7. Escanea con tu smartphone el barcode para descargar la aplicación, entonces avíala otra vez.

Atencion:

  • En este momento las notificaciones push para Blackberry no son suportada por el builder online


En segundo momento es disponible un video que explica en la primera parte como crear la aplicación con las CLI y crear los certificados, en la segunda parte como aplicarlos al phonegap online build.






 

Para poder ajuntar tags, administrar la geolocalización e todo lo que concierne el resto de las api puship sisita la documentación común para todas las plataformas: