NetBeans 4.1 - бесплатная IDE для разработки J2ME приложений
Введение
В настоящее время Java разработчики могут воспользоваться несколькими коммерческими IDE. Однако, существуют и открытые проекты, отнюдь не уступающие по своим возможностям платным аналогом. Одной из таких сред является NetBeans IDE 4.1 (www.netBeans.org).
Ниже будет рассказано, как использовать NetBeans IDE 4.1 для создания Java™ 2 Platform, Micro Edition MIDP приложений. Будут показаны все необходимые при работе с новым проектом базовые шаги. Мы создадим проект "MyHello", который будет выводить текст "Hello World" в окне эмулятора.
Требования
Прежде всего, Вам потребуется NetBeans IDE 4.1 и NetBeans Mobility Pack 4.1. Скачать их можноздесь.
Создание нового проекта
В состав NetBeans IDE входит мастер, автоматизирующий процесс создания MIDP проектов. Вам будет предложен выбор: воспользоваться визуальным редактором (MIDP Visual Designer) или редактором исходного текста (Source Code Editor).
Использование визуального редактора позволит Вам спланировать уровни приложения и создать формы пользовательского интерфейса, которые будут использоваться в приложении. Дизайнер автоматически сгенерирует код приложения. Этот подход имеет одно ограничение: если Вы редактируете сгенерированный код в Source Editor, то не можете затем вернуться к редактированию в Visual Designer. Кроме того, вам придется использовать методы повторного возврата, чтобы создать блоки препроцессора для конфигурации Вашего проекта.
Используя Source Editor, Вы вручную создаете код Вашего мидлета. Source Code Editor дает вам больше гибкости при редактировании кода и возможность создать блоки кода препроцессора.
Создание MIDP приложения с использованием Visual Designer-а.
Создание нового J2ME MIDP проекта
- Выполните File > New Project (Ctrl-Shift-N). В меню Categories выберите Mobile; в Projects - Mobile Application и нажмите кнопку Next.
- Введите MyHello в поле названия проекта (Project Name). Выберите в Project Location любую папку. Начиная с этого момента она будет доступна нам как переменная среды $PROJECTHOME.
- Отметьте галочками Set as Main Project и Create Hello MIDlet (Оба эти поля выбраны по умолчанию). Нажмите Next.
- Оставьте в поле Target Platform значение J2ME Wireless Toolkit.
- Нажмите кнопку Finish. Будет создана папка $PROJECTHOME./MyHello. В ней будут находиться все исходники и метаданные проекта. Само по себе приложение показано в окне Flow Design редактора Visual Designer.
Редактирование Java исходников
Давайте займемся редактированием текста Midlet-а.
- Щелкните на Screen Design. Это приведет к открытию окна Screen Designer и Вы увидите helloTextBox[Textbox] экран, который является единственным экраном, доступным в приложении.
- Щелкните на экране helloTextBox и введите какой-нибудь текст. По умолчанию там забит "Hello, World!".
Компиляция и запуск проекта
- Выберите Run > Run Main Project (F6) из меню Run. Дважды щелкните на окне Output, чтобы развернуть его на весь экран. Теперь вы можете видеть всю выводимую информацию. Заметьте, файл HelloMIDlet.java компилируется прежде чем выполняется. Для выполнения полученного мидлета будет открыт эмулятор устройства. По умолчанию открывается эмулятор DefaultColorPhone.
- В окне эмулятора щелкните на кнопку под командой Launch. В результате эмулятор запустит мидлет на выполнение и вы увидите введенный Вами текст.
- Щелкните в окне эмулятора на кнопку под надписью Exit. можете закрыть окно эмулятора.
Создание MIDP приложений с использованием Source Editor
Создание нового J2ME MIDP проекта
- Выполните File > New Project (Ctrl-Shift-N). В меню Categories выберите Mobile; в Projects - Mobile Application и нажмите кнопку Next.
- Введите MyHelloMIDlet в поле названия проекта (Project Name). Выберите в Project Location любую папку. Начиная с этого момента она будет доступна нам как переменная среды $PROJECTHOME.
- Отметьте галочкой Set as Main Project и уберите с Create Hello MIDlet. Нажмите Next.
- Оставьте в поле Target Platform значение J2ME Wireless Toolkit.
- Нажмите кнопку Finish. Будет создана папка $PROJECTHOME./MyHello. В ней будут находиться все исходники и метаданные проекта.
- Правой кнопкой нажмите на MyHelloMIDlet в окне Explorer и выберите New > File/Folder.
- В Categories выберите MIDP, в File Types выберите MIDlet и нажмите Next.
- В качестве имени мидлета задайте HelloMIDlet. Нажмите Finish. Будет создан HelloMIDlet.java.
- Дважды щелкните на HelloMIDlet.java для того, чтобы начать редактирование этого файла.
- Перейдите в окно Source Editor и измените
publicclass HelloMidletextends MIDlet
на
publicclass HelloMIDlet
extends MIDlet implements javax.microedition.lcdui.CommandListener
{
- вставьте следующий текст перед методом startApp():
public HelloMIDlet(){}
private void initialize(){
javax.microedition.lcdui.Display.getDisplay(this).setCurrent(get_helloTextBox());
}
public void commandAction(javax.microedition.lcdui.Command command,
javax.microedition.lcdui.Displayable displayable){
if(displayable== helloTextBox){
if(command== exitCommand){
javax.microedition.lcdui.Display.getDisplay(this).setCurrent(null);
destroyApp(true);
notifyDestroyed();
}
}
}
private javax.microedition.lcdui.TextBox get_helloTextBox(){
if(helloTextBox==null){
helloTextBox=new javax.microedition.lcdui.TextBox(null,"Test String",120,0x0);
helloTextBox.addCommand(get_exitCommand());
helloTextBox.setCommandListener(this);
}
return helloTextBox;
}
private javax.microedition.lcdui.Command get_exitCommand(){
if(exitCommand==null){
exitCommand=new javax.microedition.lcdui.Command("Exit",
javax.microedition.lcdui.Command.EXIT,1);
}
return exitCommand;
}
javax.microedition.lcdui.TextBox helloTextBox;
javax.microedition.lcdui.Command exitCommand;
- Измените метод startApp() на следующий
public void startApp(){
initialize();
}
Редактирование Java исходников
Давайте добавим код, пишущий строку на экране. Для этого нужно заменить в get_helloTextBox() текст "Test String" на любой другой, например на "Hello World."
Компиляция и запуск проекта
- Выберите Run > Run Main Project (F6) из меню Run. Дважды щелкните на окне Output, чтобы развернуть его на весь экран. Теперь вы можете видеть всю выводимую информацию. Заметьте, файл HelloMIDlet.java компилируется прежде чем выполняется. Для Выполнения полученного мидлета будер открыт эмулятор устройства. По умолчанию открывается эмулятор DefaultColorPhone.
- В окне эмулятора щелкните на кнопку под командой Launch. В результате эмулятор запустит мидлет на выполнение и вы увидите введенный Вами текст.
- Щелкните в окне эмулятора на кнопку под надписью Exit. можете закрыть окно эмулятора.
Выбор платформы эмулятора
Вы можете создавать различные конфигурации проекта для того, чтобы протестировать Ваш MIDlet на эмуляторах различных платформ.
Изменение эмулируемого устройства
- Щелкните правой кнопкой на узле MyHello Project и выберите Properties. В диалоге Properties выберите Platform. Вы можете изменить установленный по умолчанию эмулятор на другой.
- Щелкните на выпадающем меню Device и выберите QwertyDevice. Нажмите OK.
- Запустите приложение снова. На этот раз приложение запустится в QwertyDevice эмуляторе.
Добавление нового эмулятора платформы
- Выберите меню Tools > Java Platform Manager.
- В диалоге Java Platform Editor щелкните на кнопке Add Platform.
- На странице Choose Platform Folder мастера Add Platform нажмите кнопку Browse. Выберите корневой каталог эмулятора, который Вы хотите установить. Например, c:\WTK22. Щелкните Next.
- На Configure the Platform Page IDE распознает и сконфигурирует платформу. После этого Вам будет показана информация о платформе. Нажмите Finish.
- Выберите File > "MyHello" Properties.
- Выберите узел Platform , затем найдите имя нового эмулятора (Например, J2ME Wireless Toolkit 2.2) в выпадающем меню Emulator Platform. Нажмите OK.
Использование конфигурирования
Вы можете использовать конфигурацию для создания нескольких jar и jad файлов для проекта. Это позволит на основании одного исходного кода создавать несколько релизов под различные устройства.
Добавление конфигурации
- Щелкните по узлу MyHello Project и выберите Properties. В диалоге Properties выберите Add Configuration из выпадающего меню Project Configuration. В результате будет открыт диалог Add Configuration.
- Введите имя новой конфигурации в поле Configuration Name. Имя должно обозначать целевую платформу для которой Вы будете создавать jar/jad файлы. Например, введите BlackWhiteDisplay и нажмите OK. Вы только что создали новую конфигурацию.
- Конфигурация может быть добавлена с помощью нажатия кнопки Manage Configurations в диалоге Properties. Указанная кнопка открывает диалог Project Configuration Manager, который содержит настройки для добавления удаления или дублирования конфигурации.
Настройка конфигурации
Число конфигураций, которое Вы можете добавить в проект, не ограниченно. Для настройки созданной конфигурации используйте диалоговое окно Project Properties.
- Щелкните правой клавишей на узел MyHello Project и выберите Properties. В диалоге Properties выберите Platform. В результате откроется диалог J2ME MIDP Configuration.
- Выберите в выпадающем меню созданную нами конфигурацию BlackWhiteDisplay.
- Все компоненты диалога Platform недоступны. Поскольку эта конфигурация по умолчанию устанавливает значения конфигурации Default. Снимите галочку с поля Use Default Project Configuration Values внизу диалога. Теперь все компоненты диалога доступны.
- Измените настройку Device на DefaultGrayPhone.
- Переключите Project Configuration диалог вверху диалога Properties. Обратите внимание, Настройки Device изменились на выбранные в настоящий момент. Этот метод настройки конфигурации работает для каждой панели диалога. Нажмите OK, чтобы сохранить изменения и закройте диалог Properties.
Создание ability
Когда Вы создаете ability, Вы сопоставляете ее одной или нескольким конфигурациям проекта, поддерживающим различные специфические атрибуты. После этого Вы сможете связать ability с одним или несколькими блоками кода, поддерживающими атрибуты. Если Вам позднее понадобится добавить или удалить конфигурацию, Вам не придется просматривать весь свой код и связывать конфигурацию с каждым блоком. Вместо этого, Вы просто свяжите конфигурацию с ability. После чего конфигурация будет автоматически сопоставлена с блоком кода, связанным с ability.
- Щелкните правой кнопкой на узле MyHello проекта и выберите Properties.
- Выберите Abilities в дереве меню Category.
- Выберите конфигурацию в меню Project Configuration. Эта конфигурация будет связана с ability.
- при необходимости снимите выделение с Use Values в "DefaultConfiguration".
- Нажмите кнопку Add Ability. Это приведет к открытию диалога Add Ability.
- Нажмите кнопку New Ability.
- В диалоге New Ability введите имя для ability. Нажмите OK. Теперь ability сопоставлена с выбранной конфигурацией проекта.
Вы можете связывать ability с другими конфигурациями. Для этого нужно выбрать требуемую конфигурацию в меню Project Configuration и нажать кнопку Add Ability.
Добавление специфического кода конфигурации (Блоки препроцессора).
Блок препроцессора позволяет вам создавать, управлять и прослеживать код, связанный с одной или несколькими конфигурациями и abilities. Вы сами связываете код с определенной конфигурацией или ability.
- В правом верхнем углу окна редактора расположено выпадающее меню. По умолчанию там выбрано "Default Configuration". Выберите созданную нами конфигурацию BlackWhiteDisplay.
- Щелкните правой кнопкой мыши на строке исходного текста в TextBox и выберите Preprocessor Blocks > Create If/Else Block. В первом сером блоке добавьте слово "Gray" к строке "Hello World". Во втором розовом блоке добавьте слово "Color".
- Переключите меню конфигурации в правом верхнем углу редактора. Обратите внимание, в зависимости от выбранной конфигурации лишние блоки комментируются.
Выполнение конфигураций
Конфигурации могут компилироваться и запускаться отдельно или одновременно.
- Щелкните правой клавишей на узле MyHello Project и выберите Run.
- Активируйте различные конфигурации нажимая правой кнопкой на узле MyHello Project -> Set Active Project Configuration, а затем выбирая различные конфигурации. Это же можно сделать с помощью меню конфигурации в окне текстового редактора. Запустите проект.
- Будет открыто два эмулятора цветной и черно-белый. На экране эмулятора черно-белого телефона Вы увидите текст "Hello World Gray", а на экране цветного - "Hello World Color".
Создание Client-Server приложений
Использование мастера Wireless Connection
Использование мастера J2ME Wireless Connection Wizard позволяет генерировать классы для мобильных client/server приложений автоматически и без использования библиотек.
Для использования J2ME Wireless Connection Wizard вы должны иметь проект мобильного приложения, содержащий основной MIDP код и открытый web проект с, по крайней мере одним, J2SE service классом для экспорта.
Для создания client/server соединения необходимо:
- Открыть Wireless Connection Wizard. Для этого выберите Mobile Project среди доступных проектов, а затем File > New File, затем MIDP > Wireless Connection Wizard.
- Выберите имя, web проект и пакет для генерируемого кода сервера.
- Выберите сервисы, которые будут экспортированы с сервера на клиентское приложение.
- Выберите имя и пакет для сгенерированного клиентского класса.
- Определите тип генерируемого кода:
- Метод-заглушка для каждого экспортируемого сервиса.
- Код, позволяющий звонить во время сеанса.
- Отслеживаемый код.
- Простой MIDlet, который можно модифицировать.
Мастер создает:
- J2ME клиентский класс
- Сервлет и поддерживающие классов
- Файл отображения в формате xml
- В зависимости от вашего выбора, Вы можете модифицировать MIDlet.
J2ME клиент, файл отображения и MIDlet генерируются в рамках J2ME проекта. Сервлет и поддерживающие классы генерируются в web проекте. Сервлет также добавляется к web приложению (web.xml).
Локализация приложения
Добавление поддержки локализации
- Щелкните правой клавишей на узле MyHello Project и выберите New > File/Folder.
- Выберите папку MIDP, а потом Localization Support Class. Нажмите Next.
- Примите установки оп умолчанию, нажав Finish. В результате будет создан файл LocalizationSupport.java и messages.properties.
- Выберите Tools > Internationalization > Internationalization Wizard. Будет открыт мастер интернационализации.
- Выберите HelloMIDlet MIDlet как исходный файл для интернационализации. Нажмите Next.
- Выберите файл ресурсов HelloMIDlet Messages в качестве файла, куда будут сохраняться значения строк для интернацианализации. Нажмите Next.
- Измените поле Value для каждого ключа, определенного для HelloMIDlet MIDlet.
- После того, как строка будет добавлена в файл messages.properties, проделайте следующие операции для добавления значений каждой новой локализации.
- Щелкните правой клавишей на узле Projects и выберите Add Locale.
- Выберите из Predefined Locales необходимую локализацию. Вы также можете использовать выпадающее меню сверху формы.
- Разверните узел message.properties в Projects и сделайте двойной щелчок на newly-added locale.
- Преведите все свойства на требуемый язык.
Ваше приложение будет использовать атрибут microedition.locale для определения необходимой версии файла messages.properties.
Статья написана на основании
материалов сайтаwww.netBeans.org
aRix
