Blackbe;rry JAVA DEVELOPMENT ENVIRONMENT - - COMPONENT PACKAGE

BlackBerry Java Development

Environment

Component Package

version 4.7.0

Release Notes and Known Issues List

BlackBerry Java Development Environment Component Package version 4.7.0 2 of 7

NOTE

This document is provided for informational purposes only, and does not constitute a binding legal

document unless specifically incorporated by reference into a binding legal agreement between you and

Research In Motion (RIM). In the event that you enter into a binding legal agreement with RIM, all

provisions contained in such binding legal agreement shall apply, regardless of whether such provisions

conflict with information contained herein.

images, and symbols are the exclusive properties of Research In Motion Limited. RIM, Research In Motion,

BlackBerry, “Always On, Always Connected” and the “envelope in motion” symbol are registered with the

U.S. Patent and Trademark Office and may be pending or registered in other countries.

Eclipse is a trademark of Eclipse Foundation, Inc. Microsoft, Outlook Express, and Windows are trademarks

of Microsoft Corporation. Java and Javadoc are trademarks of Sun Microsystems, Inc. Intel and Pentium are

trademarks of Intel Corporation. All other brands, product names, company names, trademarks and service

marks are the properties of their respective owners.

The BlackBerry device and/or associated software are protected by copyright, international treaties, and

various patents, including one or more of the following U.S. patents: 6,278,442; 6,271,605; 6,219,694;

6,075,470; 6,073,318; D445,428; D433,460; D416,256. Other patents are registered or pending in various

countries around the world. Visit www.rim.com/patents for a list of RIM [as hereinafter defined] patents.

This document is provided “as is” and Research In Motion Limited and its affiliated companies (“RIM”)

assume no responsibility for any typographical, technical, or other inaccuracies in this document. In order to

protect RIM proprietary and confidential information and/or trade secrets, this document may describe some

aspects of RIM technology in generalized terms. RIM reserves the right to periodically change information

that is contained in this document; however, RIM makes no commitment to provide any such changes,

updates, enhancements, or other additions to this document to you in a timely manner or at all. RIM MAKES

NO REPRESENTATIONS, WARRANTIES, CONDITIONS, OR COVENANTS, EITHER EXPRESS OR

IMPLIED (INCLUDING WITHOUT LIMITATION, ANY EXPRESS OR IMPLIED WARRANTIES OR

CONDITIONS OF FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT,

MERCHANTABILITY, DURABILITY, TITLE, OR RELATED TO THE PERFORMANCE OR NON-

PERFORMANCE OF ANY SOFTWARE REFERENCED HEREIN OR PERFORMANCE OF ANY

SERVICES REFERENCED HEREIN). IN CONNECTION WITH YOUR USE OF THIS DOCUMENTATION,

NEITHER RIM NOR ITS RESPECTIVE DIRECTORS, OFFICERS, EMPLOYEES, OR CONSULTANTS

SHALL BE LIABLE TO YOU FOR ANY DAMAGES WHATSOEVER BE THEY DIRECT, ECONOMIC,

COMMERCIAL, SPECIAL, CONSEQUENTIAL, INCIDENTAL, EXEMPLARY, OR INDIRECT DAMAGES,

EVEN IF RIM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, INCLUDING WITHOUT

LIMITATION, LOSS OF BUSINESS REVENUE OR EARNINGS, LOST DATA, DAMAGES CAUSED BY

DELAYS, LOST PROFITS, OR A FAILURE TO REALIZE EXPECTED SAVINGS.

This document might contain references to third-party sources of information, hardware or software,

products or services and/or third-party web sites (collectively the “Third-Party Information”). RIM does not

control, and is not responsible for, any Third-Party Information, including, without limitation the content,

accuracy, copyright compliance, compatibility, performance, trustworthiness, legality, decency, links, or any

other aspect of Third-Party Information. The inclusion of Third-Party Information in this document does not

imply endorsement by RIM of the Third-Party Information or the third-party in any way. Installation and use

of Third-Party Information with RIM's products and services may require one or more patent, trademark, or

with Third-Party Information, including, without limitation, compliance with applicable licenses and terms and

conditions, are solely between you and the third-party. You are solely responsible for determining whether

such third-party licenses are required and are responsible for acquiring any such licenses relating to Third-

Party Information. To the extent that such intellectual property licenses may be required, RIM expressly

recommends that you do not install or use Third-Party Information until all such applicable licenses have

been acquired by you or on your behalf. Your use of Third-Party Information shall be governed by and

