PhoneGap Getting Started

[url]http://phonegap.pbworks.com/Getting+Started+with+PhoneGap-BlackBerry+with+the+Latest+Environment[/url]
[quote]Getting Started with PhoneGap-BlackBerry with the Latest EnvironmentPage history last edited by Michael Brooks 1 hour ago
Getting Started with PhoneGap-BlackBerry (Latest Environment)


This article explains how to setup the latest BlackBerry development environment. If you have trouble with this article, you may want to setup the legacy environment.



The BlackBerry developer environment is an Eclipse Plugin that includes a BlackBerry simulator and tools for application packaging / deployment.



Important


•This guide is intended for Windows. It has been tested on Windows XP x86 and x64.
•OS X partially works, but Eclipse cannot detect installed versions of JDE.
•Currently, PhoneGap does not run on JDE 5.0.


Sun JDK


1.Download the latest version of the Java Developer Kit (JDK).
◦At the time of writing this article, the latest version is JDK 6 Update 20.
◦You must install a 32-bit version of the JDK.
◦The BlackBerry Plugin can only recognize a 32-bit JDK and Eclipse IDE.
2.Install the JDK.
◦During the installation, you will be asked to install the Java Runtime Environment (JRE) - please do this.


Eclipse IDE


1.Download the latest version of the Eclipse IDE for Java Developers (or Eclipse IDE Classic).
◦At the time writing of this article, the latest version is Eclipse 3.5.2 (Galileo).
2.Install the Eclipse IDE.
◦Install by extracting the ZIP archive to a desired installation directory.
◦e.g. C:\Program Files\Eclipse\Eclipse-3.5.2 3.Run the Eclipse IDE for the first time.
◦To ensure there are no problems with the installation.
4.Close the Eclipse IDE.


BlackBerry Plugin for Eclipse


1.Download the latest BlackBerry Plugin for Eclipse.
◦You will need a BlackBerry Developer Zone account (free).
◦The Plugin's name is misleading. BlackBerry Java Plugin for Eclipse v1.1 means the Plugin version is 1.1 (not Eclipse).
2.Install the Plugin to the Eclipse directory.
◦Make sure Eclipse is closed.
◦The Plugin must be installed into the root of your Eclipse directory.
◦e.g. C:\Program Files\Eclipse\Eclipse-3.5.2\

BlackBerry JDE Component Packs


The JDE component packs allow you to build your Blackberry application for a specific Blackberry platform. By default, the BlackBerry Plugin includes JDE 5.0.



1.Open the Eclipse IDE
2.Select Help > Install Software
3.Click the button Add..
◦Name: <Leave blank>
◦Location: http://www.blackberry.com/go/eclipseUpdate/3.5/java
4.Select the JDE component packs.
◦Select version 4.7.
◦Select other version that you want.
5.Click OK
6.Select Next > Next > Finish
◦There is a legal agreement on the last window
7.When the Authentication prompt appears
◦Username & Password is your BlackBerry Developer Zone account.
◦If multiple login prompts appear, then enter your credentials into each.
■Cancelling any login prompt will cancel the installation.
8.Restart Eclipse when prompted.
◦Do it. Restarting Eclipse is important.


PhoneGap Application Setup


Create a BlackBerry Project


1.Open the Eclipse IDE.
2.Select File > New > Project...
3.Select BlackBerry Project
4.Press Next
5.On the Create a BlackBerry Project screen
◦Project Name: Enter a name for your application
◦Use Project Specific JRE: Select JRE 4.7 or under
■JRE 5.0 does not currently work with PhoneGap
6.Press Finish.


Import the PhoneGap-BlackBerry Project


1.Download the PhoneGap-BlackBerry source.
◦Click the Download Source button in the top-right.
2.Extract the PhoneGap-BlackBerry source.
◦e.g. C:\PhoneGap-BlackBerry\3.Copy & paste the following directories:
◦C:\PhoneGap-BlackBerry\framework\example => C:\<Your Eclipse Project Path>\src\example◦C:\PhoneGap-BlackBerry\framework\src\com => C:\<Your Eclipse Project Path>\src\com4.Rename \example to \www
◦C:\<Your Eclipse Project Path>\src\example => C:\<Your Eclipse Project Path>\src\www5.Open the Eclipse IDE
i.Right-click on your BlackBerry-PhoneGap project
ii.Select Refresh
■You should now see \com and \www packages under the \src tree


Run the PhoneGap-BlackBerry Project in the Simulator


1.Open the Eclipse IDE
2.Right-click on your PhoneGap-BlackBerry Project
◦Select Run As > BlackBerry Simulator
3.The simulator will open and run your application.
◦The application can be found in the simulator's Downloads directory.[/quote]