Creating J2ME Applications Using Sync4j, MySQL and Eclipse. Funambol Technical Paper TP200 (Version 1.5) June 2006

Transcription

1 Creating J2ME Applications Using Sync4j, MySQL and Eclipse Funambol Technical Paper TP200 (Version 1.5) June 2006

2 Important Information Copyright Funambol, Inc All rights reserved. The information contained in this publication is subject to US and international copyright laws and treaties. Except as permitted by law, no part of this document may be reproduced or transmitted by any process or means without the prior written consent of Funambol, Inc. Funambol, Inc. has taken care in preparation of this publication, but makes no expressed or implied warranty of any kind. Funambol, Inc. does not guarantee that any information contained herein is and will remain accurate or that use of the information will ensure correct and faultless operation of the relevant software, service or equipment. Funambol, Inc., its agents and employees shall not be held liable for any loss or damage whatsoever resulting from reliance on the information contained herein. Funambol and Sync4j are trademarks and registered trademarks of Funambol, Inc. All other products mentioned herein may be trademarks of their respective companies. Published by Funambol, Inc., 643 Bair Island Road, Suite 305, Redwood City, CA Credits: The primary contributor for this document is François Granade, with editorial support provided by Funambol.

3 Contents Introduction The Mobile Application Architecture Prerequisites Installation and Configuration Obtaining the Software Extracting the Bundled Software Installing the Tools Configuring the Tools Creating the Mobile Application Creating the Project in Eclipse Adding the Java Source Code and Sync4j J2ME Library to the Project Review of the Application Code Testing the Application on a Phone Emulator Adding Synchronization Testing Synchronization on the Phone Emulator Device Deployment Deploying on BlackBerry Deploying on Nokia Deploying the Server Resources iii

4 iv MOBILE APPLICATIONS DEVELOPMENT TUTORIAL

5 Introduction This document describes how to create a mobile application that synchronizes with an enterprise database and runs on most mobile devices. It demonstrates that with the right approach and tools, you can build such an application without getting mired in the individual specifications of the growing number of mobile devices. It will also demonstrate that no unusual technology is needed the tools we will use are readily available from the open source community. In this tutorial, we will use the following software: Sync4j a complete client/server solution for integration between an enterprise back-end (i.e., relational databases and groupware such as Outlook and Notes) and clients (particularly mobile devices). Sync4j is a synchronization engine that optimizes data transfer between entities, as well as a set of tools for data transfer and manipulation. Sync4j hides the complexity of authentication, security, and device recognition, making it easy to exchange data. MySQL the MySQL database is the world's most popular open source database. It features fast performance, high reliability and ease of use, and is used in more than 6 million installations, ranging from large corporations to specialized embedded applications. It's also the database of choice for a new generation of applications built on the LAMP stack (Linux, Apache, MySQL, PHP / Perl / Python). MySQL runs on more than 20 platforms including Linux, Windows, OS/X, HP-UX, AIX, and Netware. Java 2 Micro Edition a set of tools for creating Java applications on small devices. It is the same language as the "desktop" Java, but with a smaller set of APIs and a different framework for building GUIs. Java 2 Micro Edition (J2ME) runs on most devices cell phones, Blackberries, Palm devices such as the Treo, and PocketPCs. J2ME is popular for building mobile applications and is very easy to use if you have experience with Java. EasyEclipse Mobile Java Edition a distribution of Eclipse, the open source Integrated Development Environment (IDE) that compares favorably with commercial products for developing, debugging, and managing software development projects. EasyEclipse distributions include a wide range of plug-ins extensions to Eclipse for a particular usage. In this tutorial we will make use of EclipseME, an extension for building, debugging, and running J2ME applications, and QuantumDB, an extension for manipulating databases. The Mobile Application This tutorial will create a real, working mobile application for a fictional company called Natural Juice, an enterprise that produces and sells fresh, bottled fruit juices. Natural Juice delivers its products directly to stores; its delivery employees stock the products on store shelves and record the quantities delivered at each site. The mobile application will be used by Natural Juice s delivery employees for the following: Download a list of deliveries from a company database. 1