subject to you agreeing to the terms of the Third-Party Information licenses. Any Third-Party Information that

BlackBerry Java Development Environment Component Package version 4.7.0 3 of 7

is provided with RIM's products and services is provided “as is”. RIM makes no representation, warranty or

guarantee whatsoever in relation to the Third-Party Information and RIM assumes no liability whatsoever in

relation to the Third-Party Information even if RIM has been advised of the possibility of such damages or

can anticipate such damages.

Send us your comments on release notes and known issues lists:

https://www.blackberry.com/DocsFeedback.

Part number: 12082391

BlackBerry Java Development Environment Component Package version 4.7.0 4 of 7

BlackBerry JDE Component Package system requirements

•Microsoft® Vista™ or Windows® XP

•Intel® Pentium® III processor or compatible (800 MHz or greater)

•128 MB minimum of RAM available

•10 MB of disk space available

•Java 2 Platform, Standard Edition Development Kit (JDK) Version 6 (download from the Sun

Microsystems web site)

BlackBerry JDE Component Package tools

The BlackBerry® Java® Development Environment Component Package contains a subset of the

BlackBerry JDE version 4.7.0 tools. For more information, visit www.blackberry.com/developers.

See the BlackBerry Java Development Environment Development Guide and the BlackBerry Signature Tool

Development Guide for more information about using the BlackBerry JDE Component Package tools.

To access the BlackBerry JDE Component Package tools, click Start > Programs > Research In Motion >

BlackBerry JDE Component Package 4.7.0

Tool Description

BlackBerry JDE API

Reference You can use the API Reference to view Javadoc™ information for the BlackBerry

APIs.

BlackBerry Email

Simulator You can use the BlackBerry® email simulator to send messages between the

BlackBerry Smartphone Simulator and either a messaging application, such as

Microsoft® Outlook®, or POP3 and SMTP servers. You do not require a

BlackBerry® Enterprise Server.

To get the BlackBerry email simulator, download the BlackBerry® JDE Plug-in for

Eclipse™, the BlackBerry Java Development Environment, or the BlackBerry

Email and MDS Services Simulator Package. Visit

www.blackberry.com/developers.

BlackBerry Java samples You can use the Java samples, included with the BlackBerry JDE Component

Package, to view sample applications that are typically available on a BlackBerry

device. The samples demonstrate how to design and build Java applications for

BlackBerry devices.

The following sample applications include server components. Invoke the run.bat

script in the specified folder to start the server component:

• The bluetoothserialportdemo sample includes a server component at

samples/com/rim/samples/server/bluetoothserialportdemo

• The httppushdemo sample includes a server component at

samples/com/rim/samples/server/httppushdemo

• The socketdemo sample includes a server component at

samples/com/rim/samples/server/socketdemo

• The browserpushdemo sample includes a server component at

samples/com/rim/samples/server/browserpushdemo

• The smsdemo sample includes a server component at

samples/com/rim/samples/server/smsdemo

• The browsermultipartpushdemo sample includes a server component at

samples/com/rim/samples/server/browsermultipartpushdemo

• The gpsdemo sample includes a server component at

BlackBerry Java Development Environment Component Package version 4.7.0 5 of 7

samples/com/rim/samples/server/gpsdemo

BlackBerry® MDS

Simulator You can use the BlackBerry® MDS Simulator to simulate the BlackBerry MDS

Connection Service component of the BlackBerry Enterprise Server. You can use

the BlackBerry Smartphone Simulator with the BlackBerry MDS Simulator to test

network, push, and browser applications that are designed for use with a

BlackBerry Enterprise Server. If you test a BlackBerry Java® Application that

requires an HTTP connection, you require the BlackBerry Smartphone Simulator

and the BlackBerry MDS Simulator. To get the BlackBerry MDS Simulator,

download the BlackBerry® JDE Plug-in for Eclipse, the BlackBerry Java

Development Environment, or the BlackBerry Email and MDS Services Simulator

Package. Visit www.blackberry.com/developers.

BlackBerry Smartphone

Simulator You can use the BlackBerry Smartphone Simulator to load and test your

BlackBerry Applications on your computer and to simulate and test connectivity

and state changes. You can use the BlackBerry Smartphone Simulator with the

BlackBerry MDS Simulator and the BlackBerry Email Simulator to test additional

services. To get the BlackBerry Smartphone Simulator, download the BlackBerry

JDE Plug-in for Eclipse, the BlackBerry Java Development Environment, or the

BlackBerry Java Development Environment Component Package. Visit

www.blackberry.com/developers.

