To begin using puship a registration is needed, this procedure it’s easy and free of charge: Browse to the member page and click on register
Insert your data and click on create user
A mail containing a confirmation link will be sent t the given email address. Once the registration is confirmed it will be necessary to come back to the login page and insert the chosen Username and Password.
Clicking on the add new app button a new record representing your application will appear in the table below.
To configure it, click on the Configure button as shown in the following figure
A popup will be shown in which it will be possible to configure each store. It will be generated even the App Code (aka PushipAppId) that will have to be used to configure the PushNotification.js library (I.E.: Puship.PushipAppId = “APKCbOd72fXKVUU”;)
At this point it’s possible to configure each platform following the platform-specific guides.
Push notification in an Apple environment are quite tricky to configure and have to be done in Mac OS
Go to the Provisioning portal from this link.
From the left menu select Identifiers and then click on the + button to create a new application
Insert the application name and the chosen Unique Identifier, at the bottom of the page check Push Notification, then click on Continue.
Find the application that has just been created in the application list, select them and click on the configure edit button
Click on the Configure button of the Development certificate
Once done it, the following screen requesting to run Keychan Access to generate the certificate will be shown.
To create the certificate go to Applications -> Utility
and run Keychain Access
From the top left menu, click on Keychan Access -> Certificate Assistant -> Request a certificate from a Certificate Authority
Fill the following form with your email and name leave blank the CA Email Address blank. Click on Save to disk and flag Let me specify key pair information.
Save the certificated in your preferred location
Be sure that the setting shown in the screen are the same of those shown in the following figure; click on Continue to complete the certificate creation
Now go back on the Provisioning site and click on Continue; in the next page select the created certificate ancd click on Generate
Download the certificate that has been generated from the Provisioning Portal. Once done just import it as machine certificate. It’s possible to check if the import process has been completed correctly running the Keychain Access and looking at the Certificates section
After clicking on Done, the push notification facility will be enabled for the IDE
In order to generate the certificate needed by Puship, from the Keychan Access, right click on it and select Export “Apple Dev…
Insert a name for the certificate and store it in the preferred location
Insert the password to be applied to the certificate
If requested, insert also the system password; Now the .p12 certificate will be available to be used with Puship.
To configure the Puship server:
From the Provisioning portal click on the Provisioning and then on the + button
In the wizard follow this steps: select the type of distribution you are doing, the application for which you are creating the certificate, the certificates (ie developers) that are associated with this profile and the devices on which you want to run the tests, the following screen for the certificate download will be shown.
Download the profile and run it double clicking it The Xcode will be shown where the profile would be imported and highlighted
Now it’s possible to associate the profile to the project under development. Open the Xcode project and select the project root
Go to the Build Setting tab and in the Code Signing group click on the Any iOS SDK row of the Debug element and select the profile
Compiling the project and Code Sign error could occour. That means that the Build Identifier of the project doesn’t match the profile one
If so, select the project root and choose the target entry and the Info tab. Amend the Bundle Identifier matching the profile one.
Once compiled, the error will be gone. In case it would be still there, clean the project, restart Xcode and compile again.
The configuration is done and everything is now ready to start receiving push notification!
The configuration on the PhoneGap online builder is quite simple and is explained in great detail at this link. Alternatively you can view the video tutorials in this section which explains step by step how to create the project with the phonegap online builder.
Blackberry force the users to configure the development service and then the production service, both procedures are similar; the only difference lies on the form to use to request the activation of the service:
To enable the Blackberry service:
To configure the Puship server:
Note: At the moment only the BIS service, is supported (Free service). In order to activate the BES (Enterprise service) a request has to be sent to our customer service
The Google Play account configuration is quite trivial. Google doesn’t even distinguish between development and production environment.
To create the Google API Project:
To enable the GCM service:
To obtain the API key:
To configure the Puship server:
Note: This guide is based on the Google official one that can be found at this address.
You do not need any configuration to start sending push notifications. Just configure Puship as shown below.
To configure the puship server:
To begin to send push notifications, press the button Send Push Notification, as shown in the figure below
A popup will be shown in which you will be able to choose which are the destination platforms (note that if a platform has not been configured yet it won’t be selectable)
Set the message to be sent, the badge to show and the sound you want to be played once the notification reaches the device. In the Tags field, select the tags to be used as filter for sending push notifications. An empty combo box means that no devices have linked tags to this very Application. If no tags are selected, the notification will be sent to all the devices.
The Add geolocation button enable the dispatch to be done based on the last recorded position of the device, in the next screen it’s shown how a notification will be delivered only to those devices registered in Venice
It’s possible to select two different sending mode, the ordinary Pushmode, that send the notification and save the message in the database in order to read it later through Puship services; or the Ship, che non mode, that DON’T send the notification but store the message in the database only. This way could be useful whenever it’s necessary to add messages to the application without notify the user of this action
Once the notification as been sent, a quick resume about how many devices has been reached by the notification will be shown.
The Manage Push Notification button let you access to the historical record of push notifications
From this section it’s possible to see in details to which devices the notification was sent, its content and the selected Tags.
To do a quick amendment to the message you just have to perform a double click on the text, edit it and once done, the content will be saved. This operation doesn’t send once again the notification but it only changes its content in the Puship database, therefore changing the section that use it in the devices.
As you can see in the screenshot, the last column of the Push messages table contains two buttons:
The one icon allow the deletion of the message from the database, the other allow to view and modify the notification details other than resend it if needed.
To view the registered devices list, press the Show registered Devices, button as shown in the following picture,
A window containing all the registered devices will be shown. For each devices is possible to open a detail box in which all its associated tags can be viewed.
With the Set Expired command shown below, it is possible to temporary disable a device (until a new registration occurs).
Pressing the Show Push button it is possible to view all the push notifications that have been sent to the device, the same that can be fetched calling the GetPushByDevice method.
From the page shown in the picture below it is possible to amend the push notifications already sent to the device, delete them and view how many devices that notification has hit and thus how many devices showed the same notification.
Warning! Amendment or deletion of a notification will be reflected on all the devices that share it.
Pressing the Show Push Notification button it is possible to send a push notification to a specific device
The single push sending doesn’t not show any kind of filter, it’s only necessary to input the message to send and press the Push button
For each application we offer a compact reporting system. To access it just click on the See statistics button as shown in the figure below
3 different reports are available: