Académique Documents
Professionnel Documents
Culture Documents
Copyright Nokia 2006. All rights reserved. This document is for use with the Series 40 Software Developer Kit 3rd Edition Feature Pack 1. Reproduction, transfer, distribution or storage of part or all of the contents in this document in any form without the prior written permission of Nokia is prohibited. Nokia, Series 40 Software Developer Kit 3rd Edition Feature Pack 1, and the Nokia Connecting People logo are trademarks or registered trademarks of Nokia Corporation. Other product and company names mentioned herein may be trademarks or trade names of their respective owners.
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.OpenSSL.org/). Nokia operates a policy of on-going development. Nokia reserves the right to make changes and improvements to any of the products described in this document without prior notice. UNDER NO CIRCUMSTANCES SHALL NOKIA BE RESPONSIBLE FOR ANY LOSS OF DATA OR INCOME OR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL OR INDIRECT DAMAGES HOWSOEVER CAUSED. THE CONTENTS OF THIS DOCUMENT ARE PROVIDED AS IS. EXCEPT AS REQUIRED BY APPLICABLE LAW, NO WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ARE MADE IN RELATION TO THE ACCURACY, RELIABILITY OR CONTENTS OF THIS DOCUMENT. NOKIA RESERVES THE RIGHT TO REVISE THIS DOCUMENT OR WITHDRAW IT AT ANY TIME WITHOUT PRIOR NOTICE. The availability of particular phone products may vary by region. Please check with the Nokia dealer nearest to you. Visit Forum Nokia (http://www.forum.nokia.com), the site designed for developers using technologies supported by Nokia.
Contents
Who should read this guide?........................................................................................................... 5 Typographical conventions used in this guide ................................................................................. 5 Other product documentation........................................................................................................ 6
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
This guide describes how to install and configure the Series 40 Software Developer Kit 3rd Edition Feature Pack 1 (Series 40 SDK 3rd Edition Feature Pack 1).
Text that you enter (as opposed to system prompts and responses); for example, file paths, commands, and program code Names of books and documents New terminology Names of Windows menus, commands, buttons, and icons Active link
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
1
Installing the Series 40 SDK 3rd Edition Feature Pack 1
This document describes what you need to install the Series 40 Software Developer Kit 3rd Edition Feature Pack 1 (Series 40 SDK 3rd Edition Feature Pack 1) and to configure it for use within an integrated development environment (IDE).
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
The Series 40 SDK 3rd Edition Feature Pack 1 supports: Area Java ME Specification JSR 75 File connection and PIM APIs JSR 118 Mobile Information Device Profile (MIDP) 2.0 JSR 135 v1.1 Mobile Media API (audio and video play and audio capture only; does not support for video capture, camera control, or FM radio) JSR 139 Connected Limited Device Configuration (CLDC) 1.1 JSR 172 JAXP Web Services API JSR 184 3D Graphics API JSR 185 Java Technology for Wireless Industry JSR 205 Wireless Messaging API 2.0 JSR 226 Scalable 2D Vector Graphics API Browsing XHTML Mobile Phone (MP) Profile User Agent Profile (UAProf) static Macromedia Flash Lite 1.1 Messaging Digital Rights Management Device Management Multimedia Messaging Service (MMS) with SMIL support Open Mobile Alliance (OMA) Digital Rights Management (DRM) 1.0 (not for MIDlets) OMA Client Provisioning 1.1 WAP/OMA Bootstrapping
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
Hardware requirements
The hardware requirements to install and run the SDK as a standalone tool are: Minimum 667 MHz Pentium processor 100 MB of free hard disk space 256 MB RAM 16-bit color 1024x768 pixel display Keyboard and mouse Recommended 1.8 GHz Pentium processor 140 MB of free hard disk space 512 MB RAM 24-bit color or more 1024x768 pixel display or more Keyboard and mouse
If you plan to work with sound (from MIDlets, for instance), youll also want to have a sound card that has one channel for every SDK instance you run. If you do not have enough channels, SDK instances that you start after you run out of channels will not have sound.
Software requirements
Use one of these operating systems as a minimum software requirement to run the Series 40 SDK 3rd Edition Feature Pack 1 as a standalone: Windows XP Professional Service Pack 2 Windows XP Home Edition Service Pack 2 Windows XP Professional Chinese Service Pack 2 Windows XP Home Edition Chinese Service Pack 2 You will also need to install a public Java SE Runtime Environment (JRE) 5 or higher before you install the SDK.
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
Installing the Series 40 SDK 3rd Edition Feature Pack 1 for use with Eclipse
To use Eclipse with the SDK, youll have to install these applications in the following order: Java SE Development Kit (JDK) Eclipse Carbide.j Series 40 SDK 3rd Edition Feature Pack 1 When you install Carbide.j, make sure you select the option to integrate Carbide.j with Eclipse, or the two applications will not work together correctly.
Installing the Series 40 SDK 3rd Edition Feature Pack 1 for use with Carbide.j
To use Carbide.j standalone installation with the SDK, install the SDK after you install Carbide.j.
Installing the Series 40 SDK 3rd Edition Feature Pack 1 for use with J2MEWTK
To use J2MEWTK with the SDK, install the SDK after you install J2MEWTK. During the SDK installation, you will have a chance to provide the SDK installer with the location of J2MEWTK.
10
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
You need to know the installation directory to integrate with other products. 5 During installation, select the Series 40 SDK Integration with Sun WTK checkbox, if you want to use J2MEWTK with the SDK. If you select this option, the wizard copies SDK files to the J2MEWTK directory.
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
11
12
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
Whats next?
Whats next?
If you plan to work within an IDE, youll need to configure some of the supporting applications to work with the SDK. To prepare an IDE in which to create: Browser and message content - Web content designed to be displayed on a mobile phone, such as DRM, MMS, Push SI 0messages, WML, and XHTML content. See Configuring for Browser and Message Content Development on page 15. MIDP MIDlets (Java Application Descriptor (JAD) and Java ARchive (JAR) files) Games or applications that can be downloaded from the Internet and used on a mobile phone. See Configuring the SDK for MIDP Development on page 19. Or, for information about using the SDK, see Series 40 Software Developer Kit 3rd Edition Feature Pack 1 Users Guide.
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
13
14
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
2
Configuring for Browser and Message Content Development
You can work more efficiently by creating an IDE where you can develop content in an application and directly display it on the SDK. Some applications automatically detect the SDK as a device. Youll need to configure other applications to recognize the SDK before you can use the SDK from within the applications interface. This chapter provides a general overview of what you need to configure the following content authoring applications for use with the Series 40 SDK 3rd Edition Feature Pack 1: Adobe GoLive with NDS for MMS for message development Adobe GoLive with the WML module for WML and XHTML browsing Macromedia Dreamweaver for content (typically, WML and XHTML) browsing For more information on installation, see documentation of the supporting application.
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
15
Configuring Adobe GoLive to display WML and XHTML content on the SDK
By default, the WML module for content authoring is not accessible. You must add the module in Adobe GoLive preferences before you configure Adobe GoLive to recognize the SDK as a browser. To configure Adobe GoLive so you can create a new WML file using a standard WML template: 1 Select Edit>Preferences. 2 On the right panel, select Modules. 3 On the left panel, navigate to the bottom of the list to the Extend Scripts folder and check WML. 4 Click OK. To create a new WML file, select File>New Special>WML Deck. To add Series 40 SDK 3rd Edition Feature Pack 1 as a recognized browser to Adobe GoLive: 1 Select Edit>Preferences. 2 On the right panel, select Browser. 3 Click Add. The Choose Browser dialog box appears. 4 In the Choose Browser dialog box, navigate to the location of the SDK executable file (<SDK installation directory>\bin\emulator.exe) and click OK.
16
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
To display a WML or XHTML file within GoLives content editor on the SDK, select File>Preview In>emulator.exe.
Whats next?
You can begin to use the Series 40 SDK 3rd Edition Feature Pack 1. For information about using the SDK, see Series 40 Software Developer Kit 3rd Edition Feature Pack 1 Users Guide. For late-breaking information, review the release notes. Both documents are located in the doc directory under the SDK installation directory. You can also download the documents from www.forum.nokia.com.
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
17
18
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
3
Configuring the SDK for MIDP Development
You can work more efficiently by creating an IDE where you can develop a MIDlet in an application and directly test it on the SDK. Some applications automatically detect the SDK as a device. Youll need to configure other applications to recognize the SDK before you can start the SDK from within the applications interface. This chapter provides only a general overview of what you need to configure the following MIDP development applications to use the Series 40 SDK 3rd Edition Feature Pack 1: Eclipse Carbide.j Sun NetBeans 4.1 with NetBeans Mobility Pack 4.1 For more information on installation, see IDE documentation.
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
19
Configuring Eclipse to use the Series 40 SDK 3rd Edition Feature Pack 1
To configure Eclipse to recognize the SDK: 1 Run eclipse.exe. 2 From the Eclipse main window, select Window>Preferences... . The Preference window appears. 3 On the left column of the Preference window, click Java to expand it. Click Debug to highlight it. 4 On the right side of the panel, deselect all the options under Suspend Execution. 5 On the right side of the panel under the Communication section, complete the following fields:
Field Debugger timeout (ms) Launch timeout (ms) Enter ... 40000 40000
The values you enter can be greater or lesser, depending on the speed of your computer. You may want to try different values. When the values are too small, the SDK freezes when you try to debug a MIDlet.
20
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
Configuring Carbide.j to use the Series 40 SDK 3rd Edition Feature Pack 1
6 Click OK.
Configuring Carbide.j to use the Series 40 SDK 3rd Edition Feature Pack 1
To configure the SDK with Carbide.j: 1 In the Carbide.j main window, select Emulators>Configure Emulators. 2 Click Add. The Open dialog box appears. 3 Select the SDK installation directory as the UEI emulator root directory and click Open. 4 In the Configure Emulators window, verify that the SDK name appears in the Emulator list and click Close.
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
21
Configuring Sun NetBeans to use the Series 40 SDK 3rd Edition Feature Pack 1
To configure the Series 40 SDK 3rd Edition Feature Pack 1 with NetBeans: 1 In the NetBeans main window, select Tools>Java Platform Manager. The following Java Platform Manager window appears:
2 Click Add Platform .... The Add Java Platform window appears:
22
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
Whats next?
Click the drop-down arrow next to the Look in field to navigate to the SDK installation directory, such as C:\Nokia\Devices\S40_SDK_3rd_Edition_Feature_ Pack_1. 3 Click Next. The IDE detects and configures the platform. 4 When the message, Configuration was successful, displays, click Finish:
5 Click Close to close the Java Platform Manager window. To configure a NetBeans project to use the SDK, see Series 40 Software Developer Kit 3rd Edition Feature Pack 1 Users Guide.
Whats next?
You can begin to use the Series 40 SDK 3rd Edition Feature Pack 1. For information about using the SDK, see Series 40 SDK 3rd Edition Feature Pack 1 Users Guide. For late-breaking information, review the release notes. Both documents are located in the installation directory of the SDK. You can also download the documents from www.forum.nokia.com.
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
23
24
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
Index
Numerics
2D Vector Graphics API 8 3D Graphics API 8
J
J2MEWTK SDK installation 10 Java Technology for Wireless Industry 8
R
registration, SDK 11
A
Adobe GoLive display MMS messages 16 display WML and XHTML content 16
S
SDK configure Adobe GoLive MMS messages 16 WML and XHTML content 16 Carbide.j 21 Dreamweaver 17 Eclipse 20 NDS for MMS 16 NMIT 16 Sun NetBeans 22 install 7, 11 Carbide.j 10 J2MEWTK 10 launch 11 within IDE 12 menu add languages 12 overview of 7 register 11 uninstall 12 software requirements 9 Sun NetBeans 19 configure for SDK 22
L
languages add 12 launch SDK 11 within an IDE 12
C
Carbide.j 19 configure for SDK 21 integrate with Eclipse 10 SDK installation 10 CLDC 8 Connected Limited Device Configuration 8
M
Macromedia Dreamweaver display content 17 Flash Lite 8 MIDP 8 MMS message 8 Mobile Information Device Profile 8 Mobile Media API 8 Multimedia Messaging Service 8
D
Digital Rights Management 8
E
Eclipse 19 configure for SDK 20
N
NCF uninstall 12 NDS for MMS configure for SDK 16 NMIT configure for SDK 16
F
File connection API 8
U
UAProf 8 uninstall SDK 12 User Agent Profile 8
G
General tab, preferences 12
O
OMA Client Provisioning 8 DRM 8
H
hardware requirements 9
W
Web Services API 8 Wireless Messaging API 8
I
install SDK 11
P
PIM APIs 8 preferences General tab 12
X
XHTML Mobile Phone Profile 8
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide
25
Index
26
Series 40 Software Developer Kit 3rd Edition Feature Pack 1, Installation and Configuration Guide