Home

Nokia 3300 Software Developer s Kit Version 1.0 User Guide

1. NOKIA Nokia 3300 Software Developer s Kit Version 1 0 User s Guide September 2003 Copyright Nokia 2003 All rights reserved This document is for use with the Nokia 3300 Software Developer s Kit 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 Nokia 3300 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 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 WIT
2. Used Bytes of the KVM heap that are in current use Total The total size of the KVM heapsize To modify the size of the KVM heapsize see Setting MIDlet KVM Speed on page 22 About JAM Storage Status Click a folder If a folder has content it opens to display The MIDlets that are stored in the folder The name and total size in bytes of the MIDlet suite which consists of JAR and JAD files The size of the JAD file in bytes The size of the JAR file in bytes The status of SMS messages that are generated by MIDIlets A folder that is empty remains closed when you click it The storage size of a file reflects the size of the file on the handset without the file system overhead of file headers This size as it is reported in the Diagnostics window is always larger than the actual data size of the file 42 Nokia 3300 SDK User s Guide About the Browser Source View About the Browser Source View The Browser Source view displays the source code of the content that is currently loaded on the SDK browser When the view is closed you see the name of the current content its file type and size PES UNOM eis tj x Traffic HTTP 7 6 UDP 571618063 38 image gif ISO 8859 1 8558 bytes MIDP RAM Used 0 bytes 0 applications 5502 bytes games 0 bytes java SMS 0 byt Browser Source http JAwywvy google com text html 2690 bytes lt Content name type and si
3. version Displays version information about the Browser This option does not create a new instance MIDP Xinbox lt directory name gt Specifies the directory that the new instance MMS of the SDK checks for MMS files For example emulator exe Xinbox d MMSFiles When you place MMS files in the directory the SDK displays and then deletes them The directory name can be absolute or relative to the location of emulator exe If the directory does not exist when you use the Xinbox option the SDK creates it This function is available only through the command line interface Xontop Specifies that the SDK GUI should remain Browser on top of all other open windows and must MMS be minimized or moved to get at windows below it MIDP Default value off Xoutbox lt directory name gt Specifies the directory that to which the MMS SDK sends messages as MMS files For example emulator exe Xoutbox d MMSSentFiles The pathname must be absolute If the directory does not exist when you use the Xoutbox option the SDK creates it This function is available only through the command line interface Xwap gateway lt ip_address port_number gt Sets IP address and port number of the Browser WAP gateway You can use the following MIDP ports 9200 9201 9203 For example Xwap_gatway 127 0 0 1 9201 This option always affects the Browser but it affects MIDP only if you specify Xprotocol lt WA
4. Getting Information About the Content on the SDK When you open the view you see the list of locations with the most recent location at the bottom The location that is currently displayed on the browser is highlighted 7 3300000 Diagnostics Nokia 3300 SDK Traffic HTTP 76 UDP 571618063 3 image gif ISO 8859 1 8558 bytes E MIDP RAM Used 0 bytes 0 applications 5502 bytes games 0 bytes java SMS 0 byt Browser Source http fv google com textntml 2690 bytes E Browser History Click to clear traffic display http www google com i Log View of TCPJUDP Received has been disabled The Browser history on the SDK is erased when you e Quit the browser e Open local content using File gt Open e Browse to new content using File gt Open Preview new content from an IDE To preserve the browser history when you change web sites change web sites with the menus on the SDK as you would on the handset For example 1 Select Menu gt Services gt Bookmarks gt Options gt New Bookmark and enter http wap yahoo com Then select OK and enter Yahoo for the title Select OK 2 Select Options gt New Bookmark and enter http wap ayg com Then select OK and enter AYG for the title Select OK 3 Select Yahoo gt Options gt Go To Yahoo com loads on the browser and the browser history records the URL 4 Select Options gt Bookmarks gt Google gt Options gt Go To AYG com loads on t
5. Working with Push Messages Creating a Push Message with NMIT You can use Nokia Mobile Internet Toolkit 4 0 NMIT 4 0 to preview SI or SL push message on the SDK The SDK used as standalone application or with Adobe GoLive does not support Push messages This example shows how to create and push an SI message from NMIT 4 0 1 In NMIT 4 0 select Tools gt SDK Control Panel and start and instance of the Nokia 3300 SDK as the active device Go lt Type url here gt Bookmarks 2 In NMIT do one of the following e Select File gt Open from NMIT s main menu or from the Toolkit Editors window and select a local SI or SL file Click Open NMIT displays the SI file in the Toolkit Editors window e Select File gt New from NMIT s main menu or from the Toolkit Editors window Enter the text you want for the text announcement in the Text Message box and the URL to be retrieved in the href box With either choice this dialog box appears A Nokia Mobile Internet Toolkit E o x Fie Edt windows Tools Help NMIL4 0 Content Type fapplication vnd wap sic D Optional Push Headers arte eC Co A e e aE Text Message Howay fret O conten of Push message action signal high D Optional Content Fields Push Store Source Store Binary E 3 Click Store Binary to create an SIC Push message 4 Click Push to send the message to the SDK Nokia 3300 SDK User s Guide 55 Usi
6. as an option You can specify multiple options each one preceded by a dash with a space between each option as well as between an option and any subsequent or preceding option value If a value contains one or more space characters the value must be enclosed between quotation marks For example the following command starts the SDK specifying it should always remain on top of other windows and that it should display menu names in Finnish emulator exe Xontop Xlanguage Finnish Some options work only with emulator exe or 3300 exe These options are specifically marked with the name of the executable that supports them Options work with both executables are simply listed Options that emulator exe does not support are ignored when you use them and the command continues to execute those options it supports Nokia 3300 SDK User s Guide 69 Running the SDK from a Command Line Options that 3300 exe does not support cause an error message to be displayed and the command to fail Getting Information About the CLI Options To display a summary on the screen of the command line options in the Nokia 3300 SDK type emulator exe help or 3300 exe help Depending on the executable you use the command displays in the DOS Console a list of the options that work with the executable The help option must be the only option in a command Options for Managing SDK Instances You can use these options to manage SDK instances Opti
7. ay Browser History v ee The information in the Diagnostic window lets you see information in views To see Look at this view Information about requests to and responses from the Internet Traffic Information about KVM and JAM status MIDP The source code of the content that is currently loaded Browser Source on the SDK browser A history list of the SDK browser Browser History Warning messages Log For more information about the Diagnostic window see Getting Information About the Content on the SDK on page 35 10 Nokia 3300 SDK User s Guide Setting Up the Nokia 3300 SDK About the Tracing Options You can also activate tracing options that help you debug the content These tracing options are displayed in the DOS Console s Nokia Devices Nokia_3300_SDK_Beta_O_5 ban emulator exer K_Deta_6_5 3308 SDK Deta For more information about tracing options and running the SDK from the command line see Running the SDK from a Command Line on page 67 Setting Up the Nokia 3300 SDK To control some aspects of how the SDK operates and looks select Tools gt Settings In Settings you can set values for attributes such as the language in which the phone menus are displayed the network connection mode you want to use and settings for running MIDlets For more information see Setting Up the Nokia 3300 SDK on page 15 The Settings window looks like this General Networking MID
8. e image vnd wap wbmp e image bmp e image vnd nok wallpaper e application vnd nokia ringing tone e audio mid e audio midi e audio x midi e audio sp midi P d d e audio x mid d d d e audio amr wb text vnd sun j2me app descriptor e application java e application x nokiagamedata e image vnd nok oplogo color Emulating a Multi Media Memory Card MMC on the SDK The Nokia 3300 handset can use a Multi Media Memory Card MMC to augment its memory The SDK emulates an MMC card by creating a default MMC directory structure for each SDK instance The MMC directories are located in C lt Nokia_ 3300 SDK 1 0 install directory gt bin Storage lt instance identifier gt MMC If the content of the memory card is empty when you use the SDK the SDK creates a default directory structure with the following directories Applications Backup Music Recordings Tones and Track Lists The MMC directory structure is persistent and applies to any SDK instance with a matching instance identifier The SDK reads the content of MMC folder from the hard drive only at startup A running SDK instance is not affected if you change the content of the MMC directory after the instance starts If the MMC directory for an SDK instance already exists the SDK uses the directory as it exists You can modify the MMC directory and the SDK will display the sub directory names as folders and let you save content in those folders through the SDK
9. outside a shell to close all running SDK instance You can enter only one parameter on the command line The parameter must be the last item on the line after any options on the line For example e 3300 exe load http server domain welcome wml This example loads the site http server domain welcome wml into the SDK instance that is created e 3300 exe close exitall This example closes all open Nokia 3300 SDK instances 74 Nokia 3300 SDK User s Guide Working With a CLI Shell to Repeatedly Send Commands Working With a CLI Shell to Repeatedly Send Commands Use the shel1 option with 3300 exe to create a session where you can repeatedly send commands to the one instance without having to recreate the instance with every parameter You can attach a shell to an instance that was created through a standalone SDK or through an application such as JBuilder In this example more than one instance is running 3300 exe shell use 330001 lt Create a shell using instance 3300001 gt gt instance 330001 gt load http server domain welcome wml Load this web site into instance 3300001 in the shell S gt gt load ok gt load c welcome wml q Load this WML file into instance 3300001 in the gt gt load ok shell gt clos lt Close the shell Instance 3300001 continues to exist gt gt detaching To close both the shell and the instance within the shell
10. Content Development About MMS Messages An MMS message contains rich media content that may include one or more text image or audio component An MMS message can optionally also include a SMIL Synchronized Multimedia Integration Language component that specifies the layout sequence and timing of the parts in the MMS message on a handset Nokia 3300 SDK can handle an MMS message whose content contains one or more parts of these content types Content Type File format Can Only Be Received image jpeg JPEG image gif GIF87a GIF89a image png PNG image bmp BMP image vnd wap wbmp WBMP image vnd nok wallpaper wallpaper Yes audio midi MIDI Yes audio mid audio x mid audio sp midi MIDI Yes audio x midi MIDI Yes audio amr wb MIDI text plain text Some content types can only be received they cannot be forwarded For example you can t forward a MIDI content type audio midi that contains a ring tone you ve purchased Creating an MMS Message Directly on the SDK You can simulate how a user creates an MMS message on a handset by clicking the keys on the SDK To create an MMS message directly on the SDK 1 Select Menu then select Messages 2 Select Multimedia Msgs gt Create Message and type the text of the message 50 Nokia 3300 SDK User s Guide Creating and Previewing an MMS Message Using NMIT 4 0 3 Do one or both of the following e Select Options gt Insert Im
11. F 4 MIDP RAM Used 0 bytes 0 applications 5502 bytes games 0 bytes java SMS 0 byt Browser Source http wy google com text html 2690 bytes Browser History Stack size 1 Log View of TCP AUDP Received has been disabled The most recent transaction appears at the bottom of the list If an SMS message is shorter than 19 characters the entire message is displayed If it is longer than 10 characters only the first 9 characters of the message is displayed Binary SMS messages are not displayed To display only some of the transactions click Filter and check only the categories of transactions you want to display The information about the categories you don t check is available but undisplayed until you check them The filter settings are persistent between instance invocations The filter categories are Check this filter For information about Requests Requests that originate in the SDK For example when the SDK sends a request to a web server the transaction is recorded under Requests Content Responses Responses made to the SDK as a result of a request the SDK made For example a web site responds to the SDK s request for it by loading on the browser and the transaction is recorded under Content Responses Pushed Messages Unsolicited transactions that is a transaction that is not a result of a request the SDK made Examples of these transactions include Push
12. HTTP connection when the SDK is configured to use the WAP stack UDP datagram reception The browser receives an HTTP response e A MIDlet receives an HTTP response on an HTTP connection when the SDK is configured to use the WAP stack MMS message sending An MMS message was sent using the phone menus MMS message reception An MMS message was opened by the SDK or pushed by an external tool such as Nokia Developer s Suite for MMS 1 0 or Nokia Mobile Internet Toolkit 4 0 on the DSCLI interface 38 Nokia 3300 SDK User s Guide About the Traffic View This event Is triggered by WAP push message reception A WAP push message was opened by the SDK or pushed by an external tool such as Nokia Developer s Suite for MMS 1 0 or Nokia Mobile Internet Toolkit 4 0 on the DSCLI interface SMS message fragment sending SMS message fragment reception A short message fragment is sent to or through the Messages gt Create Message gt Send menu option or received from another client A MIDlet sends a short messages fragment through the sms schema or receives a short message fragment ona short message connection SMS message sending SMS message reception A short message fragment is sent to another client through the Messages gt Create Message gt Send menu option or receives a short message from another client A MIDlet sends a short messages using the sms schema or receives a short messag
13. MIDlet can be more constraining but truer to what a user does when using a Nokia 3300 handset Provisioning also provides a validation process that ensures the MIDlet is usable on the SDK Here is a comparison between provisioning and not provisioning a MIDlet MIDlet trait With provisioning Without provisioning Validated JAD and JAR files Yes No MIDlet installed in the SDK instance s Games Yes No or Applications folder Maximum size of JAD file 5000 bytes 300 kb 60 Nokia 3300 SDK User s Guide About Loading MIDlets With and Without Provisioning MIDlet trait With provisioning Without provisioning Maximum size of JAR file e 32 200 bytes if 300 kb over the air Can be changed in downloaded Tools gt Preferences gt MIDP e 63 720 bytes otherwise Running a MIDlet Without Provisioning Running a MIDlet without provisioning on the SDK e Lets you develop a MIDlet from within an IDE during which you edit and compile code and then immediately display the results on the SDK Isa good way to test how a user runs a MIDlet that is already loaded on a Nokia 3300 handset You can run a MIDlet without provisioning by e Using the command line interface without the provisioning option to open a MIDlet from a local hard drive For example emulator exe bounce jar See Running the SDK from a Command Line on page 67 e Using File gt Open and entering the pathname of a local JAD or JAR file e Se
14. Right Right arrow Send NumPad slash End NumPad minus number sign NumPad period asterisk NumPad Numbers 0 through 9 NumPad 0 through NumPad 9 Music key lt Ctrl gt lt m gt inputting Text From the Keyboard You can type on your computer keyboard and have the characters appear in the display screen of the SDK For example if the SDK browser is currently displaying a text entry box contained in an XHTML page you browsed to you can enter characters into the box by typing on the keyboard Characters entered into the SDK in this manner are not mapped directly to the SDK soft keys as are the shortcut keys listed in Emulating Mouse Clicks With Keyboard Shortcuts on page 28 28 Nokia 3300 SDK User s Guide Working With Content Types For example if you press the shortcut key Numpad 5 you will see the Number 5 soft key on the SDK flash briefly indicating a soft key press on the SDK GUI and the letter J appears in the text box If you press the 5 key on the keyboard the SDK soft key does not flash and a S appears in the text box because the 5 key is not mapped directly to an SDK soft key When the SDK is in edit mode a small pen icon appears in the upper left corner of the display and dictionary that is predictive text or T9 is not on you can use all the alphanumeric PC keys a z A Z 0 9 some of the non alphanumeric characters OHS amp 4 3 lt gt
15. SDK 3 NMIT starts the Nokia 3300 SDK and the panel displays the SDK instance identifier To start another instance of the Nokia 3300 SDK click the Start icon again 4 Click Push within the MMS Message Editor to send the MMS message to the SDK s Message Inbox Nokia 3300 SDK User s Guide 51 Using the SDK for Message Content Development The SDK displays a note that an MMS message has arrived If the SDK is in browsing mode the MMS message announcement is not displayed and you must use the phone menus to quit the browser to see the announcement To close an SDK instance select File gt Exit from the SDK even if you have started the instance from within NMIT Creating and Sending an MMS Message With Adobe GoLive and NDS for MMS To create an MMS message in Adobe GoLive you edit a SMIL document by entering the file paths for all media parts to be included in the MMS message Then you use NDS for MMS under the Nokia Tools menu to wrap the MMS message with MMS headers and you save the message To view MMS messages on the SDK using NDS for MMS within Adobe GoLive 1 In Adobe GoLive do one of these steps e Select File gt New Special gt SMIL Document to create a SMIL file Adobe GoLive opens a SMIL document template in an editor window e Select File gt Open to open a smI1 file like the one below I lox Layout Ld Source KE N ic Alm BR il lt smil xmins http Awww w3 org 2000 SMIL20 CR Languag
16. Use HTTP for MIDlets You might also need to use an HTTP proxy server if the Internet requests made from your computer passes through a proxy which would be the case for example if you were working within a corporate Intranet To set an HTTP proxy check Use an HTTP proxy server and specify the address of the proxy server for example 113 14 176 11 Or proxy domain and a port number This information is available from your system administrator 18 Nokia 3300 SDK User s Guide Setting Up Preferences Setting MIDP Provisioning and Execution Options Select Tools gt Settings and click MIDP to set options that help you run MIDlets The MIDP tab looks like this General Networking MIDP MIDP Monitor IV Overule default handset behavior m MIDlet provisioning Provisioning mode Install MIDlets through JAM Non provisioning mode Execute MIDlets immediately M Set maximum JAR size JAR size bytes 307200 MIDlet execution IV Overrule default MIDP security policy Network access Allowed bd Messaging access wea I Set KVM heapsize requires MIDlet restart KVM heapsize byte asmo IV Enable persistent record store RAMS emulation Cancel Apply To access the options on the MIDP tab check Overrule default handset behavior Setting the Provisioning Mode For information about loading MIDlets see About Loading MIDlets With and Without Provisioning on page 60 In the MIDlet Provisio
17. _ and space key to enter text Those characters are mapped to the corresponding non numpad PC keyboard keys This feature is not available for the following languages e Arabic e Chinese Simplified and Traditional e Hebrew e Thai e Vietnamese The full keyboard input is only implemented for text boxes Working With Content Types On the SDK you can browse directly to some content types using File gt Open You can access other content types if they are in line with or referenced from a WML HTML or COD file What Content Types Are Mapped to What File Types in the SDK Because local files do not go through a server the SDK provides an internal mapping between file types and content types For example when you use File gt Open to load a local sic file the SDK uses content type application vnd wap sic This table lists the mappings between file types and content types File suffix Content type presented to the SDK File Content awb audio amr wb Audio file xhtml text html XHTML file html htm wml text vnd wap wml WML file cod text x co desc Content Descriptor file mms application vnd wap mms message MMS message file sic application vnd wap sic Encoded WAP Push SI message Nokia 3300 SDK User s Guide 29 Using the Nokia 3300 SDK File suffix Content type presented to the SDK File Content gif image gif GIF file png image png PN
18. aliqn LCC gt E lt tr gt j st d gt WMLC Content Date m te ole Ss gt A v L 1 1 Unknown source characters 306 encoded bytes UT 44 Nokia 3300 SDK User s Guide About the Browser History View The Bytecode view displays the bytes the SDK receives Some content types such as images are available only in bytecode You cannot edit Bytecode Browser Source v 7 Bytecode 00000000 6l 69 6E 79 2E 77 a po0000 72 64 31 00 36 03 00000020 72 65 63 61 73 74 C 00000030 4C 43 43 00 01 SE C oo0000 46 27 63 61 73 74 00000050 0l 5E 5D 03 E gt L 1 1 Unknown source characters 306 encoded bytes UT About the Browser History View The Browser History view displays the list of sites that have been displayed on the Browser during the current session When the Browser History view is closed you see a summary of the number of sites listed in the open view 73 3300000 Diagnostics Nokia 3300 SDK Traffic HTTP 2 2 UDP 1878 2942 38 image gif ISO 8859 1 8558 bytes MIDP RAM Used 0 bytes 0 applications 0 bytes games 0 bytes java SMS 0 bytes Browser Source http www google com text html 2690 bytes Browser History lt Last entry in history Stack size 1 Log Warning Filter for TCPAUDP Received is turned off Nokia 3300 SDK User s Guide 4S
19. and MMS messages that you can send to the SDK from IDEs the CLI or File gt Open 40 Nokia 3300 SDK User s Guide About MIDP View Check this filter For information about SMS Sent Short Message Service Messages sent including the size of whole messages and message fragments SMS Received Short Message Service Messages received including the size of whole messages and message fragments TCP UDP Sent User Datagram Protocol and User Datagram Protocol of messages the SDK sends If you uncheck this filter a note that this filter is inactive appears in the Log view TCP UDP Received User Datagram Protocol and User Datagram Protocol of messages the SDK receives If you uncheck this filter a note that this filter is inactive appears in the Log view About MIDP View The MIDP view provides information about e JAM Java Application Manager storage size that is how much space provisioned MIDlets occupy the size of unprovisioned MIDIlets is not recorded JAM storage size does not take into account how much additional space MIDIlets require to run e KVM kilobyte virtual machine is software that is an interface between Java binary code and the microprocessor on a computer that actually performs the program s instructions The size of the KVM memory heap heapsize controls how much memory a MIDlet can take to run on the SDK See About KVM Heapsize Status on page 42 The KVM status is updated as a MIDlet runs When
20. in several formats depending on the content that s on the browser To see what views are available click on the drop down menu on the top right corner of the Browser Source view These options are available under these circumstances If the current content is You can view the source as Unencoded as in XHTML or WML Original source code Encoded as in binary WML wmic Decoded WML Element Tree Byte Code Nokia Mobile Internet Toolkit NMIT always encodes WML content into WMLC before passing it to the SDK Therefore the Original Source view is not available when you are using source that comes from NMIT When content is encoded WML you can choose from among three views e The Decoded WML view displays the result of decoding an encoded response received from a server Browser Source v Fi Decoded VVML lt xml version 1 0 7 gt DOCTYPE wml PUBLIC WAPFORUM DTD WML swul card id cardl title Weather Forecast lt p gt lt table columns 3 aligqn LCC gt ss S L v1 1 Unknown source characters 306 encoded bytes UT The Element Tree view displays a parse tree of the current content as the SDK received it This view is useful for detecting the hierarchical structure of the content Element Tree i A title Weather Forecast Fj Browser Source v lt wml gt eard id cardl lt p gt lt table columns 3
21. next section About the Command Line Syntax The syntax for the command that starts the SDK is lt installation directory gt bin lt executable gt option parameter This table summarizes the components of the syntax Component Description executable The SDK can supports two executables e emulator exe Runs UEI compliant options which are generally used for MIDP MIDlet development e 3300 exe Runs mostly non UEI compliant options and parameters that are usually used in message development See About the Executables on page 69 option Options generally specify configuration settings for the SDK such as the language it uses in each SDK instance and what events to trace Most options work with emulator exe and 3300 exe however some options work only with one of the executables Those options are noted See About Options on page 69 parameter Parameters either load content or close an instance Parameters work only with the 3300 exe executable You can have only one parameter per command line Separate a parameter from any other element with spaces The parameter and any options that go with it must be the last item in the command The two parameters you can use are load and close See About Parameters on page 74 68 Nokia 3300 SDK User s Guide About the Executables About the Executables The SDK supports two executables e emulator exe Runs UEI compliant
22. on the browser Previewing and Browsing With NMIT You can preview local files and browse mobile Internet content on the SDK when you use the Nokia Mobile Internet Toolkit To preview In NMIT do one of the following Local File Content e Select File gt Open to open a local file in NMIT s Editor window and then click Show to preview the file on the SDK Select File gt New to create a new file in NMIT s Editor window and then click Show to preview the file on the SDK 26 Nokia 3300 SDK User s Guide Viewing the Content Mobile Internet Content Select Tools gt SDK Control Panel In the SDK Control Panel dialogs that appears Enter the URL you want into the address bar and then press Return Click Bookmarks and select a URL you have previously bookmarked Previewing WML Files Within Adobe GoLive When you use Adobe GoLive you can preview only local content on the SDK You cannot browse mobile Internet content from within GoLive To preview local content 1 Do one of the following in Adobe GoLive e Select File gt New Special gt WML Deck to create a new WML file in GoLive s Editor window e Select File gt Open to open an existing WML file in GoLive s Editor window 2 Select File gt Preview In gt 3300 exe to display it on the SDK Viewing the Content Wireless content appears in the display area of the SDK s main window To bring up the display area at four times the area of the display
23. to be browsed on a mobile phone such as browsable WML and XHTML content e Wireless messages such as MMS multimedia message service and SI SL Service Indictor Service Load Push messages e MIDP MIDIlets Java applets in the form of JAD and JAR files Typically the MIDlets take the form of games or applications that can be downloaded from the Internet and used on a mobile phone Typographical Conventions in This Guide This guide uses the following typographical conventions Convention Explanation Courier Text that you enter as opposed to system prompts and responses e File paths e Commands Italic Program code Names of books and documents New terminology Bold Names of Windows menus commands buttons and icons URL link Active link to a URL Nokia 3300 SDK User s Guide Other Documents About This Product These other documents contain additional information about the Nokia 3300 SDK e Nokia 3300 SDK Release Notes e Nokia 3300 SDK Installation and Configuration Guide You can find these documents in the installation directory of the SDK They are also freely available at www forum nokia com Additional documents about this product and its related technologies may also be available at www forum nokia com 6 Nokia 3300 SDK User s Guide What is the Nokia 3300 Software Developer s Kit The Nokia 3300 Software Developer s Kit Nokia 3300 SDK is a development tool that lets you
24. to close this dialog box In fact you can enter any of the CLI options in this box except new use she11 and qinst See Options for General Use on page 71 6 Select Run Run gt Project The tracing information is shown in JBuilder s Output window For more information about command line interface options see Running the SDK from a Command Line on page 67 64 Nokia 3300 SDK User s Guide Using the Nokia 3300 SDK With Sun One Studio Using the SDK with JBuilder and NDS for J2ME To run the SDK with JBuilder and NDS for J2ME follow these general steps 1 In JBuilder create a new project or open an existing project and then compile the Java files 2 In JBuilder choose Tools gt Nokia Developer s Suite for J2ME gt Create Application Package The NDS Create Application Package dialog box is displayed Enter the necessary information see the NDS for J2ME User s Guide and click Finish You now have a JAD and a JAR file 3 Select the JAD file and choose Tools gt Nokia Developer s Suite for J2ME gt Start Emulators The MIDlet is run on the SDK you ve selected Using the Nokia 3300 SDK With Sun One Studio After you set the Nokia 3300 SDK as the default emulator you can proceed with any operation on Sun One Studio and the operation will use the default device you ve chosen For more information see the Nokia 3300 SDK Installation and Configuration Guide What s Next You can get information abou
25. 3300 and the 3510i SDKs To set up a situation where two SDKs share inboxes and outboxes 1 N M NW Create an SDK instance 3300000 that automatically retrieves message files from box a and saves the sent message files to box_b by typing 3300 exe Xinbox c box a Xoutbox c box_b Create SDK instance 3300001 that automatically retrieves message files from box b and saves the sent message files to box _a by typing 3300 exe Xinbox c box b Xoutbox c box a Create a message and save it to c box a SDK instance 3300000 automatically retrieves the message file from box_a and deletes the file from box a Use the GUI on SDK instance 3300000 to view and forward the message SDK instance 3300001 picks up the message from box b Use the GUI on SDK instance 3300001 to view the message Optionally you can forward it to box_a Conceptually the flow of the message looks like this Use instance Use instance aan a 7 3300001 GUI to a a Create a message view the ge and save it to box _a message c box_a gt If a message cannot be forwarded because it contains a protected format such as MIDI SDK 3300000 posts an announcement stating that it cannot send the message You can create a batch file to set up this situation The batch file would look something like this echo off 3300 exe Xinbox c box_a Xoutbox c box_b 3300 exe Xoutbox c box_b Xoutb
26. 7 Getting Information About the Content on the SDK The Diagnostics window displays these different categories of information To see See this section Information about requests to and responses from the Internet About the Traffic View on page 38 Information about KVM and JAM status MIDP The source code of the content that is currently loaded in the About the Browser Source SDK browser View on page 43 A history list of the SDK browser About the Browser History View on page 45 Warning messages About the Log View on page 46 About the Traffic View The Traffic view displays events that occur between the SDK and an external entity such as a gateway simulator or the Internet To trace network events that occur in the KVM see Setting MIDP Tracing and Speed Options on page 21 The events are triggered as the content on the SDK changes This event Is triggered by HTTP requests The browser sends or receives an HTTP request HTTP responses e A MIDlet sends or receives an HTTP request using the HTTP Connection interface TCP stream data sending e A MIDlet sends or receives data through a socket TCP stream data receiving connection schema e A MIDlet sends or receives an HTTP request through an http connection schema when the SDK is configured to use the HTTP stack instead of WAP UDP datagram sending The browser sends an HTTP request e A MIDlet sends an HTTP request through the
27. AD file However you can simulate the provisioning of a MIDlet by starting the SDK from the command line with the xprovisioning option and with a MIDlet file residing on a local drive as described here For more information about the command line interface see Running the SDK from a Command Line on page 67 To provision a MIDlet using a local file and the CLI 1 From the command line enter a command like this one emulator exe Xprovisioning mylocalmidlet jad 2 The SDK starts and displays the information in the JAD file about the MIDlet 3 Based on the information in the JAD file the Java Application Manager JAM on the SDK determines whether the SDK can run the MIDlet If it can you can elect to load the JAR file of the MIDlet which contains the actual application The SDK provides you with an opportunity to save it 62 Nokia 3300 SDK User s Guide Setting Up the SDK To Run MIDlets About JAD and JAR Validations for Provisioned MIDlets When MIDlets are provisioned the SDK checks validates the JAD JAR and JAR manifest files When you provision a JAD file the JAR and JAR manifest files associated with it are validated When you provision a JAR file only the JAR manifest file is validated The checks occur in a specific order and the SDK stops performing the checks when the first check fails after which the SDK displays a warning and discards the JAD or JAR file The SDK checks that The JarSize attribute is
28. G file jJpg image jpeg JPEG files Jpeg wbmp image vnd wap wbmp WBMP file mid audio midi MIDI sound files midi nrt application vnd nokia ringing tone Nokia Ring Tone files ott rng jad text vnd sun j2me app descriptor MIDP Java JAD file jar application java archive MIDP Java JAR file wmlsc application vnd wap wmlsc Compiled WMLScript vcs text x vCalendar Calendar file vcf text x vCard Card file bmp image bmp Image file What Content Types Can You Load Directly Using the Browser You can load the content types listed in this section by e Making an HTTP request directly through File gt Open For example http www ayg com e Referencing the content type from within WML HTML or XHTML code to provide a link to another item such as a new web page or image also known as an absolute reference For example lt a href http www nokia com Click me wbmp gt Click me lt a gt These content types are e text vnd wap wml e text html e application xhtmlt xml e text x vCard e text x vCalendar e text x co desc e image gif image jpeg image png e image vnd wap wbmp e image bmp 30 Nokia 3300 SDK User s Guide Working With Content Types e image vnd nok wallpaper e application vnd nokia ringing tone e audio mid e audio midi e audio x mid e audio x midi e audio sp midi e audio amr wb e text vnd sun j2me app descriptor e application java e application java arch
29. HDRAW 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 Content About This Users GUUS oiisiicsisaweccitsecs annenin teannta da aaen aei msde vale cts haan a lasie vaste dihstdaiieideooi 5 Who Should Read This Guide moniin dys eee lea cero EEEE A A EAA E VEE 5 Typographical Conventions in This Guide ccccessssceceessesececeeceseeseceececesnsececescesesaeaeeeecnseseneeeeens 5 Other Documents About This Product eiss noiera aeoe RA E E RE E 6 1 What is the Nokia 3300 Software Developer s Kit cccccccceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeneeeneeens 7 Quick Tour of the Nokia 3300 SDK ssssssssssesssesseesssssesessssseeesessseseressssssreeeessseereesssesreesesssesesesssesreese 8 Getting Information About the Content on the SDK s sssssssssseseesssesreessssseeesesssesreersssssrereesssesreeseses 10 About the Diagnostic Window cccccccsssscececssessnecececesesnececesensesaececeecssnsanseeeeceseseececesensensaaeeeeess 10 Aboutthe Aracing Options deiTe a E a R ea A e A E cae 11 Setting Up the Nokia 3300 SDKerissrisi ei oeir en EE TE RE EEE EN O EE T REE 11 Starting the Nokia 3300 SDK Within an IDE s sssssssesssssssssssesssssereresssssereessssereeessssesreesessseresessseseeess 12 Getting Information About t
30. Information About the CLI Options sssessessssssssesssesesesessseseeessseseresesssrresessseeeressseereese 70 Options for Managing SDK Instances ccccssesssececeesensececeeceseacececessnsseseceeeeseseececeeeeseaeeeesensees 70 Options f r General Use veics cites ien E EEE E RE E N R 71 Options for Tracing Java OUMU ana a a E TE TE dicate A T avs 72 Options for General Management of Java Output cccsesccccessessnseeceeeeeseeceececesenaeecesensenseeeeeeesens 72 Abo t Parameters ooien a A A O T eden meen a eee aa 74 Working With a CLI Shell to Repeatedly Send Commands ceccesscseceecesenseececensenseeeeseessnssneeeeens 75 Using Inboxes and Outboxes With MMS Messages sssccecessessesececeecesenseaeeseceseseseeeeesensenseaeeeeess 75 Nokia 3300 SDK User s Guide 3 Nokia 3300 SDK User s Guide About This User s Guide This manual describes how to use the Nokia 3300 Software Developer s Kit Nokia 3300 SDK Nokia 3300 SDK is a development tool that lets you preview how wireless content will look and work when it is ultimately deployed to an actual Nokia 3300 mobile handset You can also use the Nokia 3300 SDK to develop content for other Nokia handsets with characteristics and functionality that are similar to those of the Nokia 3300 handset Series 40 Who Should Read This Guide You should read this guide if you plan to use the Nokia 3300 SDK in the process of creating e Web content designed
31. MS emulation 20 Nokia 3300 SDK User s Guide Setting Up Preferences Setting MIDP Tracing and Speed Options Select Tools gt Settings and click MIDP Monitor to set options that let you trace the performance of a MIDlet and control the speed at which it runs The MIDP Monitoring tab looks like this General Networking MIDP MIDP Monitor m Tracing I Memory allocatior 4 STS St Gute ats of output J Enable KVM speed control Average byte Je instru yecutior e in microsecond I Enable MIDlet canvas speed control t delay imn econd Canvas paint delay Selecting Tracing Options Check the tracing options you want to display in the SDK s DOS Console These tracing options trace events that occur in the KVM To view events that occur between the SDK and an external entity such as a gateway simulator or Internet see About the Traffic View on page 38 To use tracing options within an IDE you must set the tracing options within the IDE These tracing options are the same tracing options in the command line interface For more information see Options for Tracing Java Output on page 72 About MIDlet Speed Controls When you run a MIDlet on a fast computer you might not get an accurate demonstration of how the MIDIlet s runs on a handset because the simulation runs faster on the computer than it does on the handset MIDlet speed controls KVM and Canvas speed let you slow down the per
32. P MIDP Monitor r Appearance Small 1x 128x128 pixels C Large 2x 256256 pixels J SDK always on top Language English zi M Cache downloaded content IV Play phone sounds Cancel pi Nokia 3300 SDK User s Guide 11 What is the Nokia 3300 Software Developer s Kit Starting the Nokia 3300 SDK Within an IDE While you can use the SDK as a standalone application you can also use it within an integrated development environment IDE to create a powerful development and testing environment These are some of the IDEs that support the Nokia 3300 SDK Browser IDEs Messaging IDEs MIDP Development IDEs Nokia Mobile Nokia Mobile Internet Toolkit Nokia Developer s Suite for JEME Internet Toolkit Adobe GoLive Nokia Developer s Suite for MMS Borland JBuilder Adobe GoLive Sun J2ME Wireless Toolkit Sun One Studio You might need to configure your IDE to recognize the SDK as a supported device before you can launch the SDK from within the IDE interface For information about configuring IDEs to work with the SDK see the Nokia 3300 SDK Installation and Configuration Guide in the SDK s installation directory Getting Information About the SDK You can get information about the SDK from the Help menu For information about Select Late breaking news Help gt Release Notes Installing and Configuring the SDK Help gt Installation and Configuration Guide Using the SDK Help gt User Guide This versio
33. P transient lt URL JAD_filename gt specified MIDlet from the hard drive using Use with emulator exe only the MIDlet provisioned method instead of the unprovisioned method Xprotocol lt networking protocol gt Specifies whether to use WAP or HTTP MIDP networking protocol for MIDIlets Xquery Print information about the SDK This MIDP Use with emulator exe only option is not valid when used with the Xjam option Xrunjdwp address lt port gt Specifies the TCP IP port number between MIDP Use with emulator exe only the emulator KVM and the debug proxy Xrunjdwp lt dt_socket gt Specifies the transport mechanism used to MIDP Use with emulator exe only communicate with the debugger Only dt_ socket is supported Xrunjdwp server lt port gt Starts the debug agent as a server The MIDP Use with emulator exe only debugger connects to the port specified in lt port gt Xrunjdwp suspend lt y gt Suspends the VM immediately after MIDP Use with emulator exe only establishing a connection to the debugger Only the value Y is supported Nokia 3300 SDK User s Guide 73 Running the SDK from a Command Line About Parameters The following table lists the parameters you can use on the command line when you use 3300 exe Command Line Description Parameters Values Options load lt value gt Specifies a filename or a URL string to be loaded MMS filename Use with into an SDK instance For
34. P gt Nokia 3300 SDK User s Guide 71 Running the SDK from a Command Line Options for Tracing Java Output Trace output is displayed within the output window of an IDE or within the SDK DOS Console when you run the SDK as a standalone application These tracing options apply only to Java output Option Prints Use for Xverbose allocation Memory allocation trace MIDP Xverbose gc Garbage collection trace MIDP Xverbose gcverbos Verbose garbage collection trace MIDP Xverbose threading All threads in the system MIDP Xverbose classverbose Verbose class loading trace MIDP Xverbose verifier Verifier trace MIDP Xverbose stackmaps Stackmap trace MIDP Xverbose bytecodes Byte code trace MIDP Xverbose method Method trace call MIDP Xverbose methodcallsverbose Verbose method call trace MIDP Xverbose stackchunks Stackchunk trace MIDP Xverbose frames Frame trace MIDP Xverbose exceptions Exception trace MIDP Xverbose events Event trace MIDP Xverbose monitors Monitor trace MIDP Xverbose networking Networking trace MIDP Xverbose Enable all Java traces MIDP Xverbose all Options for General Management of Java Output You can use the options in this section to do general work with MIDIlets Option Description Use for classpath lt directory gt Use with 3300 exe only Specifies the directories and JAR files to be MIDP searched for classes th
35. age gt Select gt Graphics folder and then select the graphic you want e Select Options gt Insert Image gt Select gt Tones folder and then select the sound you want 4 Select Open 5 Select one of the following Send to Number and enter a telephone number e Send to Email and enter an email address 6 Select OK to send the message to the outbox folder Creating and Previewing an MMS Message Using NMIT 4 0 Creating a new MMS message within NMIT is a two stage process 1 In NMIT create the MMS message with the MMS Set Up Wizard Select File gt New gt Messaging gt MMS Message to open the MMS Setup Wizard Within the wizard specify the recipients of the message the media files to be included in the message and whether to include or create a SMIL file The wizard supplies required headers with default header values which you can change in Step 2 Click Finish in the Wizard 2 In NMIT edit the MMS message header When you click Finish in the wizard NMIT opens the MMS Message Multipart editor where you can edit the values of the headers both for the entire MMS message and for the individual parts You can also add optional headers To preview an MMS message on the SDK with NMIT 4 0 1 Select Tools gt SDK Control Panel to display phone SDKs that NMIT has detected 2 To start a phone SDK click the Start icon next to its name Go lt Type url here gt Bookmarks Click the Start icon to launch an instance of Nokia 3300
36. and Norwegian You can download other languages from www forum nokia com For more information about languages see the Nokia 3300 SDK Installation and Configuration Guide 16 Nokia 3300 SDK User s Guide Setting Up Preferences Activating the Content Cache The Nokia 3300 handset has a cache that stores downloaded Internet content This feature improves browser performance Checking Cache downloaded content enables the cache in the SDK which causes the SDK to behave like the actual handset Unlike the handset the SDK also provides you the option to disable this cache Uncheck the box if you prefer to fetch a fresh copy of content over the Internet each time you browse to a location Unchecking Cache downloaded content lets you observe any changes you made to the content on an Internet Web server and disables all cache directives from downloads Sending Sounds to a Sound Card Check Play phone sounds to direct the SDK to send supported sound content to the computer s sound card When you don t check this box you won t hear any sound from the SDK Setting Up Network Access Both the Nokia 3300 SDK and the Nokia 3300 handset e Use a WAP gateway that is you must have a WAP gateway or gateway simulator for the SDK to communicate with the Internet e Support MIDlets that use HTTP protocol through a WAP gateway Unlike the handset the SDK also lets you run MIDIlets through a direct HTTP connection When you use this opt
37. bility to run the JAR file A JAD file can contain information such as MIDlet Name Bounce MIDlet Vendor Nokia MIDlet Version 1 0 1 MIDlet Jar Size 25978 MIDlet Jar URL http domain directory Bounce jar Nokia MIDlet Category Game MIDlet 1 MIDletName MIDletIcon MIDletMainClassName e JAR Java ARchive file which contains the actual preverified MIDlet A JAR file contains the class image and sound files gathered into a single file and compressed for faster downloading to your SDK or handset e A JAR manifest file manifest mf that contains information similar to the information in the JAD file The JAR manifest file is located within the JAR file and is available only after you ve downloaded the JAR file For more information about MIDP MIDIets see e Mobile Information Device Profile JSR 32 1 0 freely available from www forum nokia e Connected Limited Device Configuration JSR 30 1 0 4 freely available from Www java sun com About Loading MIDlets With and Without Provisioning You can load a MIDlet on the Nokia 3300 SDK e Without provisioning that is by opening a MIDlet from a local hard drive to the SDK e With provisioning that is by downloading a MIDlet from the Internet with the SDK before running it on the SDK with the browser Running a MIDlet without provisioning provides a faster less restrictive environment in which to test MIDlets during early development Provisioning a
38. cssesenecesensesseaeeeees 19 Setting the KVM HeapsiZessisscriesiin oerien endosi s AE A E AaS eE iA 20 Enable Persistent Record Store Emulation cccsscccessessssececeecesesseececesseesececeeescnseeeeeessnsenaees 20 Setting MIDP Tracing and Speed Options ssessesssesssesssssesesssssereresssssereesssesreeessssrereesssesresesssrees 21 Sel cting Tracing Option Serita de niet E A E A A ea 21 About MIDlet Speed Controls nessnesiisiiniiiiieiinrii oaa E EE E E 21 S tting MIDlet Canvas Specdessrrne orei aE E o e A E E E A E 22 Setting MIDlet KVM Speed airsoii a AE e aea o aS EN eA EEE SO EEE ERER 22 Changing Instance Numbering and Access to Diagnostics sesesssesseesesssreeeesssesreesssesreesesssereeessseee 22 Wihrat S IN amp 6 ici cassascsdcsadiannihucd aleea EEEE oa ee aa a OA ae ean 23 3 Using the Nokia 3300 SDK icviceleveisevsscesescaveenedecvicuvencansisadeavecessadncuteucadssvestavenwaansriginvektanbieeteans 25 About Loading Content on the SDK ccccccccecssssnsececeecesensnceececssesenseecessnssnececeeenseaaaeeeeessnsnneaeees 25 Opening Content on the SDK Standalone Application ccccecesssccecesseesnteceeceeesenececesensensneeesensees 26 Nokia 3300 SDK User s Guide 1 Loading Content With File gt Open cccsscccccessessecceceessesenececessessnseceecesesesaeececenseeseaeceeesseseeeeeens 26 Loading Content Using the SDK Menus ceceessscceeeesesenseecessesseaececesensenaeecesenseeseaeceeense
39. d after frog txt 5 Click the left soft key to select Options and display the options for managing the message Reply reply to the sender of the message e Forward to no forward message to the phone number you specify e Forward to email forward message to an email you specify The SDK does not permit a genuine forward e Message Details display information about the message e Play play the message Save image save the image in the message Delete message delete the MMS message Working with Push Messages I Multimedia message received 0 Show Exit Frog Iam a jumping frog Options Exit Frog Options Stop Frogs H Delete message Reply Forward to no Forward to e mail Message details Select Back An SI service indicator message is a text message sent to a phone to notify the user that a service or resource is available The message contains a URL that identifies the resource The SDK displays this text notification and the user can choose to access the resource or to delete the notification An SL service load message automatically loads a URL on the user s phone Because the main content of a Push message is the URL the handset offers no Save option for Push messages SI Push messages stay in the Service Inbox until you delete them You cannot save the same Push message again until you delete the first one 54 Nokia 3300 SDK User s Guide
40. e gt lt layout gt lt root layout width 320 height 240 title My SMIL message gt lt region id Image width 100 height 60 left 112 top 32 gt lt region id Text width 125 height 32 left 96 top 128 gt lt layout gt lt head gt lt body gt lt par du 5s gt lt img src frog gif region Image gt lt text src frog txt region Text gt lt par gt lt body gt lt smil gt Nokia 3300 SDK User s Guide Creating and Previewing an MMS Message Using NMIT 4 0 2 In Adobe GoLive select Nokia Tools gt Create Send MMS Messages NDS for MMS starts Nokia Developer s Suite for MMS O x File Utilities Help NDS for MMS Create MMS Message SMIL File Name frog smil Message Headers From E Use this area to create Ce an MMS message from guaet a SMIL file Loreate Send MMS Message MMS File Name 4 Message Recipients ay Phone SDKs MMSC EAIF Emulator List of phone SDKs installed Send Phone SDKs StarvClose i Nokia 3300 Start New on the computer Series 60 CA SDK Start New Message Headers Message Content lt Information about the MMS message Message Size System Messages omen to SDKs 3 In NDS for MMS fill in the To and From fields and click Create 4 In NDS for MMS select the SDK to which you will deploy the message 5 In NDS for MMS click Send The SDK displays a note that a messag
41. e classpath may include both library and application class directories and JAR packages Xdescriptor lt JAD file gt Runs an application using the specified MIDP Use with emulator exe only JAD file Xdebug Specifies that the MIDlet be run in MIDP Use with emulator exe only debugging mode 72 Nokia 3300 SDK User s Guide About Options Option Description Use for Xdevice lt device name gt Runan application on the SDK specified by MIDP Use with emulator exe only the device name Xheapsize lt heapsize gt Specifies the heapsize in bytes available MIDP for MIDlets The value may be specified in kilobytes by appending a k to the number or in mega bytes by appending an M to the number The valid value range is 0 to 1048576 1 MB If the specified value is not in the valid range that is more than 1048576 bytes the heapsize is set to the default value Default value 211088 bytes 212 KB Xhttp_proxy Specifies the address and port number of MIDP lt proxy address or port number gt the HTTP proxy the HTTP protocol will use when making network requests Specify the value in the format address port_number For example 113 14 176 11 8080 or proxy domain 8080 If the port number is not specified the port 8080 is used This option takes effect only when used with Xprotocol lt networking protocol gt Xjam Specifies that the SDK is to load the MID
42. e has arrived If the SDK s browser is active the MMS message announcement is not displayed and you must use the phone menus to exit from the browser to see the announcement You know you have exited from the browser when you see Menu and Names on the display Processing an MMS Message on the SDK This example shows you how to receive view and dispose of an MMS message in the SDK The MMS message in this example consists of two media parts a TXT file anda GIF image The message also contains a SMIL file that coordinates the timing of the TXT and GIF files however like the Nokia 3300 handset the Nokia 3300 SDK does not use all the information in the SMIL file The SDK displays the TXT and GIF files in the order they appear in the MMS file 1 Make sure you have exited from the browser so you can see the p announcement that is displayed when the SDK receives the MMS message You know you are out of the browser when you see Menu and Names on the display l l T it Menu Contacts Nokia 3300 SDK User s Guide 53 Using the SDK for Message Content Development 2 When the message arrives the SDK displays an announcement 3 Click the left soft key to select Show and to display the first part of the MMS message frog txt 4 Click the down arrow key to display any other components of the MMS message The first component frog txt is redisplayed when you reach the end of the components In this example frog gif is displaye
43. ection for MIDIets Nokia 3300 SDK User s Guide 15 Setting Up the Nokia 3300 SDK e MIDlet provisioning and execution options e MIDlet monitoring such as tracing options KVM and canvas speed controls Establishing General Settings Select Tools gt Settings and click General to set up how the SDK appears and operates This panel appears General Networking MIDP MIDP Monitor Appearance Small 1x 128x128 pixels C Large 2x 256x256 pixels J SDK always on top Language English z IV Cache downloaded content IV Play phone sounds Cancel Setting the Display Size of the SDK Main Window Select the image size you want for the main window of the SDK Both sizes function identically This setting applies only to the SDK s main window The actual canvas size of the canvas remains constant at 128 x 128 pixels You can also elect to display the SDK on top of any other window on the screen by checking SDK always on top Selecting the Language of SDK Menus For localization you can select the language in which the menus in the SDK s browser will be displayed This setting affects only the menus on the SDK Internet documents are displayed in the language in which the document was created You must restart the SDK after changing the language setting for the new setting to take effect These languages are automatically installed when you install the SDK English German Danish Swedish Finnish
44. ed 0 bytes 0 applications 5502 bytes games 0 bytes java SMS 0 byt v Browser Source v i Original Source z lt html gt lt head gt lt meta http equiv content ty body td a p h font family arial sans se Click plus sign to open a view Click negative sign to close a view h font size ZOpx q text decoration none color 0000cc E lt style gt lt script 4 Open view zi function sf document f q focust ff e lt script gt v gt exthtml 2690 bytes ISO 8859 1 Drag to expand the view Browser History Stack size 1 Log View of TCPAUDP Received has been disabled To display only the views you want 1 Open the view you want to see 2 Right click that view Select Views from the menu that appears to open a list of views Uncheck the views you do not want to see 3 The checked views expand to fill the space of the Diagnostic window To recreate some of the examples in this chapter 1 Select Tools gt Diagnostics 2 Select File gt Open 3 Enter http www spruce jp freemidlets in the text field and wait until the web content loads on the browser The Diagnostic window moves with the main window whenever you move the main window but you can move the Diagnostics window independently of the main window Changes you make to the Diagnostics window are persistent between instances Nokia 3300 SDK User s Guide 3
45. eececesesnececesensensececesensesseecesesseeseaecesensnsanaeeeens 54 Creating a Push Message with NMI c csssscccecsseseneceecssesnnscececesseeaeceeeecsseseseesecsnssnseeeeesensaes 55 Processing a Push Message on the SDK ccecesssscececesesseeceecesenseaeeeececesnsaeecesenseseceeesensessneeeseneees 56 Whats INS Ps ace cae n ced e e A En de a sc don con wa maa ca eas ee alan ncaa eee denn eres 57 6 Using the SDK for MIDlet Development ccccccceseeeeneeeeeeeeeeeeseeeeeeeeeeeeeeeneeeeeeeeeeeeeeeeeseeenees 59 About MIDP INIT LS cia ata tes tteianige a rs acadtaee i sega deve a aaa Huu tate oameimeentansas 59 About Loading MIDlets With and Without Provisioning ccccssesccececeesensecececeesenseaeeeeeeenseeeeees 60 Running a MIDlet Without Provisioning ccccccccsessssseececesssesececeecsseeseaeeseesceseaeecesenseeseseeeeesees 61 Provisioning a MIDlet sass cccsestes coxceeces seashadvencecsasdatel E E E T E E A ATE EE 61 Provisioning Using the Networks sirere anae EA N A A a a 62 Provisioning Using Local Files and the Command Line Interface sssssssessssssssssesessesessesesssresssee 62 About JAD and JAR Validations for Provisioned MIDIets ccccccesesseceeeeessenseececesseeseeeeeenees 63 Setting Up the SDK To Run MIDIets c ccccccecsssnseeceeeeseacceeeecsscsesececessesenseececesssneeecesessnsenseeeess 63 Using the Nokia 3300 SDK With JBuilder cccccccccccssessnscececeeeseaeceeeecsseececeeenssns
46. eeeeeecesesseeesenens 63 About the Nokia 3300 SDK Life Cycle in JBuilder cccccceccessssceececesenseeceeeesseneecesenseeseeeeeenees 64 Creating a MIDlet With JBuilder and Running It on the SDK ee eeeeecesseeeeeseeeceesnneecesnneeeeeaes 64 Running a MIDlet and Displaying Trace Information in JBuilder ee eesceeessneeeceeneeeeeeneeeeeees 64 2 Nokia 3300 SDK User s Guide Using the SDK with JBuilder and NDS for J2ME eescsscccccecesesseeceeceseaeeeeeecnsnnececeeenseaeaeesenees 65 Using the Nokia 3300 SDK With Sun One Studio cececesscsceceeseesncececeeseseseececessseseneeeeesseseneeeeens 65 Whats Next nenta rec casa cus ances a ai eaaa te Seine sana alta Westie Rea ga aa as Hades eee dara 65 7 Running the SDK from a Command Line cc cccceeeeeeeee cece eeeeeeeeeeeeeeeeeeeeeneeeeneeeeeeeeeneeseeneees 67 Accessing the Command Line Prompt c ccscecessessnteceeeecesenseecescesensececeeensesaeecesensenseaeceeesenseneeeeens 68 About the Command Line Syntax cccccccccccccccccccccecescseecesseseseseesensneaeseaeeeeeeeeeeeeseseeeeeeseseseeeseeeananea 68 About the Execenta bles sivas stasceys sie ates RE EE EA E EA sad oases A e e E Era 69 Abou utemulat r eRe wiageteca st Miata ta S 8 cand he ashe cn ita ete es ba A hel he teeth aka cl taal 69 About 3300 EX Cr caskap tances esac ceies piviuda why wlsaaan esuhaoscabanesniaand a SEANA EEA AES EAEE ee aN 69 AD Out Options esa neoe ann a i a r a widen t s e 69 Getting
47. es on a short message connection When the Traffic view is closed this summary is displayed e Number of HTTP requests and responses both WAP and HTTP e Number of bytes sent and received on the TCP layer e Number of bytes sent and received on the UDP layer e Number of SMS fragments PDUs sent and received Traffic HTTP 2 2 UDP 1878 2942 73 3300000 Diagnostics Nokia 3300 SDK 38 image gif ISO 8859 1 8558 bytes MIDP RAM Used 0 bytes 0 Browser Source http Awww google com text html 2690 bytes Browser History Stack size 1 Log Summary of transactions applications 0 bytes games 0 bytes java SMS 0 bytes Warning Filter for TCP UDP Received is turned off Nokia 3300 SDK User s Guide 39 Getting Information About the Content on the SDK When you open the Traffic view you see the list of transactions that have occurred and that occur while the browser is active zrg 3300000 Diagnostics Nokia 3300 SDK E4 Traffic i Click to clear the Traffic display 3 Cached Response 691 bytes text html ISO 8859 4 Request http w google com 3 Response 2690 bytes text html IS0 8859 1 4 Request http www google com images logo 38 Response 8558 bytes image gif IS0 8859 1 v _ Click Filter to select the categories of transactions you want to display in the traffic view
48. esesaeeeeeeessesaueceseesesaeeeeeeesseseneeeeess 36 Abouithe CALC Vey ins sach src etre oasctan ey Dette ea oar ya leet ae a a E aa Ee E A AE 38 About MIDP View costiere cece esa bec cc Do gages avd gales calc daa cadences ese gee taco a EER 41 About KVM Heapsize Statusi ieni a a ea Eaa oaa aanas aiia aas 42 About JAM Storage Statusycccsite ciccccssstecseccstovesscvidecescistvalstecdsousatciceodss i a a a 42 About the Browser SOUL ce VieWccrsieniiiiaeiesinssi aiaa anata a aaa iae 43 About the Browser History View ccccesssscececeeessnecececessseececeecesesaeseceecsseeeaeeeeceseseececesensenseaeeeeens 45 Abou tthe Log ViEwna nirearen E EEE a E EE AE EE E AREE E 46 What s Next n case ezsincl irsana ieee enaa a aa dena pace ESEN Ep ELA aae EEEO EAE EE E sanded EEEa 47 5 Using the SDK for Message Content Development cceseeeeeeeeeeeeeeeeeeeeneeeeeeeeeeeeeeeneeees 49 About MMS M ssages sii ccchees sosire oE E E R AE led R E E E ves at 50 Creating an MMS Message Directly on the SDK sssssssssssssssesesssesesessssseresesssrreresssseeresssssreeeesssseee 50 Creating and Previewing an MMS Message Using NMIT 4 0 c cccccssessrseeceeeessseceeeeeeseneeeeeeensees S1 Creating and Sending an MMS Message With Adobe GoLive and NDS for MMS sseceeeeeees 52 Processing an MMS Message on the SDK c cccccceessesceceeeeeeseeseeceeecesaeecesensenaeceeesensnsueeeesenees 53 Working with Push Messages cccssccccccsssssenececessensna
49. example WML filename are CXe e To load a local WML file e URL string only 3300 exe load C welcome wml i JAD filename To load a remote WML file fl 3300 exe load http server domain e JAR filename welcome wml You can imply the load parameter when you are not working within a shell see Working With a CLI Shell to Repeatedly Send Commands on page 75 3300 exe http server domain welcome wml close The close parameter works in two ways depending exit Closes one of the Use with whether you are within a shell or outside a shell see following 3300 exe Working With a CLI Shell to Repeatedly Send Win a shell che only Commands on page 75 SDR instance in e When you use close within a shell close terminates the shell To also terminate the instance you must use close with exit The parameter close terminates the shell and the option exit terminates the instance associated with the shell e When you use close outside a shell the parameter does nothing unless you use it with either exit to terminate the highest numbered SDK instance or the instance you specify with use or exitall to terminate all open SDK instances Unlike other options exit and exitall work only with the close parameter and when used must immediately follow the parameter the shell Outside a shell the SDK instance you specify with use or the SDK instance with the highest number exitall Used only with the close parameter
50. formance of a MIDlet on a computer to better reflect the MIDlet s performance on a handset Developing a MIDlet in an environment with a slower KVM or canvas delay speed can help you monitor and optimize your code However turning on the canvas speed and KVM speed simultaneously can adversely affect the data you collect because canvas speed and KVM speed both control the speed of the SDK executable in ways that can conflict For example let s say you are testing a MIDlet game with an intricate graphical display that requires frequent updating and you slow down the canvas speed to better simulate the graphical display on a handset Simultaneously slowing down the KVM speed will additionally slow down the canvas Nokia 3300 SDK User s Guide 21 Setting Up the Nokia 3300 SDK speed so the performance of the MIDlet will be distorted and the data you get will be inaccurate For more accurate results enable only one performance feature at a time either the canvas speed or the KVM speed Setting MIDlet Canvas Speed Use the MIDlet speed delay slider to slow down a MIDlet that displays too rapidly on a fast computer This setting is recommended for a MIDlet with an active graphical display that requires frequent updating for example a game Move the slider to the right to increase the delay in milliseconds of the canvas paint function Because the maximum delay you can set is 100 milliseconds this setting has no visible effect u
51. ge system is automatically permitted and Message Sent is not displayed on the SDK display area Default value of the SDK Ask every time You re asked to approve message access each time you send a message Default value in the handset when MIDP 1 0 applications are provisioned Not allowed Sending messages is not allowed Setting the KVM Heapsize The size of the KVM memory heap heapsize controls how much memory the MIDlet can take to run You can simulate the memory constraints of different devices Let s say you are working on a handset that is capable of loading MIDlets up to a maximum size of 320K If you have a MIDlet that exceeds 320K you may want to adjust the heapsize on the SDK to verify that the MIDlet can run in a tight memory space Set a new value for the KVM heapsize by checking Set KVM heapsize and specifying a new value in kilobytes by appending a k to the number or in mega bytes by appending an M to the number The new KVM heapsize takes effect the first time you run a MIDlet after you set the heapsize See the xheapsize option on Options for General Use on page 71 Enable Persistent Record Store Emulation Enable persistent records by checking Enable persistent record store emulation A persistent record is a file a MIDlet can create that remains even after you turn off the SDK For example a persistent record from a MIDlet might contain scores from the last time you played a game Default value is enabled R
52. he browser and the browser history records the URL without deleting the Yahoo listing About the Log View The Log view displays messages that the SDK generates such as warnings about unsupported content types and file sizes that exceed what the SDK can handle The Log will also tell you whether the TCP UDP filters in the Traffic view are turned off 46 Nokia 3300 SDK User s Guide What s Next When the Log view is closed it looks like this 375 3300000 Diagnostics Nokia 3300 SDK Traffic HTTP 2 2 UDP 1878 2942 38 image gif ISO 8859 1 8558 bytes MIDP RAM Used 0 bytes 0 applications 0 bytes games 0 bytes java SMS 0 bytes Browser Source http awy google com text html 2690 bytes Browser History Stack size 1 Log Last message reported Warning Fitter for TCP UDP Received is turned off lt _________in the log When you open the Log view you see any messages that the SDK generated 74 3300000 Diagnostics Nokia 3300 SDK Traffic HTTP 2 2 UDP 1882 1146 3 image nd wap whmp ISO 8859 1 144 bytes MIDP RAM Used 0 bytes 0 applications 0 bytes games 0 bytes java SMS 0 bytes Browser Source http wap yahoo com applicationvnd wap wnnilc 746 bytes Browser History Stack size 1 Log Warning Traffic View Listing of TCP UDP Sent traffic is set to off see Fitters Warning Traffic View Listi
53. he SDK cccccscccecesssnseceeeecesenseececessensececeecnsesaaeeesessenseaeceeessnseeaeesens 12 Exiting Nokia 3300 SDK seis na aie ial E A A E E E A E E aa AEE 12 Whats Next ois ct teh nan ra eeo aae aTa a ee E E OEA EE ARa Aian t 12 2 Setting Up the Nokia 3300 SDK i siccsnisencicsantesabacentawesanstannchaced ievetenenenntsascicentieeddeuantendiaartanseas 15 Setting Up Preferetices scciie siveattesessticestabediuscavedvebeuets EE E E RE A E 15 Establishing General Settings iriennerien rae E E a E E E wove a EEES 16 Setting the Display Size of the SDK Main WindoW ssssssssssssesesssssereesssssseresssssereessssreeessssseee 16 Selecting the Language of SDK MEUS ninae R a E E R 16 Activating the Content Cacheriresinii ennonn a E R a a a E 17 Sending Sounds toa Sound Carda d ae ede RE E A Vata T 17 Setting Up Network ACCESS asne nnn a a aea a aa a E A S a i eai 17 Setting Upa WAP Gatewa yeiio nenie e E E five heeded E E ek 18 Setting Up Direct HTTP for MIDlets ssssseeesssssseseesssesreesesesreesesssesreesssssreesessseseresssssreeeessseeee 18 Setting MIDP Provisioning and Execution Options ccccescccceeeesenseceeceesensececeeesseseeseceeeeseseeeeees 19 Setting the Provisioning M d ssinnianis e e EE E E N EE ES 19 Setting MIDlet Execution Options cccccccccssessnseececsseseneceececeseseececeseseeeceecnseaaecesesseseeeeeess 19 Changing the MIDlet Security Policy cccccssssccecesssesncceceeeceseneececenseeaeeeeee
54. ide What s Next What s Next You can get information about the content on the Nokia 3300 SDK See Getting Information About the Content on the SDK on page 35 Or you might want to explore running the SDK from a command line See Running the SDK from a Command Line on page 67 Nokia 3300 SDK User s Guide 57 Using the SDK for Message Content Development 58 Nokia 3300 SDK User s Guide Using the SDK for MIDlet Development The Nokia 3300 SDK replicates the appearance and function of MIDlets as they are run on the handset by using the same Java virtual machine and support classes that the Nokia 3300 handset uses The Nokia 3300 SDK uses a J2ME environment that supports CLDC 1 0 MIDP 1 0 and the Nokia UI API About MIDP MIDlets A MIDlet is a Java application that conforms to the Mobile Information Device Profile MIDP specification MIDP applications are portable across cell phones and can handle differences in screen size and button layout as well as the low memory and small footprint of a cell phone Typically a MIDlet is a game or application that can be downloaded from the Internet and used on a mobile phone A MIDlet can be made up of Nokia 3300 SDK User s Guide 59 Using the SDK for MIDlet Development e JAD Java Application Descriptor file which describes the attributes of the JAR file One function of the JAD file is to let an SKD or device determine whether it has the capa
55. in the main SDK window which is 128 by 128 The Canvas is 512 by 512 To display the Canvas select Tools gt Canvas The Canvas window appears tance Identifier Menu Messages Select Exit Click the left mouse button to select the left choice in this A X example Select and the right mouse button to select the right choice in this example Exit In the Canvas you also select clicking the left mouse button to select the left choice and the right mouse button to select the right choice Type text directly into fields e Scroll with the mouse scroll key Nokia 3300 SDK User s Guide 27 Using the Nokia 3300 SDK The display in the Canvas and the phone image are synchronized Despite the appearance of the main and Canvas windows on the desktop the actual size of the canvas remains constant at 128 x 128 pixels Inputting Text and Commands From a Keyboard In addition to clicking on the SDK GUI you can use the computer keyboard to activate the SDK s soft keys and to enter information into the SDK Emulating Mouse Clicks With Keyboard Shortcuts Here s a list of each keyboard key or key combination that performs an action on the SDK equivalent to clicking on the SDK GUI SDK Soft Key Computer Keyboard Equivalent Left soft key F9 Fil Enter Right soft key F12 Backspace Cursor Up Up arrow Cursor Down Down arrow Cursor Left Left arrow Cursor
56. instance 32 Nokia 3300 SDK User s Guide What s Next The benefit of changing the MMC directory on the PC hard drive is that you can transfer a custom directory structure to the handset if you have an MMC card reader on our computer What s Next Now that you ve loaded and viewed content on the Nokia 3300 SDK you can get information about that content in Getting Information About the Content on the SDK on page 35 Or you can begin to develop e MMS and Push messages See Using the SDK for Message Content Development on page 49 e MlDlets See Using the SDK for MIDlet Development on page 59 You might also want to explore running the SDK as a standalone application from a command line See Running the SDK from a Command Line on page 67 Nokia 3300 SDK User s Guide 33 Using the Nokia 3300 SDK 34 Nokia 3300 SDK User s Guide Getting Information About the Content on the SDK To help you analyze and troubleshoot the content on the SDK you can view information about the current content on the SDK in the Diagnostic window The information in this window is dynamic and changes as the content on the SDK changes Nokia 3300 SDK User s Guide 35 Getting Information About the Content on the SDK Working with the Diagnostic Window The Diagnostics window displays information that can help you determine whether the content on the SDK is working properly To see the Diagnostics windo
57. ion you do not need a WAP gateway or gateway simulator Using direct HTTP can facilitate the development of a MIDlet during the early stages However the communications using direct HTTP is different from communications using a WAP gateway so you should do your final testing through a WAP gateway Nokia 3300 SDK User s Guide 17 Setting Up the Nokia 3300 SDK To set up network access for the SDK select Tools gt Settings and click Networking in the Setting dialog box The Networking tab looks like this General Networking MIDP MIDP Monitor WAP networking 4 Set up the WAP gateway the SDK uses to communicate with the Internet Connection mode Connectionless mode port 9200 C Connection oriented mode port 9201 C Secure connectionless mode port 9202 C Secure connection oriented mode port 9203 IV Replace WAP with HTTP for MlDlets HTTP proxy server i Yi MIDI h IV Use an HTTP proxy server o A paa Address 17224168190 Port eon HTTP protocol with direct HTTP when you specify this information Reset to default Cancel Setting Up a WAP Gateway The SDK like the handset uses a WAP gateway for Internet connections Under WAP Networking enter the WAP gateway IP address and select a connection mode This information is available from your system administrator Setting Up Direct HTTP for MIDlets To run MIDlets with direct HTTP that is without requiring a WAP gateway check
58. ive e application x java archive e application vnd wap sic e application vnd wap slc e application x wap prov browser bookmarks e application x wap prov browser settings e application x nokiagamedata e image vnd nok oplogo color WMLScript can be referenced with href only within a WML HTML or XHTML content The browser cannot directly open WMLScript e image vnd wap wbmp e application vnd wap wmlsc In line content types within WML HTML and XHTML code are displayed as a subcomponent of a page Generally all content types can be referenced but only images can be displayed in line Some exceptions apply however For example wallpaper image vnd nok wallpaper cannot be displayed in line but cannot be referenced and a snapshot image vnd nok camera snap can be referenced but cannot be displayed in line An example of an in line format is lt img src foo gif alt Image Text gt The content types you can use in line are e image gif image jpeg image jpg image png image vnd wap wbmp e image bmp Nokia 3300 SDK User s Guide 31 Using the Nokia 3300 SDK What Content Types Can You Reference in a COD Object A COD content download object is a Nokia proprietary file format generated by DRM digital rights management A URL that you load on the SDK browser can reference a COD object that contains these content types e text x vCard e text x vCalendar e image gif image jpeg image png
59. n SDK instance is associated with a JBuilder project The SDK configuration parameters associated with an instance are stored on a per project basis in the JBuilder project file jpx jpr When you choose Run Project or Debug Project a new SDK instance starts and runs the MIDlet using the configuration parameters already stored for that project Creating a MIDlet With JBuilder and Running It on the SDK To create a MIDlet from scratch and then run it on the SDK do this from within JBuilder 1 Choose File gt New Project to create a new project Complete JBuilder s Project Wizard 2 Choose File gt New to create a new MIDlet Select the Micro tab and choose the MIDlet template MIDlet 3 Choose Run Project A new SDK instance starts and runs the MIDlet you ve created No configuration parameters are requested 4 Click Reset to close the SDK instance Running a MIDlet and Displaying Trace Information in JBuilder To enable tracing for the active project without affecting other JBuilder projects do this from within JBuilder 1 Choose Project gt Project Properties 2 Inthe Project Properties dialog box click the Run tab 3 Click Edit to the runtime configuration in the Runtime Configuration Properties dialog box 4 Click the MIDlet tab and select the MIDlet you want from the drop down menu on the MIDlet tab 5 Inthe Emulator parameters field enter one of the command line tracing options such as Xverbose method Click OK
60. n of the SDK Help gt About Exiting Nokia 3300 SDK Select File gt Exit The SDK instance is terminated What s Next If you want to begin using the SDK as a standalone application right now you can e Set up how the SDK operates and looks See Setting Up the Nokia 3300 SDK on page 15 e Begin to load content on the SDK to see how the content looks and works See Using the Nokia 3300 SDK on page 25 12 Nokia 3300 SDK User s Guide What s Next Or you might want to explore running the SDK as a standalone application from a command line See Running the SDK from a Command Line on page 67 Nokia 3300 SDK User s Guide 13 14 Nokia 3300 SDK User s Guide 14 Setting Up the Nokia 3300 SDK You can control some aspects of how the SDK operates and looks by e Making selections in the Preferences window Tools gt Preferences See Setting Up Preferences on page 15 e Editing the text file 3300 user config See Changing Instance Numbering and Access to Diagnostics on page 22 You can also change the default numbering style of SDK instances and turn off the Diagnostics feature Tools gt Diagnostics by editing the text file 3300 user config Setting Up Preferences In the Preferences window Tools gt Preferences you can control e SDK main window size SDK menu language cache use and sound control e Networking settings such as the WAP gateway and whether to use an HTTP conn
61. nding a MIDlet directly to the SDK from an application within an IDE Provisioning a MIDlet Any MIDlet that is downloaded from an HTTP site using the SDK s browser is always provisioned Provisioning a MIDlet lets you test how an enduser experiences downloading a MIDlet from an Internet site and provides MIDlet validation a series of integrity checks that ensure the SDK can run a MIDlet MIDlet validations involves checking the consistency of various attributes in the JAD and JAR manifest files of a MIDlet Using the SDK you can provision a MIDlet in these ways e You can emulate provisioning using files on your local drive by starting the SDK from the command line with the Xprovisioning option For example emulator exe Xprovisioning mylocalmidlet jad See Running the SDK from a Command Line on page 67 e You can use File gt Open to enter the URL of a Web site that hosts a JAD or JAR file e You can post your MIDlet on an Internet server or server simulator and use the SDK s browser to navigate to it by clicking the keys on the SDK e You can select the provisioning mode by selecting Tools gt Settings and clicking the MIDP tab to select the provisioning option For more information see Setting MIDP Provisioning and Execution Options on page 19 Nokia 3300 SDK User s Guide 61 Using the SDK for MIDlet Development Provisioning Using the Network To provision a MIDlet using the network make sure a network connecti
62. ng of TCPUDP Received trattic is set to off see Fitters What s Next Go ahead and begin e Developing MMS and Push messages as described in Using the SDK for Message Content Development on page 49 e Developing MIDIets as described in Using the SDK for MIDlet Development on page 59 Or try running the SDK from a command line See Running the SDK from a Command Line on page 67 Nokia 3300 SDK User s Guide 47 Getting Information About the Content on the SDK 48 Nokia 3300 SDK User s Guide Using the SDK for Message Content Development You can create Multimedia Messaging Services MMS Service Indicator SI and Service Load SL messages on an application and send them to the Nokia 3300 SDK within an integrated development environment When you create an MMS message by using the SDK s phone menus as a user of a Nokia 3300 handset would do the message is not saved to a file because any message you create on the SDK is stored in the SDK s memory and is deleted when you terminate the SDK instance To save an MMS message you must either e Create and save the message in another application before displaying the message on the SDK e Use the Xoutbox option from the command line interface This option makes the SDK send and save the message into a directory you specify See Running the SDK from a Command Line on page 67 Nokia 3300 SDK User s Guide 49 Using the SDK for Message
63. ng the SDK for Message Content Development Processing a Push Message on the SDK This example shows how to process on the SDK the SIC Push message you created in the previous section 1 Make sure you have exited from the browser so you can see the message that is displayed when the SDK receives the Push message You know you are out of the browser when you see Menu and Names on the display 2 When the SDK receives the message the SDK displays an announcement Select Show to display the text part of the message 3 The text of the message appears Howdy Select Options to display ways of processing the message 4 Select one of the following e Retrieve to load the URL in the href into the browser In this example the URL is www ayo com as shown on the right Details to display information about the message Delete to delete the message 5 If you select Retrieve the SDK connects with www ayg com the URL defined within NMIT under href I l it Menu Contacts 7 Show Exi Service nbox t1 Options Back frog E Details Save image Delete message Reply Select Back The Washingto 0 i Lo Re Bu Ep cal al at sin we ate her ess Cancel Some Push messages do not create an announcement because their priority level is not high enough To view the content of such a message you ll have to navigate to the Service Inbox and select the message 56 Nokia 3300 SDK User s Gu
64. ning section of this tab you can e Check Provisioning mode to load MIDlets through JAM e Check Non provisioning mode to run MIDlets immediately and without provisioning Non provisioning is the default value When you select this option you can also set the maximum JAR file size of a MIDlet the SDK can run Setting MIDlet Execution Options In the MIDlet Provisioning section of this tab you can configure the MIDlet execution runtime Changing the MIDlet Security Policy Network security settings override any security settings you set through the SDK menus with Applications gt Games gt Select Application gt lt MIDlet suite name gt gt Web Access Network security settings do not apply to direct HTTP communications Direct HTTP communications is always allowed regardless of the current settings in Network access Set a new security parameters by checking Overrule default MIDP security policy and selecting a new value for Nokia 3300 SDK User s Guide 19 Setting Up the Nokia 3300 SDK e Network access The SDK controls a MIDIlet s access to the internet Allowed The SDK automatically grants network access Default value on the SDK Ask first You re asked to approve network access each time you execute a MIDlet Default value in the handset when MIDP 1 0 applications are provisioned Not allowed Network access is not allowed e Messaging access Controls access to messages Allowed Accessing the messa
65. nless the canvas repaint rate of an object is significantly greater than 10 times per second Setting MIDlet KVM Speed Use this slide setting to regulate the speed of bytecode instructions in the KVM that is the speed at which a MIDlet runs This setting is recommended for a MIDlet whose graphical display does not need to be updated frequently for example an application that calculates a mathematical equation and then displays the result A value of 0 zero indicates this feature is turned off and that the KVM is running at maximum speed The maximum average bytecode instruction execution time is 500 microseconds Changing Instance Numbering and Access to Diagnostics You can change the default numbering style of SDK instances and turn off the Diagnostics feature Tools gt Diagnostics by editing the text file 3300 user properties which is located in lt installation directory gt Nokia 3300 SDK 1 0 bin Disabling the Diagnostics feature makes the SDK start faster The SDK Tools menu does not change when you disable the Diagnostics feature in this file however when you select Tools gt Diagnostics the Diagnostics window will not appear The 3300 user properties file looks like this Nokia 3300 User Configuration File Change 3300000 to another number First device instance ID to change the default instance DeviceFirstInstanceID 3300000 lt numbering scheme Diagnostics DiagnosticsEnabled yes q Change yes
66. not greater than 63 720 bytes The JAD and JAR size are consistent The value in the MIDlet Data Size attribute is not greater than the value specified in the JAD file The attributes defined in MIDlet Name and MIDlet Vendor are the same in the JAD file and the JAR manifest file The MIDlet Version attributes defined in the JAD file and in the JAR manifest file match The MicroEdition Configuration attribute defined in the JAR manifest file is CLDC 1 0 The MicroEdition Profile attribute defined in the JAR manifest file is MIDP 1 0 Setting Up the SDK To Run MiDlets Before you run a MIDlet on the SDK you can set up persistent setting that Control whether MIDlet s are provisioned See Setting MIDP Provisioning and Execution Options on page 19 Provide event tracing and MIDlet speed control See Setting MIDP Tracing and Speed Options on page 21 Control how MIDIlets access the network See Setting Up Network Access on page 17 Let you set the KVM heapsize that controls how large a MIDlet you can store and run See Setting the KVM Heapsize on page 20 Using the Nokia 3300 SDK With JBuilder After you have installed and configured JBuilder you can begin to use the SDK within its environment For more information see the Nokia 3300 SDK Installation and Configuration Guide Nokia 3300 SDK User s Guide 63 Using the SDK for MIDlet Development About the Nokia 3300 SDK Life Cycle in JBuilder In JBuilder a
67. on Description Use for Xlanguage lt language gt Specifies the language that the SDK should use for its Browser menu names MMS MIDP new Creates a new SDK instance Browser Use with 3300 exe Do not use if you are using use in the same command MMS only MIDP use lt instance ID gt Directs a parameter to the existing instance you specify Browser Use with 3300 exe only For example 3300 exe use 3000001 MMS Does not create a new instance Do not use if you are MIDP using new in the same command shell Creates a shell in which you can repeatedly load Browser Use with 3300 exe commands to the SDK instance within the shell See MMS only Working With a CLI Shell to Repeatedly Send MIDP Commands on page 75 qinst Displays the instance IDs of all running instances Use Browser Use with 3300 exe only ainst as the sole option in a command line MMS MIDP Xphonenumber Replaces the number of the instance you specify with Browser lt instance ID gt another you specify Enter only numeric input For MMS example you can rename the instance 3300000 to MIDP 1234567 by entering emulator exe Xphonenumber 1234567 70 Nokia 3300 SDK User s Guide About Options Options for General Use With the exception of version these options take effect only when the result of the command creates a new instance Unless otherwise noted use these options with emulator exe Option Description Use for
68. on is available To configure an HTTP proxy do one of the following e Start the SDK on the command line using the xhttp_ proxy option For example emulator exe Xprovisioning Xhttp proxy 113 14 176 11 8080 mymidlet jad See Running the SDK from a Command Line on page 67 e Start the SDK and select Tools gt Settings gt HTTP Networking Specify the address and port on the HTTP networking tab See Setting Up Network Access on page 17 After configuring the network connection you can provision the MIDlet For example Select File gt Open and enter the URL of a site hosting a MIDlet for example http www spruce jp freemidlets Nokia Tester NokiaTester jad Based on the information in the JAD file the Java Application Manager JAM on the SDK determines whether the SDK can run the MIDlet If it can you can elect to load the JAR file of the MIDlet which contains the actual application and save it under Applications or Games The MIDlet is installed in the Games folder only if the JAD file contains the string Nokia MIDlet Category Games Otherwise by default the MIDlet is installed in the Applications folder The JAM might optionally forward a notification to the Internet server that the MIDlet has been downloaded usually done for the purposes of billing or customer care Provisioning Using Local Files and the Command Line Interface True MIDlet provisioning requires an Internet connection to a URL of a web site that hosts a J
69. options which are generally used for MIDlet development e 3300 exe Runs options and parameters that are not UEI compliant and are usually used in browser content development About emulator exe Typically an IDE that supports MIDlet development automatically uses emulator exe when it uses the SDK as a device A developer of MIDIets is unlikely to use emulator exe on the command line to monitor the behavior of a MIDlet Options that you can use only with emulator exe are noted in the option listing under About Options on page 69 Options and parameters that emulatore exe does not support are ignored IDEs can automatically detect which executable to use About 3300 exe The executable 3300 exe supports options and parameters that you use in message content development If you are developing message or browser content you are more likely to use 3300 exe on the command line because with this executable you can work within a shell see Working With a CLI Shell to Repeatedly Send Commands on page 75 and arrange to have one instance of the SDK send a message to another instance see Using Inboxes and Outboxes With MMS Messages on page 75 Options that you can use only with 3300 exe are noted in the option listing under About Options on page 69 Options and parameters that 3300 exe does not support cause the entire command to fail and an error message to be posted About Options The SDK interprets all text preceded by a dash
70. ox c box_a 76 Nokia 3300 SDK User s Guide NOKIA CONNECTING PEOPLE NOKIA CONNECTING PEOPLE
71. preview how wireless content will look and work when it is ultimately deployed to a Nokia 3300 mobile handset You can also use the Nokia 3300 SDK to develop content for other Nokia handsets with characteristics and functionality that are similar to that of the Nokia 3300 handset series 40 The Nokia 3300 SDK has an WML and XHTML color browser that lets the SDK receive content from web servers through a WAP gateway Such content includes e Web content designed to be browsed on a mobile phone such as MIDP WML and XHTML content e Wireless messages such as MMS multimedia message service and SIC Service Indictor Compiled Push messages e MIDP MIDIlets Java applets in the form of JAD and JAR files Typically the MIDlets take the form of games or applications that can be downloaded from the Internet and used on a mobile phone Nokia 3300 SDK User s Guide 7 What is the Nokia 3300 Software Developer s Kit MIDlet development is supported by these technologies e CLDC 1 0 4 Connected Limited Device Configuration e MIDP 1 0 Mobile Information Device Profile e JSR 120 1 0 Java Specification Request e JSR 135 1 0 Java Specification Request The browser runs on top of a WAP 1 2 1 stack Quick Tour of the Nokia 3300 SDK You can run the SDK e Asa standalone application by selecting Start menu gt Programs gt Nokia Developer Tools gt Terminal SDK gt Nokia 3300 SDK 1 0 gt 3300 SDK 1 0 or by double clicking lt in
72. right in this example Contacts scrolling lt nd call Left and right eee keys for scrolling Left soft key activates function on left in this example Menu Radio key To simulate pressing the buttons on a Nokia 3300 mobile handset click the corresponding keys on the SDK with the mouse The SDK replicates the user interface of the Nokia 3300 phone handset with respect to its key definitions menus selections message display backlight and vibration modes You can also select Tools gt Canvas to bring up the display area of the SDK which displays canvas of the SDK at four times the resolution 512 x 512 a Instance Identifier Messages Select Exit Nokia 3300 SDK User s Guide 9 What is the Nokia 3300 Software Developer s Kit Getting Information About the Content on the SDK You can get information about the content on the SDK by using The Diagnostic window which provides information about how the content of the content behaves e Command fine interface tracing options which can help you debug a MIDP MIDlet About the Diagnostic Window When you select Tools gt Diagnostics the Diagnostics window appears and you can get information about how the content on the SDK behaves The Diagnostic window looks like this 73 3300000 Nokia 3300 SDK Diagnostics Traffic v applications games El Browser Source v ere is no current document
73. seneeeeess 26 Previewing and Browsing With NMIT ccccessssceceeseesceceeeeeesseaeecensensnaececesensesaeeeeeessseseeeeeeeneees 26 Previewing WML Files Within Adobe GoLive ccccessccceceeseesececeecesenaeeeecesnsnseceeesenseseeeeesensees 27 Viewing the Content Tesori era n go atet S E EAA Aa a AE E R eens 27 Inputting Text and Commands From a Keyboard ccccesesssscceecssesecececensesseaeceececnseaneceeessensnaeesees 28 Emulating Mouse Clicks With Keyboard Shortcuts cccccsessececeseseneceececesenseceeeecsseseeeecesensenaees 28 Inputting Text From the Keyboard cccsssscecccssessnececessessnseecececnsnsacececensenaeaeeeecssnsanecesensnssnaeeeees 28 Working With Content Types iesti tapi ean ee a e a E E E eae ERA 29 What Content Types Are Mapped to What File Types in the SDK sssssssssssssesesssssereessssseresessseee 29 What Content Types Can You Load Directly Using the Browser csesscececeessenececesenseeseeeeeess 30 What Content Types Can You Reference in a COD Object ccccsccccceessensececensenseceeeeessnsseeeeess 32 Emulating a Multi Media Memory Card MMC on the SDK c ccccccesesenseececeeesesecececenseeseaeeeeens 32 Whats NC Rt as ease es lets toe cae acu aateee gum niece acing N ol Peau a a E a Mclain te asta 33 4 Getting Information About the Content on the SDK ccecceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeees 35 Working with the Diagnostic Window cccccccessessnscececeseseececese
74. stallation_directory gt bin emulator exe e In an integrated development environment IDE that lets you create content with supporting applications and then immediately test the content with the Nokia 3300 SDK See Using the SDK for Message Content Development on page 49 or Using the SDK for MIDlet Development on page 59 For this quick tour start the SDK as a standalone The appearance of the SDK is faithful to the appearance of the handset although the contrast and color rendering capabilities of each might differ slightly because of differences in monitor calibration imaging technologies and ambient lighting The menu structure displayed in the SDK s browser is identical to that of the Nokia 3300 phone handset although not all menus in the SDK work identically to their Nokia 3300 handset counterpart because the SDK is not a phone but a developer s tool For example you cannot make a phone call on the SDK When you place a phone call the SDK simulates placing the call to the extent that you have to cancel the call function by clicking the End Call key but the call is never placed 8 Nokia 3300 SDK User s Guide Quick Tour of the Nokia 3300 SDK The SDK s main window looks like this SDK Instance number like a telephone number sax 3300000 Nokia 3300 SDK File Tools Help lt SDK Menus ontent display 128x128 canvas size Up and down Right soft key activates function on keys for
75. t the content on the Nokia 3300 SDK See Getting Information About the Content on the SDK on page 35 Or you might want to explore running the SDK from a command line See Running the SDK from a Command Line on page 67 Nokia 3300 SDK User s Guide 65 Using the SDK for MIDlet Development 66 Nokia 3300 SDK User s Guide Running the SDK from a Command Line Although anyone can use the SDK through the Windows command line you ll be more likely to use the command line interface if you are developing browser or message content If you are developing MIDlets you ll likely use command line options within a Java IDE for example to trace MIDlet events Configuration options you set on the command line override those you set in the Tools gt Settings dialog box but are not persistent between instances of the SDK If you need settings to be persistent use the settings in the Tools gt Settings dialog box Nokia 3300 SDK User s Guide 67 Running the SDK from a Command Line Accessing the Command Line Prompt To access the command line prompt 1 Select Start menu gt Run 2 Enter explorer in the Run dialog box 3 In the Explorer window that appears navigate to the directory where you installed the SDK 4 Right click on the bin directory and select Command Line Prompt Here from the drop down menu In the command line window that appears enter the command for starting the SDK which is covered in the
76. the MIDP view is closed the Diagnostics window looks like this Traffic HTTP 2 2 UDP 1940 5628 ISO 8859 1 5082 bytes MIDP KVM RAM and JAM RAM Used 66656 bytes 30 MAMAH ua Saas applications 5502 bytes games 0 bytes java SMS 0 bytes Browser Source http Jw ww spruce jp freemidlets NokiaTester NokiaTester jad 2590 bytes Browser History Stack size 1 Log Warning Fitter for TCP UDP Received is turned on Nokia 3300 SDK User s Guide 41 Getting Information About the Content on the SDK When you open the MIDP view you see the current status of JAM and KVM storage Traffic HTTP 2 2 UDP 1940 5628 3 ISO 8859 1 5082 bytes 66656 bytes 150432 bytes 4 KVM status of 217088 bytes currently active MIDlet File System E applications 5502 bytes 5 Spruce TechnologiesNokia Tester 5502 bytes NokiaTester jad 420 bytes 4 JAM status of Nokia Tester jar 5062 bytes stored MIDlets games 0 bytes java SMS 0 bytes and SMS Browser Source http twy spruce jp freemidlets NMokiaTester NokiaTester jad 250 bytes Browser History Stack size 1 Log YYarning Fitter for TCPAJDP Received is turned on About KVM Heapsize Status For the MIDlet that is currently active on the SDK the KVM memory status shows in bytes Free Bytes in the KVM heap that are available for use
77. to no to disable Diagnostics Sometimes when you make an international call on a handset a plus sign is required for the telephone number to connect for example 3300000 The SDK does not require the plus sign although the SDK distinguishes between 3300000 and 3300000 considering each a distinctly different number 22 Nokia 3300 SDK User s Guide What s Next What s Next Now that you ve customized the SDK you can go ahead and begin e Displaying wireless content as described in Using the Nokia 3300 SDK on page 25 e Developing MMS and Push messages as described in Using the SDK for Message Content Development on page 49 e Developing MIDlets as described in Using the SDK for MIDlet Development on page 59 Or you might want to explore running the SDK as a standalone application from a command line See Running the SDK from a Command Line on page 67 Nokia 3300 SDK User s Guide 23 Setting Up the Nokia 3300 SDK 24 Nokia 3300 SDK User s Guide Using the Nokia 3300 SDK Two essential tasks involved in using the SDK to develop wireless content are displaying content to check it for appearance and function and inputting commands and text in response to the content This chapter covers the various ways you can do these tasks About Loading Content on the SDK To check the appearance and function of your wireless content you can load it on the SDK in the following wa
78. use the close parameter with the exit option gt close exit gt gt exiting In the example above the close parameter closes the shell session and the exit option closes the instance within the session Using Inboxes and Outboxes With MMS Messages Using the command line interface you can set up a situation where the SDK can automatically e Retrieve and display MMS message files from a directory you specify with the xinbox option e Send MMS message files to a directory you specify with the xoutbox option You can take advantage of Xinbox option if you have set up a deployment directory in an IDE into which the MMS messages you create are automatically saved as MMS files but you can also manually place a message file into the deployment directory In either arrangement the SDK automatically retrieves the MMS message files from that directory displays the message and deletes the file Nokia 3300 SDK User s Guide 75 Running the SDK from a Command Line With the xinbox and Xoutbox options you can set up a situation in which two SDKs instances share inboxes and outboxes so that you can transfer messages from one SDK instance to another You may want to do this test to see whether a MIDI file can be forwarded within an MMS message You should not be able to forward a DRM forward locked protected file Or you can set up this situation to test how one MMS message appears on two different SDKs for example the
79. w select Tools gt Diagnostics If nothing is loaded on the browser the Diagnostic window looks like this when you first open it z737 3300000 Diagnostics Nokia 3300 SDK oj xj MIDP RAM Used 0 bytes 0 applications 0 bytes games 0 bytes java SMS 0 bytes Browser Source There is no current document Browser History Stack size 0 Log v When content is loaded on the SDK and none of the views are open the Diagnostic window looks something like this depending on the content a ojx When a view in the Diagnostics window is closed you can see a summary of the Traffic contents in each view HTTP 2 2 UDP 1878 2942 3 image gif IS0 8859 1 6558 bytes MIDP RAM Used 0 bytes 0 applications 0 bytes games 0 bytes java SMS 0 bytes Browser Source http www google com text html 2690 bytes Browser History Stack size 1 Log Warning Fitter for TCPJUDP Received is turned off 73 3300000 Diagnostics Nokia 3300 SDK 36 Nokia 3300 SDK User s Guide Working with the Diagnostic Window You can open close and adjust the size of a view With an open Browser Source view the Diagnostic window looks something like this depending on what s loaded on the browser mS 3300000 Diagnostics Nokia 3300 SDK Traffic HTTP 746 UDP 571648063 3 image gif ISO 8859 1 8558 bytes x MIDP RAM Us
80. ys e Open a local file using File gt Open e Open a URL on the Internet by using File gt Open or clicking the SDK keys to navigate to a web site but first you might have to set up a proxy server See Setting Up Network Access on page 17 This method is called browsing Nokia 3300 SDK User s Guide 25 Using the Nokia 3300 SDK e Load content from a supporting application within an IDE NMIT and Adobe GoLive let you display content on the SDK that you ve developed with their editors You can view the content by either clicking a button or making a menu selection in the application This method is called previewing Opening Content on the SDK Standalone Application You can load content on the SDK with File gt Open or by using the menus on the SDK as you would on the handset Loading Content With File gt Open To load content into the SDK when you are using the SDK as a standalone application 1 Select File gt Open 2 In the dialog box that appears do one of the following e To open a local file enter the full path of the file you want to open e To open mobile Internet content enter a URL 3 Click OK The SDK loads the content Loading Content Using the SDK Menus You can also load a web site using the menus on the SDK as you would on the handset For example 1 Select Menu gt Services gt Go To Address 2 Enter a URL like http wap yahoo com 3 Select OK The site in this example wap Yahoo com loads
81. ze Browser History Stack size 1 Log View of TCPUDP Received has been disabled When you open the Browser Source view you see the source code of the content that is on the browser 73 3300000 Diagnostics Nokia 3300 SDKs J4 Traffic 7 2 HTTP 7 6 UDP 57168063 Click to open the source code in image gif ISO 8859 1 8558 bytes the editor that is associated with MIDP the file extension of the content RAM Used 0 bytes 0 applications 5502 bytes gam 0 bytes java SMS 0 byt Browser Source v E Original Source X ji Click to select a viewing option for lt html gt lt head gt lt meta http equiv content ty the source code body td a p h font family arial sans se h font size ZOpx q text decoration none color 0000cc ffS gt lt style gt lt script gt lt function sf document f q focus ff gt lt script gt gt exthtml 2690 bytes ISO 3859 1 Browser History Stack size 1 Log view of TCPJUDP Received has been disabled Click the Edit icon to open the source code in the editor or browser that is associated with the file extension of the content To change the default file association go to Folder Options gt File Types in the Windows Control Panel Nokia 3300 SDK User s Guide 43 Getting Information About the Content on the SDK You can view the current content

Nokia 3300 Software Developer s Kit Version 1.0 User Guide

Contents

Download Pdf Manuals

Related Search

Related Contents