В этой главе Вы узнаете как создавать новый проект, компилировать и запускать его в эмуляторе. Вы также узнаете добавлять другие эмуляторы и переключаться между ними. Вы узнаете как заливать ваше приложение в реальный телефон или WAP сайт. Под конец, Вы узнаете как добавлять в ваше приложение другие ресурсы, такие как картинки, мелодии и проч.
Создание нового проекта
При запуске, главное окно MIDlet Pascal выглядит примерно так:
Для создания нового проекта, выберите пункт меню Файл --> Новый проект. На экране появится диалоговое окно:
Пока что вы можете выбрать только один тип проекта, который называется Обычный MIDP проект. Введите название проекта, и выберите папку, в которой будут храниться все файлы данного проекта.
После того как вы кликните кнопку Создать, MIDlet Pascal создаст папку с заданным именем и поместит туда все необходимые на первое время файлы. Если все операции прошли успешно, главное окно программы будет выглядеть примерно так:
Вы только что создали свой первый проект на MIDlet Pascal! Поздравляем!
Компиляция и запуск проекта
Для компиляции вашего проекта выберите пункт меню Проект -> Компилировать или просто нажмите клавишу F7. MIDlet Pascal начнет компилировать ваш проект и вы увидите примерно такие строки в окне компиляции внизу экрана:
Как вы видите, MIDlet Pascal сообщает нам, что при компиляции ошибок не было и исполнимый файл был успешно создан. Если же напротив ошибки в тексте были, компилятор сообщит нам какая ошибка, в каком файле и в какой строке была обнаружена. Вы можете дважды кликнуть по сообщению об ошибке для быстрого перехода к исходному файлу для коррекции ошибки.
Если компиляция прошла успешно, MIDlet Pascal создаст два файла (их можно найти в папочке bin вашего проекта): JAD файл (Java Application Descriptor - Описание Java приложения) и JAR файл (Java Archive - Java архив с исполнимыми файлами и ресурсами). Оба файла необходимы для установки приложения на телефон (хотя многие продвинутые модели телефонов при отсутствии JAD файла могут генерировать его и самостоятельно). Обычно когда пользователь скачивает приложение из Интернета, он первым делом скачивает JAD файл, в котором содержится название, длина и адрес JAR файла в сети (URL). Если пользователь выбирает установку приложения, телефон самостоятельно скачает JAR файл с заданного адреса и произведет установку приложения.
Для тестирования вашего приложения на компьютере вам необходимо скачать и установить один либо несколько эмуляторов мобильного телефона. Самым мощным и универсальным эмулятором является эмулятор из пакета Wireless Toolkit корпорации Sun (его можно бесплатно скачать на сайте sun.com). Также Вы можете установить эмуляторы от производителей мобильных телефонов, таких как Nokia, Motorola, Samsung, Siemens или Sony Ericsson. Как установить несколько эмуляторов в MIDlet Pascal мы объясним ниже. По умолчанию, MIDlet Pascal считает, что у вас уже установлен пакет Wireless Toolkit и будет стараться использовать его.
Итак, для запуска вашего приложения выберите пункт меню Проект -> Запустить или просто нажмите F5. Если у вас уже установлен пакет WTK, то вы увидите примерно такое окно эмулятора телефона:
Теперь просто воспользуйтесь функциями вашего эмулятора для тестирования вашего приложения.
Использование нескольких эмуляторов
Как говорилось выше, Вы можете использовать более чем один эмулятор. В теории, любой Java мидлет (включая те, что были написаны на MIDlet Pascal) должен работать на любом устройстве с поддержкой Java, но на практике такого часто не происходит. Во первых, старые телефоны поддерживают профиль MIDP1.0, а более новые - профиль MIDP2.0. Поэтому у Вас не получится запустить приложение, написанное под MIDP2.0 на телефоне с поддержкой MIDP1.0. Другая немаловажная проблема - это размер экрана: если Ваше приложение хорошо смотрится на экране 128x160 точек, то на экране 128x128 точек пользоваться им будет совершенно невозможно.
При профессиональной разработке приложений Вам нужно быть уверенным, что данный мидлет будет корректно работать на всех требуемых устройствах, поэтому для продвинутых пользователей даже рекомендуется использовать более чем один эмулятор. Давайте покажем как добавлять в MIDlet Pascal дополнительные эмуляторы и как переключаться между ними при тестировании мидлета.
Выберите меню Опции -> Настройки программы. На экране появится диалог покказанный ниже. Кликните по иконке Эмулятор слева и на экране отобразится диалог свойств эмуляторов:
Now you want to add the Nokia emulator. Select Add
button, and the following window will appear on the screen:
Enter the name of the emulator in the Emulator description field, such as Nokia 3650. Enter the path to the emulator executable file in the Run command field. The emulator executable usually takes a command-line argument that tells it which MIDlet to run. The command line argument may be the path to the JAD file or to the JAR file. If it is the path to the JAD file, enter %JAD%, or, similarly, if it is the path to the JAR file, enter %JAR%. In case of the Nokia 3650 emulator, the Run command is:
C:\Nokia\Devices\Nokia_3510i_MIDP_SDK_v1_0\bin\3510i.exe %JAD%
Click the Add button and you will see that Nokia 3650 appears in the list below the Default emulator. Then add the Motorola emulator just like you added the Nokia emulator. MIDletPascal supports up to 128 different emulators.
When you want to change the currently used emulator, click on the down arrow next to the Run MIDlet icon on the toolbar, and select the emulator that you want to use.
Installing application on the mobile phone
There are two ways of installing your MIDlet application on the mobile phone: you can connect your phone to the computer, or you can connect your phone to the Internet and download the MIDlet.
The mobile phone can connect to the computer using IrDA, Bluetooth or data cable. Phone manufacturers provide software for transferring data to the phone. Refer to your phone manufacturer's manuals for detailed instructions on transferring data onto your mobile phone. You should copy two application files on the phone, the JAD and JAR file. These files can be found in the \bin subdirectory of your project's directory.
When distributing your application, you will most probably use the Internet. You will need to upload both the JAD and JAR file to a web or wap server. Anyone who wants to download the MIDlet application should download the JAD file (so all links to your application should point to the JAD file), and the mobile phone will automatically download the corresponding JAR file. However, before uploading, you should change the JAD file so that it contains the proper URL of the JAR file.
For example, let's say that you will upload your application's JAD and JAR files to http://www.myserver.com/midlets/ location. If the application name is Test, you will have Test.jar and Test.jad files inside \Test\bin directory. Open the Test.jad file with Wordpad text editor (do not use Notepad for this!), and locate the line:
Change it to contain the full URL:
| MIDlet-Jar-URL: http://www.myserver.com/midlets/Test.jar
| Save the changed JAD file and upload it to the server.
Adding resources to the project
When you create the new MIDletPascal project, it will contain a single resource file that is used as an application icon. You may want to add more resource files such as images (in PNG file format) or sound files.
To import an existing file from your local disk into the MIDletPascal project, select Project -> Import resource file
menu. You will be asked to locate the file, which will be copied into the \res subdirectory in your project's directory. When the file is imported into the project, you should see it in the Files list on the left side of the MIDletPascal window.
You can also insert a new image file into the project. New image file can be created by selecting Project -> New image resource
menu. You will be asked for the image name and the image dimensions. Mobile Java only supports PNG images.
MIDletPascal contains a simple image editor that can be used for editing image resources. When you want to edit the image resource, double-click the resource in the Files list, and MIDletPascal will open the image editor:
|