Пошаговое руководство по созданию мидлета

Для создания мидлета необходимо выполнить следующие шаги:

1. Создать новый проект
2. Создать описания полей
3. Определить шаблоны
4. Заполнить шаблоны значениями
5. Создать представления
6. Создать меню
7. Генерировать мидлет
8. Запустить мидлет в эмуляторе или на телефоне

Создание нового проекта

1. Запустите программу
2. Выберите в меню "File" -> "New project" (или нажать кнопку на панели инструментов)
3. В открывшемся диалоге "New project" заполните поля:
   • "Project name" - имя создаваемого проекта: "Planets"
   • "Project directory" - рабочий каталог создаваемого проекта: нажать кнопку , в открывшемся диалоге "Select" создайте и выберите каталог "C:\Planets":
   
4. Нажмите кнопку "Create project":
   
5. На вопрос программы "Открыть проект в новом окне?" можно ответить "No":
   
6. В результате в каталоге "C:\Planets" будет создан новый пустой проект "Planets".

Описание полей

1. В рабочей области проекта (в левой части программы) выделите ветку "Fields"
   
2. Выберите в меню "Edit" -> "Add item"
   ИЛИ нажмите кнопку на панели инструментов
   ИЛИ дважды кликните на ветке "Fields".
3. В рабочей области программы запустится редактор полей, и сразу же откроется диалог для добавления поля "Add Field". Заполните поля:
   • "Field name" - имя создаваемого поля: "name" (название планеты);
   • "Type" - тип создаваемого поля: "string"
   • поле "Default value" можно оставить пустым:
   
   Нажмите кнопку "OK".
4. Аналогичным образом добавьте остальные поля в соответствии со следующей таблицей:

   Имя поля	Тип	Назначение
   name	string	Название планеты
   image	image	Изображение
   mass	string	Масса
   diameter	integer	Диаметр
   distance from Sun	integer	Расстояние от Солнца
   mean temperature	integer	Средняя температура поверхности
   length of day	string	Долгота дня (оборота вокруг оси)
   length of year	string	Долгота года (оборота вокруг Солнца)
   explored	dictionary	Степень исследованности

   
   При создании поля типа "Dictionary" в правой части диалога "Add field" будет отображаться редактор словаря:
   
   Для добавления словарного значения нажмите кнопку :
   
5. В результате проведенных действий редактор полей должен выглядеть приблизительно так:
   
6. Сохраните сделанные изменения в проекте, выбрав в меню "File" -> "Save project" (или нажав кнопку на панели инструментов).

Определение шаблонов

1. В рабочей области проекта (в левой части программы) выделите ветку "Templates".
   
   Выберите в меню "Edit" -> "Add item"
   ИЛИ нажмите кнопку на панели инструментов
   ИЛИ дважды кликните на ветке "Templates". В рабочей области программы откроется редактор шаблонов.
2. В поле "Template name" введите имя шаблона: "All planets".
3. Нажмите кнопку и заполните поля появившейся строки следующими значениями:
   "Field" (поле, входящее в шаблон) -> "name",
   "Label" (подпись к полю) -> "Planet name",
   "Format" (формат отображения поля) -> "notnull",
   поставьте галочку в поле "Title" (признак, что данное поле будет выводиться в заголовке формы),
   а "Hidden" (признак, что это поле будет скрыто) оставьте невыбранным:
   .
4. Создайте и заполните остальные поля:
   
5. Сохраните изменения в проекте, выбрав в меню "File" -> "Save project" (или нажав кнопку на панели инструментов).

Заполнение шаблонов значениями

1. В рабочей области проекта выделите ветку "Data". Выберите в меню "Edit" -> "Edit"
   ИЛИ нажмите кнопку на панели инструментов
   ИЛИ дважды кликните на ветке "Data". В рабочей области программы откроется редактор данных.
