You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cordova.apache.org by Filip Maj <fi...@adobe.com> on 2012/11/07 20:50:24 UTC

(CB-1823) BlackBerry updates to the docs

I am starting to lean towards this person's opinion. Combining all the
BlackBerry platforms into one is starting to become heavy.

Clearly RIM is not looking to support BB 5, 6 and 7 moving forward.
Everything coming from RIM is 100% focused on BB 10.

At what point should we consider sunsetting support for the older BB OS
revisions? We are already talking about removing iOS 4.3 support; why not
open dialogue for doing something similar on BB?

On 11/7/12 11:18 AM, "Chad Tetreault (JIRA)" <ji...@apache.org> wrote:

>Chad Tetreault created CB-1823:
>----------------------------------
>
>             Summary: BlackBerry updates to the docs
>                 Key: CB-1823
>                 URL: https://issues.apache.org/jira/browse/CB-1823
>             Project: Apache Cordova
>          Issue Type: Bug
>          Components: Docs
>    Affects Versions: 2.3.0
>            Reporter: Chad Tetreault
>            Assignee: Michael Brooks
>
>
>** Is there a better way to split up BBOS, PlayBook, and BlackBerry 10
>(QNX) into seperate sections so that developers can easily see the
>information specific to the platform they're targetting?
>
>** Could add add some screenshots for BlackBerry 10? Similar to how the
>iOS guide looks.  I can provide them if needed.
>
>----
>
>Section: "Getting Started with BlackBerry"
>
>Replace: WebWorks applications can ONLY be deployed to BlackBerry devices
>running OS 5.0 and higher or the BlackBerry PlayBook operating system.
>
>With: WebWorks applications can ONLY be deployed to the following
>BlackBerry platforms:
>  * BlackBerry OS 5.0 and higher
>  * BlackBerry PlayBook
>  * BlackBerry 10 (QNX)
>
>----
>
>2. "Install SDK + Cordova"
>
>Replace: - Download and install one or more of the WebWorks SDKs. Keep
>note of the install directory.
>  * Smartphone Development: BlackBerry WebWorks Smartphone SDK
>  * PlayBook Development: BlackBerry WebWorks Tablet OS SDK
>
>With: Download and install the appropriate WebWorks SDKs for your
>development. BlackBerry 10, BlackBerry PlayBook, and BlackBerry
>Smartphone WebWorks SDKs can be downloaded from the following location:
>https://developer.blackberry.com/html5/download/
>
>*Make note of the installation directory.
>
>----
>
>3. "Setup New Project"
>
>Replace: Open up the project.properties file with your favorite editor
>and edit the entries for blackberry.bbwp.dir= and/or playbook.bbwp.dir=.
>Set the value(s) to the directory containing the bbwp binary in the
>WebWorks SDK(s) installed earlier.
>
>With: Open up the project.properties file with your favorite editor and
>edit the entries for the WebWorks SDKs you are using:
>  * blackberry.bbwp.dir=
>  * playbook.bbwp.dir=
>  * qnx.bbwp.dir=
>
>  Set the value(s) to the root directories of the corresponding WebWorks
>SDK(s) you have installed. Example: C:\Program Files (x86)\Research In
>Motion\BlackBerry 10 WebWorks SDK 1.0.2.9
>
>----
>
>4. "Hello World"
>
>Replace: Replace target with either blackberry or playbook.
>
>Issue: Replace target with blackberry, playbook, or qnx to build for the
>corresponding platform.
>
>**This appears to be not true. The sample application just displays a
>landing page with no additional functionality. (Get Screenshot) Should
>have a fully functional app.  I've been creating a Kitchen Sink app for
>BB10 which tests all the API's, perhaps we could include this, or link to
>it when it's complete?
>
>----
>
>5A "Deploy to Simulator"
>
>Replace: PlayBook simulators require VMWare Player
>
>With: PlayBook and BlackBerry 10 simulators require VMWare Player
>
>**The qnx.sim.ip and qnx.sim.password values aren't mentioned.
>**While in your project directory...
>**There is no mention of qnx anywhere.
>
>Replace: The application will be installed in the All Applications
>section in the simulator.
>
>With: The application will be installed to the homescreen of the
>simulator.
>
>----
>
>5B "Deploy to Device (Windows and Mac)"
>
>**There is no 'Setup BlackBerry 10 Signing keys' link.
>**https://developer.blackberry.com/html5/documentation/signing_setup_bb10_
>apps_2008396_11.html
>
>**Open the project.properties...
>**There is no reference to any of the qnx variables.
>
>Add: Before deploying to a BlackBerry PlayBook or BlackBerry 10 device,
>ensure that Development Mode is enabled in your device Security settings.
>
>**While in your project directory...
>**qnx should be added as an option in addition to blackbery and playbook.
>
>Replace: The application will be installed in the All Applications
>section in the device.
>
>With: The application will be installed to the homescreen of the device.
>
>----
>
>"Additional Info"
>
>Add: BlackBerry WebWorks Documentation
>https://developer.blackberry.com/html5/documentation/
>  
>
>
>
>
>
>--
>This message is automatically generated by JIRA.
>If you think it was sent incorrectly, please contact your JIRA
>administrators
>For more information on JIRA, see: http://www.atlassian.com/software/jira