Java Loader From the command prompt, you can use the Java Loader tool to perform the

following actions:

add, update, or remove an application on a BlackBerry device for testing

purposes. For production applications, use the BlackBerry Desktop

Software

view information about application .cod files

To run the JavaLoader tool, type a command with the following format:

javaloader [-u] [-p<port>|<pin>] [-b<baud>] [-d0|-d1] [-w<password>] [-q]

Java Debug Wire Protocol You can use the Java Debug Wire Protocol (JDWP) program to debug

applications using third-party integrated development environments. The

BlackBerry JDE Component Package includes the following files that the JDWP

program requires to debug applications:

DefaultBuild.rc: a configuration file

FixedBuild.rc: a configuration file

Launcher.exe: a utility tool

RimUsbJni.dll: a helper file that allows the JDWP program to

communicate with a BlackBerry device through a USB port

Preverify Use the Preverify tool to partially verify your classes before you load your

application onto a BlackBerry device. Completing this step reduces the amount of

processing the device must perform.

The Preverify tool receives a class path as input and produces new classes in an

output directory that you specify.

To run the Preverify tool, from the command prompt, type a command in the

following format:

preverify [-d] output -classpath <directory> input; <directory>

RAPC Use the RAPC command prompt compiler to compile .java and .jar files into .cod

files that you can run in the BlackBerry Smartphone Simulator or load onto a

BlackBerry device. When you invoke RAPC, use the "-import=" option to specify

the net_rim_api.jar file as an input file.

For example, the following command prompt instruction compiles the

SampleApp.jar file into a .cod file of the same name:

rapc import=net_rim_api.jar codename=SampleApp\SampleAppDriver -

BlackBerry Java Development Environment Component Package version 4.7.0 6 of 7

midlet SampleApp.jad Samples\SamplaApp.jar

BlackBerry Signature Tool Use the BlackBerry Signature Tool application to send code signature requests to

the BlackBerry Signing Authority Tool. Send code signature requests when your

application code requires access to controlled APIs, classes, and methods.

UpdateJad Tool You can use UpdateJad to change information in .jad files. For example, change

you can change the .cod file sizes listed in a .jad file, create .jad files that

reference multiple .cod files, and add additional attributes to a .jad file.

Use the Updatejad tool only on .jad files that you create using the BlackBerry®

JDE Plug-in for Eclipse, the BlackBerry® Integrated Development Environment, or

the RAPC command-prompt tool, and signed using the BlackBerry Signing

Authority Tool.

Type the Updatejad commands in the following format:

updatejad.exe -q -n input.jad [additional.jad]

Known issues

This section lists known issues for the BlackBerry® Java® Development Environment Component Package

version 4.7.0

BlackBerry Java Development Environment Installation and BlackBerry JDE Component

Package installation

If you install BlackBerry Java Development Environment version 4.2.0 or earlier after

you install the BlackBerry JDE Component Package, the BlackBerry JDE Signature

Tool installation overrides the BlackBerry JDE Component Package Signature Tool

installation.

Impact: The registry uses the BlackBerry JDE version of the BlackBerry Signature

Tool.

Workaround: Reinstall the BlackBerry JDE Component Package to make sure that

the registry uses the BlackBerry JDE Component Package Signature Tool.

Using Eclipse with the BlackBerry JDE Component Package

To use the BlackBerry® Java® Development Environment Component Package with

the Eclipse development environment, you must set Eclipse to use a Java compiler

compliance level of 1.4.

Impact: When you compile an application, errors might occur when Eclipse attempts

to use a Java compiler compliance level other than 1.4.

Workaround: Perform the following steps:

1. Open Eclipse.

2. On the Project menu, click Properties.

3. Select Java Compiler.

4. In the Compiler compliance level field, select 1.4.

5. Click Apply.

6. Click OK.

BlackBerry Java Development Environment Component Package version 4.7.0 7 of 7

Remove the BlackBerry JDE Component Package

Removing the BlackBerry JDE Component package removes the BlackBerry

Signature Tool registry keys, including those of a pre-installed BlackBerry JDE.

Impact: When you double-click a .csi or .cod file, your system does not know what

application to use to open the file.

Workaround: Reinstall a preceeding version of the BlackBerry JDE.

Ce manuel convient aux modèles suivants

Table des matières

Autres manuels Blackbe;rry Logiciel

Blackbe;rry

Blackbe;rry INTERNET SERVICE Manuel utilisateur

Blackbe;rry

