blackberry-webworks/WebWorks-API-Docs — Issue #84: WebWorks Push API questions
Author: themainguru
Created: 2012-03-08 19:36:22+00:00
State: open

From: Daniel Mateescu
Date: Thu, 8 Mar 2012 09:30:44 -0500
To: Marco Di Cesare , RIM User
Subject: RE: WebWorks push API questions

Hi Marco.
Please find my answers inline [D] below.
Cheers,

Daniel Mateescu
Team Lead - BlackBerry WebWorks
Research In Motion
Phone: (905) 629-4746 x 14424

---------------
From: Marco Di Cesare
Sent: Thursday, March 08, 2012 9:00 AM
To: Chris Del Col; Daniel Mateescu
Subject: WebWorks push API questions

Hi guys,

Quick question – during our meeting on Tuesday we discussed how port is no longer relevant to the push APIs for BB10 – did you guys want us to keep port in the new push APIs for BB10 and it will simply be ignored or do you want it removed?
[D] I think we should be keeping the port around for compatibility reasons, and document in the JSDocs that the port is not being used for BB10. Our approach with respect to compatibility is that we should try as much as possible to keep the signatures as close as possible to the old ones.
For documentation, please refer to the blackberry.ui.dialog (the template is blackberry_ui_dialog.js) for seeing how we are including a note on the fact that a field does not apply to certain OS versions.
* @callback {function} [onOptionSelected] Optional callback function that will be invoked when the user makes a selection. Expected signature: function onOptionSelected(selectedButtonIndex).

NOTE: onOptionSelected is required for BlackBerry OS5.0+.

As a more general approach to the new APIs: if there is a PhoneGap implementation of that piece of functionality, our first choice is to have the signatures as the PhoneGap ones. If there is no PhoneGap implementation (which is the case for Push), we should keep the signatures as close as possible (ideally identical – ideally) to our existing old ones.

Another question – what editor do you guys use to code your JavaScript in? NotePad++?
[D]: Yes.
Also, do you have a standard tool that you use for unit testing?
[D]: Originally, our unit tests were done in YUI, but we are moving away from YUI for BB10. I’ll get back to you later today after I find out what our API team is using now.

Thank you

Marco Di Cesare
Team Lead - BlackBerry Push Data Service
Research In Motion Limited