| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> | |
| <!-- | |
| Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved. | |
| --> | |
| <HTML> | |
| <HEAD> | |
| <TITLE>Особые компоненты Visual Mobile Designer: создание приложения для управления персональными данными — учебный курс по NetBeans Java ME</TITLE> | |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" > | |
| <link rel="stylesheet" type="text/css" href="../../../netbeans.css"> | |
| <meta name="author" content="Karol Harelzak"> | |
| </HEAD> | |
| <BODY> | |
| <a name="top"></a> | |
| <H1>Особые компоненты Visual Mobile Designer: создание приложения для управления персональными данными</H1> | |
| <P>Visual Mobile Designer (VMD) — это графический интерфейс NetBeans Mobility, который позволяет разрабатывать мобильные приложения, используя функцию перетаскивания компонентов. VMD позволяет определять структуру приложений и создавать собственный интерфейс пользователя с помощью компонентов среды IDE или с помощью самостоятельно созданных компонентов. VMD содержит различные стандартные компоненты интерфейса пользователя, которые используются для создания приложений (например списки, предупреждения, формы и изображения). В него также входят особые компоненты, которые упрощают создание более сложных элементов (экранов ожидания, заставок, элементов таблицы и др.) </P> | |
| <p>Обозреватель PIM — особый компонент, который предоставляет доступ к функциям стандартных мобильных устройств (календарь, адресная книга, список задач). Компонент обозревателя PIM обеспечивает приложениям Java доступ к локальным базам личных данных. Компонент использует интерфейс API PIM (Personal Information Management), который входит в дополнительные пакеты JPDA <a href="http://jcp.org/en/jsr/detail?id=75">спецификации JSR-75</a> для платформы Java ME. Так как JSR-75 не входит в спецификацию MIDP 2.0, он по определению является особым компонентом и может использоваться только на устройствах с поддержкой JSR-75.</p> | |
| <P>В этом учебном курсе показано использование компонента "Обозреватель PIM" в мобильном приложении на устройствах с поддержкой JSR-75. Здесь демонстрируются основные функции: просмотр содержимого базы контактных данных устройства, календаря или списка дел. Помимо обозревателя PIM необходимо также использовать три других компонента: заставку, текстовое поле и предупреждение. | |
| </P> | |
| <!--<p class="notes"><b>Примечание.</b> При использовании среды IDE NetBeans 6.8 воспользуйтесь учебным курсом <a href="../../68/javame/pimbrowser.html">Создание приложения по управлению личными данными в среде IDE NetBeans 6.8</a>.</p>--> | |
| <p><b>Содержание</b></p> | |
| <img src="../../../images_www/articles/69/netbeans-stamp-69-70-71.png" class="stamp" alt="Содержимое данной страницы применимо к среде IDE NetBeans 6.9 и более поздних версий" title="Содержимое данной страницы применимо к среде IDE NetBeans 6.9 и более поздних версий" > | |
| <ul class="class"> | |
| <li><a href="#sample-app">Установка и выполнение примера приложения</a></li> | |
| <li><a href="#create-app">Создание приложения с использованием особого компонента обозревателя PIM</a></li><div> | |
| <ul> | |
| <LI><A HREF="#create">Создание проекта PIMBrowserExample</A> </LI> | |
| <LI><A HREF="#add">Добавление пакетов и визуального мидлета в проект</A> </LI> | |
| <LI><A HREF="#addcomponent">Добавление компонентов в проект</A> </LI> | |
| <LI><A HREF="#addcommands">Добавление команд в проект</A> </LI> | |
| <LI><A HREF="#connect">Соединение компонентов для создания последовательности действий приложения</A> </LI> | |
| <LI><A HREF="#storage">Добавление контактов к базе контактных данных Wireless Toolkit</A></LI> | |
| <LI><A HREF="#run">Выполнение проекта</A> </LI> | |
| </ul></div> | |
| <li><a href="#javadoc-pim">Документация Javadoc для компонента обозревателя PIM</a></li> | |
| <li><a href="#see-also">Дополнительные сведения</a></li> | |
| </ul> | |
| <p><b>Для работы с этим учебным курсом требуется следующее программное обеспечение и ресурсы.</b></p> | |
| <table> | |
| <tbody> | |
| <tr> | |
| <th class="tblheader" scope="col">Программное обеспечение или ресурс</th> | |
| <th class="tblheader" scope="col">Требуемая версия</th> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"><a href="https://netbeans.org/downloads/index.html">Среда IDE NetBeans с Java ME</a></td> | |
| <td class="tbltd1">Версия 6.9 и более поздняя </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">Комплект для разработки приложений на языке Java</a> (JDK)</td> | |
| <td class="tbltd1">Версии 6 и 7 </td> | |
| </tr> | |
| </tbody> | |
| </table> | |
| <p>При отсутствии опыта разработки приложений для NetBeans Mobility перед продолжением работы необходимо ознакомиться с документом <A HREF="../../docs/javame/quickstart.html">Краткое руководство по NetBeans Java ME MIDP</A>.</p> | |
| <a name="sample-app"></a> | |
| <H2>Установка и выполнение примера приложения</H2> | |
| <P>Перед тем как приступить к учебному курсу, можно ознакомиться с окончательным результатом этой работы. | |
| </P> | |
| <P>Для установки приложения PIMBrowserExample выполните следующие действия:</P> | |
| <OL> | |
| <LI>Загрузите архив <A HREF="https://netbeans.org/projects/samples/downloads/download/Samples/Mobile/PIMBrowserExample.zip">PIMBrowserExample.zip</A>.</LI> | |
| <LI>Распакуйте файл.</LI> | |
| <LI>В среде IDE выберите <tt>Файл</tt> > <tt>Открыть проект</tt> и выполните обзор до папки с распакованными файлами проекта <tt>PIMBrowserExample</tt>.</li> | |
| <li>Нажмите кнопку "Открыть проект".<br> | |
| Окно "Проекты" должно выглядеть примерно так: </li> | |
| <p class="align-center"><img src="../../../images_www/articles/71/mobility/pimbrowser/pim-project.png" border=1 alt="Окно "Проекты" с примером обозревателя PIM"> </p> | |
| <LI>В окне "Проекты" щелкните правой кнопкой мыши узел проекта и выберите команду "Выполнить проект" (или нажмите клавишу F6). После запуска приложения откроется окно эмулятора, отображающее это приложение, которое выполняется в эмуляторе устройства по умолчанию. </LI> | |
| <LI>В окне эмулятора нажмите кнопку под элементом "Launch." <BR>В эмуляторе отображается компонент заставки, а затем обозреватель PIM, как показано на рисунке.</li> | |
| <p class="align-center"> <img src="../../../images_www/articles/71/mobility/pimbrowser/pim-emulator70.png" border=1 alt="Эмулятор комплекта для разработчика 3.0 с примером приложения "Обозреватель PIM""></p> | |
| <li>Нажмите верхнюю правую кнопку эмулятора для отображения пунктов меню, как показано ниже. | |
| <p class="align-center"> <img src="../../../images_www/articles/71/mobility/pimbrowser/pim-emulator70-menu.png" border=1 alt="Эмулятор комплекта для разработчика 3.0, отображающий пункты меню"></p></li> | |
| <LI>При выбранном пункте "Details" нажмите центральную кнопку на эмуляторе, чтобы отобразить подробные сведения о контактах. </li> | |
| <p class="align-center"><img src="../../../images_www/articles/71/mobility/pimbrowser/pim-emulator2-70.png" border=1 alt="Эмулятор WTK 2.5, отображающий пример приложения обозревателя PIM"></p> | |
| </OL> | |
| <UL> | |
| <LI>Перемещайте курсор вниз и вверх для перехода по доступным позициям. </LI> | |
| <LI>Для возврата к списку контактов нажмите кнопку "Back". </LI> | |
| <LI>Для закрытия приложения нажмите кнопку под элементом "Exit". </LI> | |
| </UL> | |
| <p class="align-center"><a href="#top">В начало</a></p> | |
| <a name="create-app"></a> | |
| <H2 >Создание приложения с использованием настраиваемого компонента обозревателя PIM</H2> | |
| <P>После ознакомления с обозревателем PIM вернемся к началу и создадим данное приложение. Для создания приложения необходимо выполнить указанные ниже действия. </P> | |
| <OL> | |
| <LI><A HREF="#create">Создать проект PIMBrowserExample</A> </LI> | |
| <LI><A HREF="#add">Добавить пакеты и визуальный мидлет в проект</A> </LI> | |
| <LI><A HREF="#addcomponent">Добавить компоненты в проект</A> </LI> | |
| <LI><A HREF="#addcommands">Добавить команды в проект</A> </LI> | |
| <LI><A HREF="#connect">Соединить компоненты для создания последовательности действий приложения</A> </LI> | |
| <LI><A HREF="#storage">Добавить контакты в базу контактных данных Wireless Toolkit</A></LI> | |
| <LI><A HREF="#run">Запустить проект</A>. </LI> | |
| </OL> | |
| <H3 ><A NAME="create"></A>Создание проекта PIMBrowserExample</H3> | |
| <OL> | |
| <LI>Выберите <tt>Файл</tt> > <tt>Создать проект (CTRL+SHIFT+N)</tt>. В разделе "Категории" выберите "Java ME". В разделе "Проекты" выберите "Приложение Mobile" и нажмите кнопку "Далее". </LI> | |
| <LI>В поле "Имя проекта" введите <CODE>PIMBrowserExample</CODE>. В поле "Project Location" укажите локальный каталог. Теперь мы будем называть этот каталог <tt>$PROJECTHOME</tt>. </LI> | |
| <LI>Снимите флажок с параметра "Create Hello MIDlet". Нажмите кнопку "Далее". </LI> | |
| <LI>Оставьте Java (TM) Platform Micro Edition SDK 3.0 в качестве выбранной платформы эмулятора. Нажмите кнопку "Далее". </LI> | |
| <LI>В области "Выбор дополнительных вариантов настройки" нажмите кнопку "Готово". </li> | |
| <p class="notes"><b>Примечание.</b> Папка проекта содержит все исходные файлы и метаданные проекта (например, сценарий Ant для этого проекта).</p> | |
| </OL> | |
| <H3 ><A NAME="add"></A>Добавление пакетов и визуального мидлета к проекту</H3> | |
| <OL> | |
| <LI>В представлении "Проект" выберите проект <CODE>PIMBrowserExample</CODE>, затем выберите <tt>Файл</tt> > <tt>"Создать файл" (CTRL+N)</tt>. В области "Категории" выберите "Java". В разделе "File Types" выберите "Java Package". Нажмите кнопку "Далее". </LI> | |
| <LI>В поле "Имя пакета" введите <CODE>pimbrowserexample</CODE>. Нажмите кнопку "Готово". | |
| </LI> | |
| <LI>В представлении "Проект" выберите пакет <CODE>pimbrowserexample</CODE>, затем выберите <tt>Файл</tt> > <tt>Создать файл (CTRL+N)</tt>. В разделе "Categories" выберите "MIDP". В разделе "File Types" выберите "Visual MIDlet". Нажмите кнопку "Далее". | |
| </LI> | |
| <LI>В полях "Имя мидлета" и "Имя класса MIDP" введите <CODE>PIMBrowserExample</CODE>. Нажмите кнопку "Готово". <br> Приложение отобразится в представлении "Поток операций" в Visual Mobile Designer. | |
| </LI> | |
| </OL> | |
| <H3><A NAME="addcomponent"></A>Добавление компонентов в проект </H3> | |
| <OL> | |
| <LI>В Flow Designer перетащите следующие компоненты с палитры компонентов. </LI> | |
| <UL> | |
| <li><tt>Заставка</tt></li> | |
| <li><tt>Предупреждение</tt></li> | |
| <li><tt>Обозреватель PIM</tt></li> | |
| </UL> | |
| <LI>Щелкните элемент <tt>splashScreen</tt> и в окне "Свойства" измените параметр <tt>Text</tt> со значения <tt>null</tt> на значение <tt>Пример обозревателя PIM</tt>. | |
| <LI>Щелкните элемент <tt>alert</tt> и в окне "Свойства" измените значение параметра <tt>String</tt> на <tt>Контакт выбран</tt>. | |
| </OL> | |
| <H3><A NAME="addcommands"></A>Добавление команд в проект</H3> | |
| <OL> | |
| <li>В приложении Flow Designer в разделе "Команды" на палитре компонентов выберите команду <tt>Команда выхода</tt>.</li> | |
| <li>Перетащите ее в компонент <tt>pimBrowser</tt>.</li> | |
| </OL> | |
| <H3><A NAME="connect">Соединение компонентов для создания последовательности действий приложения</A> </H3> | |
| <p>В приложении Flow Designer щелкните команду <tt>Запущено</tt> элемента "Мобильное устройство" и перетащите его в компонент <tt>splashScreen</tt>. Аналогичным образом соедините другие компоненты, как показано на следующем рисунке. </p> | |
| <p class="align-center"><img src="../../../images_www/articles/71/mobility/pimbrowser/pim-flow.png" border=1 alt="Flow Designer с компонентами, соединенными командными строками"></p> | |
| <H3><A NAME="storage"></A>Добавление контактов к базе контактных данных Wireless Toolkit</H3> | |
| <P> Скопируйте <A HREF="https://netbeans.org/files/documents/4/1613/SAMPLE.VCF">пример контакта </A>в папку <tt>javame-sdk</tt> в каталоге <tt>$JAVAME-SDKHOME/3.0/work/0/appdb/PIM/contacts/Contacts/</tt>.<br> | |
| По умолчанию в этой папке содержатся три следующих файла. | |
| <li> 1.vcf</li> | |
| <li> 2.vcf</li> | |
| <li>categories.txt</li> | |
| </P> | |
| <H3><A NAME="run"></A> Выполнение проекта</H3> | |
| <div> | |
| <p>Для запуска главного проекта нажмите клавишу F6 или выберите меню <tt>Выполнить</tt> > <tt>Выполнить главный проект</tt>.</p> | |
| </div> | |
| <p class="align-center"><a href="#top">В начало</a></p> | |
| <a name="javadoc-pim"></a> | |
| <H2>Документация Javadoc для компонента обозревателя PIM</H2> | |
| <P>Среда IDE NetBeans предоставляет документацию Javadoc интерфейса API для компонента <tt>PIMBrowser</tt>, а также для других компонентов, которые можно использовать в VMD. Для ознакомления с документацией Javadocs для компонента <tt>PIMBrowser</tt> выполните следующие действия. | |
| </P> | |
| <OL> | |
| <li>Поместите курсор на компонент <tt>PIMBrowser</tt> в исходном коде и нажмите сочетание клавиш CTRL+SPACE+ПРОБЕЛ (или выберите <tt>Исходный код</tt> > <tt>Показать документацию</tt>).<br> | |
| Документация Javadoc для данного элемента появится во всплывающем окне. </li> | |
| <li>Нажмите значок "Показать документацию во внешнем веб-обозревателе" (<img src="../../../images_www/articles/71/mobility/pimbrowser/show-doc-button.png" alt="Показать документацию во внешнем веб-обозревателе">) во всплывающем окне для просмотра подробной информации о компоненте <tt>PIMBrowser</tt> в вашем веб-обозревателе.</li> | |
| </OL> | |
| <p class="align-center"><a href="#top">В начало</a></p> | |
| <div class="feedback-box"><a href="/about/contact_form.html?to=6&subject=NetBeans%20Java%20ME%20Custom%20Component:%20PIM%20Browser">Мы ждем ваших отзывов</a></div> | |
| <br style="clear:both;" > | |
| <a name="see-also"></a> | |
| <H2>Дополнительные сведения</H2> | |
| <UL> | |
| <li><a href="smscomposer.html">Особые компоненты Visual Mobile Designer: создание приложения редактора сообщений SMS</a></li> | |
| <li><a href="loginscreen.html">Особые компоненты Visual Mobile Designer: создание мобильных экранов входа в систему</a></li> | |
| <li><a href="filebrowser.html">Особые компоненты Visual Mobile Designer: создание обозревателя файлов мобильных устройств</a></li> | |
| <li><a href="splashscreen.html">Особые компоненты Visual Mobile Designer: использование экранов заставок в приложениях Java ME</a></li> | |
| <li><a href="waitscreen.html">Особые компоненты Visual Mobile Designer: создание экранов ожидания для мобильных приложений</a></li> | |
| <li><a href="tableitem.html">Особые компоненты Visual Mobile Designer: использование элементов таблицы в приложениях Java ME</a></li> | |
| <li><a href="http://wiki.netbeans.org/VisualMobileDesignerPalatteReference">Справочная информация: руководство по компонентам Palette в Visual Mobile Designer</a></li> | |
| </UL> | |
| <p class="align-center"><a href="#top">В начало</a></p> | |
| </BODY> | |
| </HTML> |