Blackbe;rry CLIENT FOR USE WITH MICROSOFT OFFICE LIVE COMMUNICATIONS SERVER 2005 2.5.40 -... Mode d’emploi

Blackbe;rry

Blackbe;rry TWITTER FOR BLACKBERRY SMARTPHONES 1.0 Mode d’emploi

Blackbe;rry

Blackbe;rry Infinity B1367WD Manuel utilisateur

Blackbe;rry

Blackbe;rry TWITTER FOR SMARTPHONES - BETA V1.0 Manuel utilisateur

Blackbe;rry

Blackbe;rry CLIENT FOR USE WITH MICROSOFT OFFICE COMMUNICATIONS SERVER... Manuel utilisateur

Blackbe;rry

Blackbe;rry Windows Live Messenger for BlackBerry Smartphones... Mode d’emploi

Blackbe;rry

Blackbe;rry PRD-10459-016 - Enterprise Server For MS... Mode d’emploi

Blackbe;rry

Blackbe;rry JAVA DEVELOPMENT ENVIRONMENT - - DEVICE APPLICATIONS INTEGRATION - DEVELOPMENT... Guide de configuration rapide

Blackbe;rry

Blackbe;rry PROFESSIONAL SOFTWARE FOR MICROSOFT EXCHANGE Mode d’emploi

Blackbe;rry

Blackbe;rry APP WORLD STOREFRONT 2.0 - RELEASE NOTES Mode d’emploi

Blackbe;rry

Blackbe;rry S-MIME SUPPORT PACKAGE VERSION 4.1 - Mode d’emploi

Blackbe;rry

Blackbe;rry CLIENT FOR IBM LOTUS SAMETIME 2.5.40 - S Mode d’emploi

Blackbe;rry

Blackbe;rry MAIL - - HELP Manuel utilisateur

Blackbe;rry

Blackbe;rry INTERNET SERVICE - SECURITY Guide d'installation

Blackbe;rry

Blackbe;rry AH0QIKO - Lotus Domino Enterprise Server Manuel d'installation et d'exploitation

Blackbe;rry

Blackbe;rry NEWS FEEDS - RELEASE NOTES 1.0 Mode d’emploi

Blackbe;rry

Blackbe;rry MAIL - BROWSING COMPUTER Manuel utilisateur

Blackbe;rry

Blackbe;rry ENTERPRISE SOLUTION SECURITY - SECURITY FOR DEVICES WITH BLUETOOTH WIRELESS TECHNOLOGY -... Guide d'installation

Blackbe;rry

Blackbe;rry MYSPACE - VERWENDEN DES BROWSERS AUF IHREM... Manuel utilisateur

Blackbe;rry

Blackbe;rry APP WORLD - SPORT CASE Manuel utilisateur

Blackbe;rry

Blackbe;rry JAVA DEVELOPMENT ENVIRONMENT - - FUNDAMENTALS... Manuel utilisateur

Blackbe;rry

Blackbe;rry CLIENT FOR IBM LOTUS SAMETIME 2.5.42 - S... Mode d’emploi

Blackbe;rry

Blackbe;rry FACEBOOK - LEARN MORE Manuel utilisateur

Manuels Logiciel populaires d'autres marques

COMPRO

COMPRO COMPROFM Manuel utilisateur

Muratec

Muratec OFFICEBRIDGE ONLINE Manuel utilisateur

Oracle

Oracle Contact Center Anywhere 8.1 Manuel utilisateur

Adobe

Adobe 65007312 - Photoshop Lightroom Manuel

Avaya

Avaya NULL One-X for RIM Blackberry Manuel utilisateur

HP ProLiant BL420c Manuel utilisateur

PS Audio

PS Audio PowerPlay Manuel du propriétaire

Brady

Brady LOCKOUT PRO 3.0 Manuel de service

Avaya

Avaya Interaction Center Manuel utilisateur

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Manuel

Novell

Novell GROUPWISE 8 - INTERNET AGENT Manuel utilisateur

Oracle

Oracle Application 9i Manuel utilisateur

Acer

Acer RDM Manuel utilisateur

Canon

Canon Vixia HF21 Manuel utilisateur

Canon

Canon ZR950 Manuel utilisateur

Samsung

Samsung Auto Backup Manuel utilisateur

Polycom

Polycom Vortex EF2201 Instructions d'installation et d'utilisation

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c Manuel utilisateur

Blackbe;rry JAVA DEVELOPMENT ENVIRONMENT - - COMPONENT PACKAGE - RELEASE... Mode d’emploi

Manuels Logiciel populaires d'autres marques