RE: (CB-1823) BlackBerry updates to the docs

Posted by Josh Soref <js...@rim.com>.
Tim wrote:
> I agree with the sentiments of Chad that the docs are getting a little too
> bloated. I don't think it'll be that bad to create separate docs for each
> platform. I think it'll mostly be a copy and paste job. I also think as
> time goes on, we'll only be updating the bb10 parts anyhow.

Is it possible to mark up the documentation so that by default only the latest target platform is shown but you could click something/set a pref to see the documentation for other targets?

Having to maintain multiple documents seems like an exercise in pain. Especially as the less current ones are much less likely to get eyeballs for fixes.

If you made the scripts magic enough, you could have it indicate which other platforms are supported/not and maybe a measure of how quirky they are -- all in one place.

---------------------------------------------------------------------
This transmission (including any attachments) may contain confidential information, privileged material (including material protected by the solicitor-client or other applicable privileges), or constitute non-public information. Any use of this information by anyone other than the intended recipient is prohibited. If you have received this transmission in error, please immediately reply to the sender and delete this information from your system. Use, dissemination, distribution, or reproduction of this transmission by unintended recipients is not authorized and may be unlawful.

Re: (CB-1823) BlackBerry updates to the docs

Posted by Tim Kim <ti...@gmail.com>.
I agree with the sentiments of Chad that the docs are getting a little too
bloated. I don't think it'll be that bad to create separate docs for each
platform. I think it'll mostly be a copy and paste job. I also think as
time goes on, we'll only be updating the bb10 parts anyhow.

At what point should we consider sunsetting support for the older BB OS
> revisions? We are already talking about removing iOS 4.3 support; why not
> open dialogue for doing something similar on BB?


...it seems like there will be a definite transition period.  I would think
> we will still see significant subscriber numbers on BBOS devices for a
> while.  I would think you will continue to see demand for BBOS builds.


I find it a little hard to gauge the community's interest in the bb
platforms at times. There's not a lot of posts on the google groups or
other avenues compared to the other platforms and they come infrequently as
well. However, there are a number of the posts that are about making
PhoneGap work on BB5/6 so I guess we should hold off sunsetting support
just yet.

Perhaps we should re-evaluate a few months after bb10 comes out?

-- 
Timothy Kim

RE: (CB-1823) BlackBerry updates to the docs

Posted by Ken Wallis <kw...@rim.com>.
While we would certainly love to see every BlackBerry user upgrade to BlackBerry 10 in the first two weeks, it seems like there will be a definite transition period.  I would think we will still see significant subscriber numbers on BBOS devices for a while.  I would think you will continue to see demand for BBOS builds.
--

Ken Wallis

Product Manager – BlackBerry WebWorks

Research In Motion

(905) 629-4746 x14369

________________________________________
From: Filip Maj [fil@adobe.com]
Sent: Wednesday, November 07, 2012 2:50 PM
To: dev@cordova.apache.org
Subject: (CB-1823) BlackBerry updates to the docs

I am starting to lean towards this person's opinion. Combining all the
BlackBerry platforms into one is starting to become heavy.

Clearly RIM is not looking to support BB 5, 6 and 7 moving forward.
Everything coming from RIM is 100% focused on BB 10.

At what point should we consider sunsetting support for the older BB OS
revisions? We are already talking about removing iOS 4.3 support; why not
open dialogue for doing something similar on BB?

On 11/7/12 11:18 AM, "Chad Tetreault (JIRA)" <ji...@apache.org> wrote:

>Chad Tetreault created CB-1823:
>----------------------------------
>
>             Summary: BlackBerry updates to the docs
>                 Key: CB-1823
>                 URL: https://issues.apache.org/jira/browse/CB-1823
>             Project: Apache Cordova
>          Issue Type: Bug
>          Components: Docs
>    Affects Versions: 2.3.0
>            Reporter: Chad Tetreault
>            Assignee: Michael Brooks
>
>
>** Is there a better way to split up BBOS, PlayBook, and BlackBerry 10
>(QNX) into seperate sections so that developers can easily see the
>information specific to the platform they're targetting?
>
>** Could add add some screenshots for BlackBerry 10? Similar to how the
>iOS guide looks.  I can provide them if needed.
>
>----
>
>Section: "Getting Started with BlackBerry"
>
>Replace: WebWorks applications can ONLY be deployed to BlackBerry devices
>running OS 5.0 and higher or the BlackBerry PlayBook operating system.
>
>With: WebWorks applications can ONLY be deployed to the following
>BlackBerry platforms:
>  * BlackBerry OS 5.0 and higher
>  * BlackBerry PlayBook
>  * BlackBerry 10 (QNX)
>
>----
>
>2. "Install SDK + Cordova"
>
>Replace: - Download and install one or more of the WebWorks SDKs. Keep
>note of the install directory.
>  * Smartphone Development: BlackBerry WebWorks Smartphone SDK
>  * PlayBook Development: BlackBerry WebWorks Tablet OS SDK
>
>With: Download and install the appropriate WebWorks SDKs for your
>development. BlackBerry 10, BlackBerry PlayBook, and BlackBerry
>Smartphone WebWorks SDKs can be downloaded from the following location:
>https://developer.blackberry.com/html5/download/
>
>*Make note of the installation directory.
>
>----
>
>3. "Setup New Project"
>
>Replace: Open up the project.properties file with your favorite editor
>and edit the entries for blackberry.bbwp.dir= and/or playbook.bbwp.dir=.
>Set the value(s) to the directory containing the bbwp binary in the
>WebWorks SDK(s) installed earlier.
>
>With: Open up the project.properties file with your favorite editor and
>edit the entries for the WebWorks SDKs you are using:
>  * blackberry.bbwp.dir=
>  * playbook.bbwp.dir=
>  * qnx.bbwp.dir=
>
>  Set the value(s) to the root directories of the corresponding WebWorks
>SDK(s) you have installed. Example: C:\Program Files (x86)\Research In
>Motion\BlackBerry 10 WebWorks SDK 1.0.2.9
>
>----
>
>4. "Hello World"
>
>Replace: Replace target with either blackberry or playbook.
>
>Issue: Replace target with blackberry, playbook, or qnx to build for the
>corresponding platform.
>
>**This appears to be not true. The sample application just displays a
>landing page with no additional functionality. (Get Screenshot) Should
>have a fully functional app.  I've been creating a Kitchen Sink app for
>BB10 which tests all the API's, perhaps we could include this, or link to
>it when it's complete?
>
>----
>
>5A "Deploy to Simulator"
>
>Replace: PlayBook simulators require VMWare Player
>
>With: PlayBook and BlackBerry 10 simulators require VMWare Player
>
>**The qnx.sim.ip and qnx.sim.password values aren't mentioned.
>**While in your project directory...
>**There is no mention of qnx anywhere.
>
>Replace: The application will be installed in the All Applications
>section in the simulator.
>
>With: The application will be installed to the homescreen of the
>simulator.
>
>----
>
>5B "Deploy to Device (Windows and Mac)"
>
>**There is no 'Setup BlackBerry 10 Signing keys' link.
>**https://developer.blackberry.com/html5/documentation/signing_setup_bb10_
>apps_2008396_11.html
>
>**Open the project.properties...
>**There is no reference to any of the qnx variables.
>
>Add: Before deploying to a BlackBerry PlayBook or BlackBerry 10 device,
>ensure that Development Mode is enabled in your device Security settings.
>
>**While in your project directory...
>**qnx should be added as an option in addition to blackbery and playbook.
>
>Replace: The application will be installed in the All Applications
>section in the device.
>
>With: The application will be installed to the homescreen of the device.
>
>----
>
>"Additional Info"
>
>Add: BlackBerry WebWorks Documentation
>https://developer.blackberry.com/html5/documentation/
>
>
>
>
>
>
>--
>This message is automatically generated by JIRA.
>If you think it was sent incorrectly, please contact your JIRA
>administrators
>For more information on JIRA, see: http://www.atlassian.com/software/jira


---------------------------------------------------------------------
This transmission (including any attachments) may contain confidential information, privileged material (including material protected by the solicitor-client or other applicable privileges), or constitute non-public information. Any use of this information by anyone other than the intended recipient is prohibited. If you have received this transmission in error, please immediately reply to the sender and delete this information from your system. Use, dissemination, distribution, or reproduction of this transmission by unintended recipients is not authorized and may be unlawful.