6 After each delivery, update the company s databases with the quantity of bottles delivered. The mobile application will be used on a cell phone. It will connect to Natural Juice s back-end databases, retrieve and send data, and synchronize back-end data and cell phone data. Architecture We will build a synchronized application, to be installed on a mobile device, that will exchange data with enterprise servers only when required by the user. We will maintain the same data table on the client and the server. After configuring Sync4j and the client to communicate, we will run the new application to execute the synchronization process between the client and the Sync4j server. The Sync4j server will analyze the data from both the client and server, determine matching items, and send messages for updating and putting the two in sync. The server acts upon the server database and the client upon the client database to complete the synchronization. MySQL Database RecordStore Server Internet and Wireless Network Mobile Device Sync4j Client J2ME API Import Java... Class { { Sync4j Server Device DB RecordStore Creating this solution is as simple as building a web-based application when using tools such as J2ME and EasyEclipse, with the added benefit that the application will function even when the device cannot connect (or is not connected) to the wireless network. Prerequisites This tutorial assumes knowledge of Java, relational databases, and SQL. Experience with Eclipse and J2ME would be useful but is not required. The system requirements are as follows: Windows 2000 or XP, with a minimum of 600 MB of free disk space. The tutorial should run on Linux, but this has not been tested. Java 2 SDK, Standard Edition version To run the J2ME application, a device such as a BlackBerry (provisioned on a carrier's network) or an emulator such as that used in subsequent sections of the tutorial. The estimated time to complete the tutorial is two hours. 2

7 Installation and Configuration The section provides details for obtaining, installing and configuring the software environment. Obtaining the Software The software tools required for this tutorial are bundled into a single download, with the exception of the Sun J2ME Wireless Toolkit. We strongly recommend that you download and use the bundled package; however, for details on downloading the tools contained in the bundle separately, see Resources on page 23. Bundled Package File: SyncTutorialBundle_v1.5.zip Size: 244 MB Download Site: The file contains the following: Sync4j version 2.3 (includes server, database connector and administration tool) Sync4j libraries for J2ME MySQL Windows Essentials version MySQL JDBC driver EasyEclipse Mobile Java version (includes Eclipse version 3.1 and the EclipseME and QuantumDB plug-ins) Java 2 SDK, SE version 1.4.2_9 Java and SQL files for the tutorial Sun J2ME Wireless Toolkit You must download the Sun J2ME Wireless Toolkit separately (its license does not allow redistribution). File: j2me_wireless_toolkit-2_2-windows.exe Size: 17 MB Download Site: 3

8 Extracting the Bundled Software NOTE: Extracting the contents of SyncTutorialBundle_v1.5.zip creates the directory structure shown below. You should maintain this directory structure throughout the tutorial. If you use WinZip for extraction, use the "Use Folder Names" option. SyncTutorial\ Tutorial root sql\ SQL files src\ org\ sync4j\ j2me\ tutorial\ Java files tools\ Software tools The installation and configuration files are located in \SyncTutorial\tools directory. 4

9 Installing the Tools This section provides instructions on installing the software tools. All installation files are located in the \SyncTutorial\tools directory. Tool Java 2 SDK Sun J2ME Wireless Toolkit Sync4j MySQL EasyEclipse Mobile Java Installation Instructions Installation file: j2sk-1_4_2_09-windows-i586-p.exe 1. Run the toolkit installer. 2. In the Custom Setup window, leave the program features and the installation directory unchanged, and click Next. Installation file: j2me_wireless_toolkit-2_2-windows.exe 1. Run the toolkit installer. 2. The Setup Wizard locates the installed Java 2 SDK(s); click Next to use the displayed J2SDK or browse to locate another J2SDK. 3. Accept the suggested Destination Folder. Installation file: sync4j-2.3.exe Run the installer and use the default options. Installation file: mysql-essential win32.msi 1. Run the installer. When the Setup Wizard prompts for a setup type, select Typical. 2. Accept the suggested Destination Folder. 3. Select Skip Sign-Up if you do not wish to create a MySQL.com account. 4. When the Setup Wizard finishes, leave Configure the MySQL Server now checked and click Finish. 5. When prompted by the Server Instance Configuration Wizard, select Standard Configuration. 6. Leave Install As Windows Service and Launch the MySQL Server automatically checked, so the MySQL server runs in the background and does not need to be started. Without changing any of the other values, click Next. 7. Leave Modify Security Settings checked, and Create An Anonymous Account unchecked. Specify a root password, and make a note of it, as you will need it later, and click Next. 8. Click Execute to start the configuration. Note: An error message (Error Nr. 2003: Can't connect to MySQL server on 'localhost' (10061)) may appear during configuration processing. Click Retry as the problem may be temporary; otherwise, follow the instructions of the error message by opening the port 3306 for connections. If your firewall software does not allow enabling a specific port, you may have to disable the firewall for the duration of the tutorial. Installation file: easyeclipse-mobile-java exe Run the installer and use the default options. 5

10 Configuring the Tools This section provides instructions on configuring the software tools. Adding the Sun J2ME Wireless Toolkit to EasyEclipse 1. Start EasyEclipse by selecting Start > All Programs > EasyEclipse Mobile Java > EasyEclipse Mobile Java. The Workspace Launcher window displays. 2. Accept the suggested Workspace, select the Use this as the default and do not ask again checkbox, and click OK. 3. If running Eclipse for the first time, a Welcome screen displays. Click the X on the Welcome tab to close the screen. You can display it again at any time selecting Help > Welcome. 4. On the Main menu bar, select Window > Preferences. The Preferences window displays. 5. In the left pane, expand J2ME, then click Device Management. 6. In the right pane, click Import. The Import Devices window displays. 7. Click Browse to locate the directory containing the Sun J2ME Wireless Toolkit (\My Computer\Local Disk (C:)\WTK22) and click OK. 8. In the Import Devices window, click Refresh. 9. The list of devices contains four entries. Click Select All to select them (if not already selected). 10. Click Finish. NOTE: 11. In the Device Management window, select the checkbox for the device named DefaultColorPhone (to make it the default device) and click OK. For additional details on EclipseME, see the EclipseME documentation at the following URL: 6

11 Configuring QuantumDB to Access MySQL The JAR file used in this procedure is located in the \SyncTutorial\tools directory. 1. Start EasyEclipse if not already open. 2. On the Main menu bar, select Window > Show View > Other. The Show View window displays. 3. Expand QuantumDB. 4. Press and hold Ctrl, click Database Bookmarks, Quantum SQL Queries View, and Quantum Table View, then click OK. Each of these items displays as a tabbed view in the lower pane. 5. Click the Database Bookmarks tabbed view in the lower pane. 6. Click the New Bookmark icon in the upper right corner of the Database Bookmarks tabbed view. The New Bookmark-JDBC Driver window displays. 7. Click Add driver. The New JDBC Driver window displays. 8. Click Add External Jar, navigate to the \SyncTutorial\tools directory, select the mysql-connector-java bin.jar file and click Open. 9. Click Browse. The Select a Driver window displays. 10. Select the com.mysql.jdbc.driver class and click OK. 11. Verify the Type field displays MySQL and click Finish. 12. Return to the New Bookmark-JDBC Driver window, select the driver you added in Step 11 and click Next. The New Bookmark-Connection details window displays. 13. Specify the following field values: Userid: root Password: <root password you specified in the MySQL installation> Host name: localhost Port: 3306 Database name: mysql Click Next. The NewBookmark-Bookmark Name window displays. 14. Specify the name MySQLAccess and click Finish. 7

12 Configuring the Sync4j Server to Use MySQL In this procedure we will use a text editor to edit files, and use <sync4j_root> to represent the installation directory for Sync4j (e.g., C:\Program Files\Sync4j-2.3\). 1. Copy the \SyncTutorial\tools\mysql-connector-java bin.jar file to the <sync4j_root>\admin\lib\ext directory. This copies the JDBC driver for MySQL to the Sync4j Administration tool. 2. Using a text editor, open the <sync4j_root>\server\install.properties file. Note that commented lines are preceded by the number (#) symbol. 3. Replace the non-commented line dbms=hypersonic with dbms=mysql. 4. Replace the following non-commented lines jdbc.classpath=../tools/hypersonic/lib/hsqldb.jar jdbc.driver=org.hsqldb.jdbcdriver jdbc.url=jdbc:hsqldb:hsql://localhost/sync4j jdbc.user=sa jdbc.password= with the lines jdbc.classpath=../admin/lib/ext/mysql-connector-java bin.jar jdbc.driver=com.mysql.jdbc.driver jdbc.url=jdbc:mysql://localhost:3306/mysql jdbc.user=root jdbc.password=<the root password you specified in the MySQL installation> 5. Save and close the install.properties file. 6. Open a Command Prompt window by selecting Start > All Programs > Accessories > Command Prompt. Run the server installation script by typing the following lines at the prompt: cd <sync4j_root>\server bin\install tomcat You will be prompted to create a series of databases; type y for "yes" for all questions. Some innocuous errors appear during installation that can be ignored. The text of the error include: "Failed to execute: drop table 'sync4j_***", java.sql.sqlexception: Unknown table 'sync4j_***'" and this is repeated several times. 7. To test the installation. connect the Sync4j Administration tool with the Sync4j server. First, stop the Sync4j server (if running) by selecting Start > All Programs > Sync4j 2.3 > Sync4j Server DS > Stop. 8. Start the Sync4j server by selecting Start > All Programs > Sync4j 2.3 > Sync4j Server DS > Start. 9. Start the Sync4j Administration tool by selecting Start > All Programs > Sync4j 2.3 > Sync4j Admin. The Sync4j SyncAdmin window displays. 10. Select File > Login. The Login window displays. 8

13 11. Verify the fields are populated as follows, or specify these values: Hostname/IP: <localhost> (should be your machine name) Port: 8080 User name: admin Password: sa Click Login. The Output Window at the bottom should display "connected." If you have trouble connecting, use (your local IP address) as the Hostname/IP address, and verify that the server is running. 12. In the left pane, expand the localhost tree as follows: localhost > Modules > db > Sync4jDBConnector > Table SyncSource. The Edit Table SyncSource screen appears in the right pane, as shown below: You have successfully connected to the server; this shows the server is working correctly. 9

14 Creating the Mobile Application To create the mobile application, we will perform the following tasks: Create a new project in Eclipse Add the Java source code and Sync4j J2ME library to the project Review the application code Test the application on a phone emulator Add synchronization Test synchronization on the phone emulator Creating the Project in Eclipse In this procedure, we will create the project, select a J2ME platform, and add a midlet (a J2ME application) to the project. 1. Start EasyEclipse by selecting Start > All Programs > EasyEclipse Mobile Java > EasyEclipse Mobile Java. 2. On the Main menu bar, select File > New > Project. The New Project window displays. 3. Expand J2ME, select J2ME Midlet Suite, and click Next. The New J2ME Project window displays. 4. In the Project name field, type SyncTutorial and click Next. The Midlet Suite Properties window displays. 5. Verify that the Group is J2ME Wireless Toolkit 2.2, that the Device is DefaultColorPhone, and click Finish. 6. On the Main menu bar, select File > New > Other. The New Select a Wizard window displays. 7. Expand J2ME, select J2ME Midlet, and click Next. The J2ME Midlet window displays. 8. In the Package field, type org.sync4j.j2me.tutorial. 9. In the Name field, type SyncTutorialMidlet and click Finish. 10

15 Adding the Java Source Code and Sync4j J2ME Library to the Project In this section we will add the application source code to the project, as well as the Sync4j J2ME library that the application will use to connect. 1. Start EasyEclipse if not already open. 2. In Windows Explorer, navigate to the \SyncTutorial\src\org\Sync4j\j2me\tutorial directory and select all the files. Copy them to the SyncTutorial > org > sync4j > j2me > tutorial tree item in the Eclipse Navigator view on the left. When prompted to overwrite SyncTutorialMidlet.java, click Yes. 3. In the Navigator view in the left pane, right-click the root (i.e., SyncTutorial) and select New > Folder. The New Folder window displays. 4. In the Folder name field (near the bottom), type lib. Ensure that the parent folder is SyncTutorial, and click Finish. 5. In Windows Explorer, navigate to the \SyncTutorial\tools\sc-api-j2me.jar file. Drag it to Eclipse and drop it in the lib folder that you created in the previous step (in the Navigator view). 6. In the Navigator view in the left pane, right-click the root (i.e., SyncTutorial), and select Properties. The Properties for SyncTutorial window displays. 7. In the left pane, select Java Build Path, then select the Libraries tab in the right pane. 8. Click Add JARs. The JAR Selection window displays. 9. Expand the tree as follows: SyncTutorial > lib, select sc-api-j2me.jar and click OK. The Sync4j J2ME library is now added to the build path. 10. Click the Order and Export tab, select the sc-api-j2me.jar - SyncTutorial/lib checkbox, then click OK. This ensures the Sync4j J2ME library will be published to the device for the application to run. 11

16 Review of the Application Code To review the code, double-click on each file in the Eclipse Navigator view. There are three types of classes, corresponding to the Model-View-Controller architecture: The SyncTutorialMidlet class is the main class for the application, and the controller. It contains instances of each of the Forms. It also has a reference to the Deliveries object. It contains the logic for transition between screens, by implementing the CommandListener interface, and registering itself as a listener whenever the user clicks or selects an action, this method is called, and the corresponding action is executed. Also, note the DEBUG flag: public static final boolean DEBUG = false; If you encounter problems during the development or testing of the application, you may want to change this flag to true, which will output every exception to the standard output (the Console view in Eclipse). The six Screen classes (DownloadingScreen, DownloadScreen, EditScreen, ListScreen, SettingsScreen and WelcomeScreen) are the views, and each represents a screen of the application. They all inherit from the javax.microedition.lcdui.screen class, or from one of its subclasses, and mostly they contain widgets (known as "Items" in MIDP). The Deliveries object is the model the business object class that manages the data. It has methods to retrieve the data, to iterate, and to set data. Note the SIMULATING flag: private static final boolean SIMULATING = true; This flag toggles between a simulation of the data storage/synchronization, and a real implementation using the SyncClientObject: note how most methods of the Deliveries class have conditional code, implemented locally if SIMULATING is "true," and calling the SyncClientObject if SIMULATING is "true." At first, we are simulating the sync; later, we will change this flag to connect the synchronization server. The SyncClientObject is a generic business class that encapsulates local storage of the data into a RecordStore class from J2ME (J2ME does not provide a file system) and also hides the synchronization mechanism. Note how the SyncClientObject provides helper methods (getfield and setfield) to parse and generate records. The records are XML, but SyncClientObject does not use an XML parser; instead, it parses the XML manually. This would be bad practice with desktop or server-side Java, but is typical of a J2ME application, where system resources are scarce and where, if possible, it is better not to use libraries to implement functionality that can be implemented directly. The SyncClientObject is not specific to this tutorial; it could be useful in any J2ME application using Sync4j. 12

17 Testing the Application on a Phone Emulator 1. Start EasyEclipse if not already open. 2. In the Navigator view in the left pane, right-click SyncTutorialMidlet.java, then select Run As > Emulated J2ME Midlet. The application compiles and runs, the J2ME phone emulator starts, and the application appears as shown below: left selection key right selection key The Welcome screen displays on the device with a message to download deliveries for the day. 3. Download deliveries by clicking the right selection key. The screen displays synchronization results in this case, successful synchronization with three deliveries. (we have not synchronized with MySQL yet; this is sample data included with the application). This simulated download is achieved by calling the retrieve() methods of the Deliveries class described in a previous section. 13

18 4. Click the right selection key again. The screen displays the three deliveries. 5. To view details of a delivery, use the up and downs arrows on the Select key to select a delivery, then click right selection key. A menu displays in the lower right corner of the screen with View details/edit selected. Click the Select key. Details of the delivery display. To insert a quantity, click the arrows on the Select key to navigate to the Quantity field, then use the Clear key and the numeric keys to enter a number. To save the quantity (on the client), click right selection key. 6. Once you have tested the application, close it by clicking the Exit function with the left selection key. 14

19 Adding Synchronization To add synchronization to the mobile application, we will perform the following tasks: Create and populate a table in MySQL Set up a SyncSource in Sync4j Set up the client for synchronization Creating and Populating a Table in MySQL To create a table in MySQL, and populate it with delivery sample data, run the \SyncTutorial\sql\deliveries.sql script using the QuantumDB plug-in. 1. Start EasyEclipse if not already open. 2. Select the Database Bookmark tab in the lower pane. Displayed in the tab is the bookmark MySQLAccess that you created in the last step of Configuring QuantumDB to Access MySQL on page Connect to the database (if not connected) by right-clicking the bookmark and selecting Connect. 4. Select the Quantum SQL Queries View tab. Click the down arrow (Menu) which is third from the right corner, and select Import Query. 5. Navigate to the \SyncTutorial\sql directory and select the deliveries.sql file. The SQL statements display in the Queries View. 6. Click the green arrow (Execute) to the right of the tabs. The Select a Bookmark window displays. 7. Select MySQLAccess and click OK. The script executes in the database. The status bar at the bottom of the Eclipse window should display the following result: Done (5 queries executed, 3 rows updated, 0 result sets displayed, 0 errors, xxx seconds) 15

20 Setting Up the SyncSource in Sync4j A SyncSource defines the table, columns, and database to be accessed when a client requests the synchronization of a specific URI (Universal Resource Identifiers). URI are strings (that resemble URLs) the client passes to the server. 1. Start the Sync4j server by selecting Start > All Programs > Sync4j 2.3 > Sync4j Server DS > Start. 2. Start the Sync4j Administration tool by selecting Start > All Programs > Sync4j 2.3 > Sync4j Admin. The Sync4j SyncAdmin window displays. 3. In the left pane, expand the localhost tree as follows: localhost > Modules > db > Sync4jDBConnector > Table SyncSource. The Edit Table SyncSource screen displays in the right pane. 4. Specify the following field values: Source URI: Name:./deliveries DeliverySyncSource Retain the default values for Type and JNDI Name datasource. Click Load data from db. The Load data from db window displays. 5. Specify the following field values: Driver: URL: User: Password: com.mysql.jdbc.driver jdbc:mysql://localhost:3306/mysql root <root password you specified in the MySQL installation> Retain the default value for Jar driver. Click Connect. This populates the Tables List. If you fail to connect, verify the field values specified above were typed correctly. 6. In the Tables List, select deliveries. This populates the Columns List. 7. Click OK. In the Table Info section, specify the following values: Table name: Key field: Last update timestamp field: Last update type field: Principal field: deliveries id last_update state (leave empty) 8. In the Field Mapping list box, select the last_update line, then click Remove. Repeat this operation for the principal, state, and id lines. The remaining fields are contact, address, schedule, quantity, and company. 9. Scroll to the bottom of the pane and click Add. The SyncSource now displays in the left pane and can be used by the client application. 16

21 Configuring the Client for Synchronization To add synchronization, we will modify code we have already imported in the application. 1. Start EasyEclipse if not already open. 2. In the left pane, expand SyncTutorial > org > sync4j > j2me > tutorial, then double-click Deliveries.java. 3. Find the following declaration: private static final boolean SIMULATING = true; 4. Change the value from true to false as follows: private static final boolean SIMULATING = false; 5. Save the file. Eclipse automatically recompiles the application 17

22 Testing Synchronization on the Phone Emulator 1. Start EasyEclipse if not already open. 2. In the Navigator view, right-click SyncTutorialMidlet.java, then select Run As > Emulated J2ME Midlet. The application compiles and runs, and the J2ME phone emulator starts. 3. Download deliveries by clicking the right selection key. The application appears as below: This screen is not part of the application; the emulator simulates a real device by asking the user s permission to use the network. If the above screen is not displayed, and instead the menu displays in the lower right corner, click the down arrow of the Select key to select Sync on the menu, then click the center of the Select key. 4. Click the right selection key again. The screen displays synchronization results in this case, successful synchronization with three deliveries. 18

23 5. Click the right selection key again. The screen displays the three deliveries, this time coming from the server. 6. To view delivery details for MacroSwift, use the up and downs arrows on the Select key to ensure it is highlighted, then click right selection key. A menu displays in the lower right corner of the screen with View details/edit selected. Click the Select key. Details of the Macroswift delivery display. Navigate to the Quantity field and use the Clear key and the numeric keys to update the quantity to To save the quantity, click right selection key. 7. Click right selection key again. The menu displays in the lower right corner of the screen with View details/edit selected. Click the down arrow of the Select key to select Sync on the menu, then click the center of the Select key. This updates the quantity on the server. 8. To view the data on the server in Eclipse, select the Database Bookmark tab in the lower pane. Expand root@localhost > Tables, right-click deliveries, and select View Table. 19

24 9. Select the Quantum Table View tab in the lower pane and note the updated quantity for Macroswift. Troubleshooting If you have difficulties with the synchronization, try the following steps (in this order): Delete the SyncSource in the Sync Admin, then recreate it. Increase the log level by selecting the Server Settings tree item in the Sync Admin, and look at the log files (in the Windows Start menu item). Report your issues to Sync4j newsgroups or mailing lists at 20

25 Device Deployment We have developed a working application, but so far have run it only in the Wireless Development Toolkit emulator. To deploy on actual devices, you will need to use the development kit provided by the appropriate vendor. The application should not require any changes; below are some general pointers for specific devices. Deploying on BlackBerry Deploying the application on BlackBerry is not difficult. Sun provides a good tutorial at the following site: You will need the BlackBerry Java Development Environment, available at the following site: You should download and install the correct version of the JDE for your device (they are not all compatible). You will need the BlackBerry Desktop Manager installed on your PC and a USB cable, which the Desktop Manager uses to communicate with the device and load the application. Deploying on Nokia To deploy on a Nokia phone, copy the following files to the device (using infrared, Bluetooth, or a USB connection): SyncTutorialMidlet.jar SyncTutorialMidlet.jad Run the JAR file and install the application. See the developer kit for your device for details. Nokia provides Java tools and a SDK on their developer website, including a minimal Eclipse integration. 21

26 Deploying the Server To use the application over-the-air, the server must be accessible on the Internet. You must have a public IP address an IP address visible by anyone on the Internet. You configure the Sync4j server with this IP address. For details, see the Sync4j Server DS Administration Guide. You also set the IP address in the deployment device s settings; an example is shown below: Replace the localhost portion of the URL with the IP address. 22

27 Resources The download sites for the software tools used in the project are listed below. Sync4j bundle 2.3 for Windows File: sync4j-2.3.exe Download site: SyncClient API Java J2ME File: sync4j-client-api-java-j2me zip Download site: MySQL Windows Essentials (x86) File: mysql-essential win32.msi Download site: MySQL Connector/J File: mysql-connector-java zip Download site: Java 2 SDK, SE version (Standard Edition, not with NetBeans or J2EE) File: j2sdk-1_4_2_09-windows-i586-p.exe Download site: EasyEclipse Mobile Java File: easyeclipse-mobile-java exe Download site: If you have already installed a base Eclipse SDK (must be version 3.1), you can install the plug-ins separately. You can download EclipseME and QuantumDB from their respective update sites using the update manager: However, we strongly advise using the EasyEclipse Mobile Java distribution to avoid problems with versions, and to ensure the results described in this document. 23