Right, you have written your first service. But how to test it?

Testing in web browser

Firstly, test your service in web browser. View your 'welcome message', click on first screen. Fill the forms, send them. Test the logic of your programming.

Testing in emulator

Secondly, test your service in emulator. Advantage of emulator is that you don't have to pay for transmitted data and you get extensive debug output: You can see which URL is called, which POST data are sent, which cookies are sent, what is the response and where the parsing of XHTML stopped in the case of error (on this place is probably some error in your page).

How to run Locify in emulator

  • Download and install Sun Java Wireless Toolkit.
  • Run the emulator by launching bin/ktoolbar.exe.
  • Go to Edit-Preferences-Security. Set Security domain to "maximum" to avoid repetitive warnings about file access.
  • Click on File->Create project from JAD/JAR.
  • Download Locify client and open it. Click on Run.
  • In Locify go to Options -> Add -> Service By Link and input URL of your welcome message
  • The debug output is shown in the main window of emulator in console.

Testing in Locify client

When everything works in browser, it's time to test service in client. Go to Options -> Add -> Service By Link and type there URL of your welcome message. Now you can install your service and try to use it.

Possible sources of problems

  • Your pages are not XHTML 1.0 Strict valid
  • Your pages don't reflect format described in this documentation
  • Your pages are cached in client - you need to disable caching for testing purposes
  • There is a bug in client - post its description into Locify Developers Google Group. Please include a debug output from emulator.

When your service is fully tested in client, you can make it public.