2. В выпадающем списке "Template" выберите шаблон "Planets".
3. Заполните значения полей:
   "name" -> "Mercury",
   "mass" -> "3.3 x 10^23",
   "diameter" -> "4879",
   "distance from Sun" -> "58",
   "mean temperature" -> "452",
   "length of day" -> "58.65 days",
   "length of year" -> "87.97 days",
   "explored" -> "average".
   Для заполнения поля "image" нажмите кнопку , и в открывшемся диалоге "Choose image" добавьте файл, содержащий требуемое изображение (кнопка ): "tutorial\images\mercury.png":
   .
   В результате должно получиться следующее:
   
4. Для добавления очередной записи нажмите кнопку . Создайте остальные записи в соответствии с таблицей:

name	image	mass (kg)	diameter (km)	distance from Sun (mln km)	mean tempr. (K)	length of day	length of year	explored
Mercury	mercury.png	3.3 x 10^23	4879	58	452	58.65 days	87.97 days	poorly
Venus	venus.png	4.87 x 10^24	12104	108	726	243.02 days	224.7 days	average
Earth	earth.png	5.98 x 10^24	12756	150	281	1 day	365.26 days	good
Mars	mars.png	6.42 x 10^23	6787	228	230	1.026 days	686.98 days	average
Jupiter	jupiter.png	1.90 x 10^27	142800	778	120	9.8 hours	11.86 years	poorly
Saturn	saturn.png	5.69 x 10^26	120660	1427	88	10.2 hours	29.46 years	poorly
Uranus	uranus.png	8.68 x 10^25	51118	2871	59	17.9 hours	84 years	poorly
Neptune	neptune.png	1.02 x 10^26	49528	4498	48	19.1 hours	164.8 years	poorly
Pluto	pluto.png	1.29 x 10^22	2300	5906	37	6.39 hours	247.92 years	poorly

5. Сохраните изменения.

Создание представлений

1. В рабочей области проекта выделите ветку "Views". Выберите в меню "Edit" -> "Add item"
   ИЛИ нажмите кнопку на панели инструментов
   ИЛИ дважды кликнуть на ветке "Views". В рабочей области программы откроется редактор представлений.
2. Заполните поля редактора следующими значениями:
   "View name" (имя представления) -> "All planets",
   "View title" (заголовок представления) -> "All planets",
   "View field" (поле, по которому будут сортироваться и отображаться записи представления) -> "name",
   "Sort descending" (сортировка записей представления по убыванию) оставьте пустым,
   "Query" (запрос – условия отбора записей в представление) -> "1=1" (условие всегда истинно, т.е. в представление будут выбираться все записи):
   
3. Аналогично создайте представления "Near planets" и "Far planets":
   
   
   

Создание меню

1. В рабочей области проекта (в левой части программы) выделите ветку "Menus".
   
   Выберите в меню "Edit" -> "Add item"
   ИЛИ нажмите кнопку на панели инструментов
   ИЛИ дважды кликнуть на ветке "Menus". В рабочей области программы откроется редактор меню.
2. Создайте подменю (для просмотра планет по категориям). Назовите его "Planets by category":
   
3. Создайте главное меню, нажав кнопку на панели инструментов приложения. В поле "Menu name" введите имя меню: "Main menu", отметьте галочку "Main menu", поле "Menu title" можно оставить пустым. Это будет главное меню мидлета. Добавьте в него такие пункты:
   
   Сохраните проект.

Генерация мидлета

1. Выберите в меню программы пункт "BOOKlet" -> "Generate MIDlet"
   ИЛИ нажмите кнопку на панели инструментов.
2. Откроется окно, содержащее информацию о ходе и результате генерации мидлета. Если генерация прошла успешно, Вы должны увидеть что-то похожее:
   

Запуск мидлета в эмуляторе

1. Выберите в меню программы пункт "BOOKlet" -> "Run emulator"
   ИЛИ нажмите кнопку на панели инструментов.
2. Откроется диалоговое окно, в котором нужно определить параметры для запуска установленного на Вашем компьютере эмулятора мобильного устройства:
   
   Параметры запуска эмуляторов для различных моделей устройств описаны в документации соответствующих SDK.
3. Нажмите кнопку "Run" для запуска мидлета в эмуляторе:
   

Поздравляем!