Configuring KToolbar | Sun Microsystems J2ME specs

When you use a third-party library in your application, your JAR will expand by the size of the third-party library. You can use an obfuscator to reduce the code size, and a good obfuscator will even eliminate whatever parts of the library you are not using. Even with the use of an obfuscator, a third-party library will probably still be larger than your own custom code, carefully written from scratch. You have to evaluate the tradeoff between reducing your development time and the size of your MIDlet suite JAR.

3.6.1Third-Party Libraries for One Project

Any library files placed in your project’s lib directory will be included in the building and packaging of your project. Libraries should be JAR or Zip files of Java classes.

For example, if you installed the J2ME Wireless Toolkit in C:\WTK22 and your application is called Tiny, the class library would go in C:\WTK22\apps\Tiny\lib. When you build, run, debug, and package your project, the class files in the lib directory are used.

3.6.2Third-Party Libraries for All Projects

Some devices have libraries available to all installed MIDlet suites. A manufacturer, for example, can make additional APIs available on all their devices. In this case, you want to be able to use these libraries when you build and test your application. You don’t want the libraries to be included in your packaged MIDlet suite because you will be installing the MIDlet suite on devices where the library is already present.

You can accomplish this by placing libraries in the {toolkit}\apps\lib directory. For example, if you installed the J2ME Wireless Toolkit in C:\WTK22, you would place the class libraries in C:\WTK22\apps\lib. Libraries in this directory are available for all projects.

3.7Configuring KToolbar

KToolbar includes some advanced configuration options. You can use these options by editing the {toolkit}\wtklib\{platform}\ktools.properties file. To see the effects of your changes, restart KToolbar.

26 J2ME Wireless Toolkit User’s Guide • October 2004

Image 38

Sun Microsystems J2ME Configuring KToolbar, Third-Party Libraries for One Project, Third-Party Libraries for All Projects

Contents

User’s Guide Please Recycle Contents Using the Emulator Security and MIDlet Signing Using the PIM and FileConnection APIs Command Line Reference 103 Index Related Documentation PrefaceWho Should Use This Book How This Book Is Organized Preface We Welcome Your Comments Accessing Documentation OnlineTypographic Conventions Introduction Quick Start Tools in the Toolkit KToolbar window Supported Technology Toolkit FeaturesSupported JCP APIs in the J2ME Wireless Toolkit Mmapi Developing MIDlet Suites About Projects Creating a new project Simple Development Cycle Edit Source Code Build 3 Run Messages about building List of project MIDlets Full Development Cycle Package Install Emulator AMS welcome screen URL prompt Application menu, again Using an Obfuscator Launching the installed application Obfuscate.script.name scriptfile Using a Debugger Deploying Applications on a Web Server From the command line, run Working With Projects Selecting APIs Project settings window Changing MIDlet Suite Attributes Editing MIDlet suite attributes Manipulating MIDlets List of MIDlets in a project Using the Push Registry Project push registry settings Project directory structure Using Third-Party LibrariesProject Directory Structure Third-Party Libraries for All Projects Configuring KToolbarThird-Party Libraries for One Project Working with Revision Control Systems Setting the Application DirectorySetting the javac Encoding Property 28 J2ME Wireless Toolkit User’s Guide October Emulator skins Using the EmulatorEmulator Skins Using the Emulator DefaultColorPhone emulator skin Keyboard shortcuts Setting Emulator PreferencesNetwork Proxies Storage and Cleaning Heap Size Adjusting Emulator Performance Choose Edit Preferences... and click on the Performance tab Pausing and Resuming Adjusting the emulator’s performance Using Third Party Emulators Running the Emulator Solo Emulators 38 J2ME Wireless Toolkit User’s Guide October Using the Profiler Monitoring Applications Turning on the profiler Call Graph Execution Time and Number of Calls Using the Memory Monitor Saving and Loading Profiler Information You’ll see a table with the following columns Using the Network Monitor Saving and Loading Memory Monitor Information Filtering Messages Network monitor Saving and Loading Network Monitor Information Network monitor filter settingsSorting Messages Clearing the Message Tree 48 J2ME Wireless Toolkit User’s Guide October Security and MIDlet Signing Permissions Protection Domains MIDlet suite permissions Signing a MIDlet Suite Managing Keys Creating a New Key Pair Getting Real Keys Creating a new key pair Removing a Key Pair Managing CertificatesImporting an Existing Key Pair Importing Certificates Certificate manager Removing Certificates Using the Wireless Messaging API Setting Emulator Phone Numbers Setting WMA preferences Simulating an Unreliable Network Sending Messages With the WMA Console Sending a Text SMS Message Sending a Binary SMS Message Sending a text message Sending Text or Binary CBS Messages Sending a binary message Sending MMS Messages Sending CBS messages Adding recipients for an MMS message Using the Network Monitor with WMA Receiving Messages in the WMA Console Supported Mmapi media formats Using the Mobile Media APISupported Formats and Protocols Well-Behaved MIDlets Using MediaControlSkinMedia Capture JSR 184 Overview Immediate ModeWorking With Mobile 3D Graphics Retained Mode Trading Quality for Speed Creating Mobile 3D Graphics Content 70 J2ME Wireless Toolkit User’s Guide October Using the PIM and FileConnection APIs FileConnection API PIM API Managing filesystem roots Obex Over Infrared Using the Bluetooth and Obex APIsBluetooth Simulation Environment Setting Obex and Bluetooth Preferences Obex Preferences Bluetooth BCC Properties Bluetooth Discovery TimeoutBluetooth System Properties BCC properties 76 J2ME Wireless Toolkit User’s Guide October Using Web Services Web services stub generator 78 J2ME Wireless Toolkit User’s Guide October Application Demonstrations Overview \WTK22\apps\WMADemo\src\example\sms\SMSSend.java Application demonstrations General Instructions KToolbar BluetoothDemo Opening a demonstration application project Running the Bluetooth Demo server Demo3D Life3D PogoRoo Controls for Life3D Retainedmode Bouncing kangaroo JSR172Demo Mmademo Simple Tones Simple Player Player commands PausingAudioTest Video Descriptions of MMAPI-specific MIDlet attributes ObexDemoAttributes for mmademo Waiting for an Obex connection Prompting to accept a connection PDAPDemo Browsing Files Contents of the root1 directory PIM API Choosing a list type To actually save the list item, choose Commit from the menu WMADemo Saving an item Sending a text message Push registry springs to life Addressing an MMS message WMADemo receives the image Development Cycle Command Line ReferencePrerequisites Preverify options files directories Jar cfm MyApp.jar MANIFEST.MF -C classes . -C res Run=storagename storagenumber Debugging Remove=storagename storagenumber all Emulator Preferences Properties List Toolkit component commandsLaunching Toolkit GUI Components Monitor Enable memory monitor Using Security Features Changing the Emulator’s Default Protection Domain Signing MIDlet Suites Managing Certificates Options Using the Stub GeneratorOptions for the wscompile Command Command Supported Features -f for wscompile Example Locale Setting Internationalization Emulated Locale Character Encodings Font Support in the Default Emulator Java Compiler Encoding Setting 118 J2ME Wireless Toolkit User’s Guide October Index Ktools.properties, 27 ktools.properties ﬁle Index 122 J2ME Wireless Toolkit User’s Guide October