netbeans.apache.org/src/old_content/content/tutorials/61/nbm-htmleditor_ru.adoc

// 
//     Licensed to the Apache Software Foundation (ASF) under one
//     or more contributor license agreements.  See the NOTICE file
//     distributed with this work for additional information
//     regarding copyright ownership.  The ASF licenses this file
//     to you under the Apache License, Version 2.0 (the
//     "License"); you may not use this file except in compliance
//     with the License.  You may obtain a copy of the License at
// 
//       http://www.apache.org/licenses/LICENSE-2.0
// 
//     Unless required by applicable law or agreed to in writing,
//     software distributed under the License is distributed on an
//     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
//     KIND, either express or implied.  See the License for the
//     specific language governing permissions and limitations
//     under the License.
//

= Руководство по началу работы с платформой NetBeans
:jbake-type: platform_tutorial
:jbake-tags: tutorials 
:jbake-status: published
:syntax: true
:source-highlighter: pygments
:toc: left
:toc-title:
:icons: font
:experimental:
:description: Руководство по началу работы с платформой NetBeans - Apache NetBeans
:keywords: Apache NetBeans Platform, Platform Tutorials, Руководство по началу работы с платформой NetBeans

Добро пожаловать в среду NetBeans!

В этом документе представлена процедура быстрого знакомства с работой в среде NetBeans на примере создания простого редактора HTML. Несмотря на свою простоту, создаваемый редактор HTML будет очень функциональным, поскольку в нем будет использована инфраструктура, предоставляемая платформой NetBeans. Например, этот редактор HTML будет иметь развитую оконную систему, для создания которой не потребуется написание какого-либо кода. После изучения этого руководства читатель получит общее представление о создании, сборке и выполнении приложений на базе платформы NetBeans.

После изучения этого руководства можно перейти к другой  link:https://netbeans.apache.org/kb/docs/platform.html[ учебной карте по платформе NetBeans]. Учебная карта содержит подробные руководства, в которых рассматривается широкий спектр интерфейсов API среды NetBeans для разнообразных приложений. Если процедура создания простейшего приложения "Hello World" читателю уже знакома, можно пропустить этот документ и перейти сразу к учебной карте.







Дополнительно, в целях поиска и устранения ошибок, можно  link:http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=6635[загрузить готовые примеры] и изучить исходный код.

По завершении изучения этого руководства будет создан редактор HTML, который выглядит следующим образом:


image::images/htmleditor_html_editor_final-61.png[]

NOTE:  Это очень простое демонстрационное приложение, но вовсе не игрушка! Это _настоящая_ программа, поддерживающая простое редактирование страниц HTML, с такими возможностями, как автозавершение кода, проверка допустимости и предварительно определенные фрагменты HTML.

Создаваемый в этом руководстве редактор HTML является функционально насыщенным клиентским приложением на базе платформы NetBeans. Это означает, что основой этого приложения будет ядро среды IDE, которым и _[.underline]#является#_ платформа NetBeans. Поверх платформы NetBeans добавляются необходимые модули и исключаются те, которые нужны для среды IDE, но не требуются для данного приложения. Здесь показаны некоторые из модулей среды IDE, добавленных к платформе NetBeans, которые являются ее основой:


image::images/htmleditor_diagram.png[]

Создание этого редактора HTML подразумевает создание скелета приложения, исключение ненужных модулей и элементов интерфейса пользователя, а затем настройку окна "Favorites", которое должно открываться по умолчанию при запуске среды IDE. Все эти действия поддерживаются элементами интерфейса пользователя в среде IDE.

Пользователь сможет лично убедиться в том, как легко и просто сформировать или, точнее, _собрать_ полнофункциональное приложение на платформе NetBeans. В конце этого документа показано, как с помощью ускоренной установки по сети сделать конечный продукт легко загружаемым и запускаемым.

NOTE:  Несмотря на то, что это приложение является отдельной программой, для целей этого руководства не требуется загружать платформу NetBeans отдельно. Функционально насыщенное клиентское приложение будет разработано в среде IDE, и затем из него будут исключены модули, необходимые для IDE, но не требуемые этим приложением.


== Создание скелета приложения

При создании приложения на базе платформы NetBeans самым первым действием должно стать создание проекта приложения на платформе NetBeans. По умолчанию проект приложения платформы NetBeans имеет в своем составе _все_ модули в составе платформы NetBeans, а также _все_ модули, входящие в среду IDE NetBeans. Поскольку некоторые из этих модулей нам не требуются, их следует исключить.


[start=1]
1. С помощью мастера создания проекта (Ctrl-Shift-N) создайте проект приложения на платформе NetBeans из шаблона в категории "NetBeans Modules", как показано ниже:


image::images/htmleditor_netbeans-platform-app-1.png[]

Нажмите кнопку "Next" и присвойте проекту приложения на платформе NetBeans имя "NetBeansHTMLEditor". Нажмите кнопку "Finish".


[start=2]
1. Щелкните правой кнопкой мыши узел проекта, выберите "Properties" и затем внесите некоторые изменения в диалоговом окне "Project Properties" приложения.

* На экране "Build" выберите "Create Standalone Application", чтобы указать, что это будет функционально насыщенное клиентское приложение на платформе NetBeans.

Убедитесь, что используется подходящее название исполняемого файла, и определите текст, который будет выводиться в строке заголовка приложения, как показано ниже:


image::images/htmleditor_application_panel-61.png[]

* На экране "Splash Screen" обратите внимание на то, что можно установить заставку приложения и индикатор хода выполнения, как показано ниже:


image::images/htmleditor_splash_screen_panel-61.png[]

NOTE:  При отсутствии собственной заставки используйте  link:images/htmleditor_splash.gif[эту].

* На экране "Libraries" диалогового окна "Project Properties" имеется список кластеров. Кластер представляет собой ряд связанных модулей. Следует выбрать только кластеры  ``gsf1`` ,  ``ide9``  и  ``platform8`` . Отмените выбор всех других кластеров. Теперь необходимо подключить и отключить ряд модулей, так как выбраны должны быть только те модули, которые относятся непосредственно к нашему редактору HTML. Каждый раз при выборе или отмене выбора модуля на экране "Libraries" в файл настройки платформы NetBeans данного приложения добавляется запись. Для ускорения этого процесса мы просто вставим записи в данный файл. Закройте диалоговое окно "Project Properties".

Разверните узел "Important Files" и затем откройте файл настройки платформы NetBeans. Вставьте следующие записи:


[source,java]
----

disabled.clusters=\
    apisupport1,\
    harness,\
    java2,\
    nb6.1,\
    profiler3
disabled.modules=\
    org.mozilla.rhino.patched,\
    org.netbeans.api.debugger,\
    org.netbeans.api.visual,\
    org.netbeans.core.ide,\
    org.netbeans.core.multiview,\
    org.netbeans.core.nativeaccess,\
    org.netbeans.insane,\
    org.netbeans.lib.cvsclient,\
    org.netbeans.libs.commons_logging,\
    org.netbeans.libs.ini4j,\
    org.netbeans.libs.jna,\
    org.netbeans.libs.svnClientAdapter,\
    org.netbeans.libs.xerces,\
    org.netbeans.modules.autoupdate.services,\
    org.netbeans.modules.autoupdate.ui,\
    org.netbeans.modules.classfile,\
    org.netbeans.modules.core.kit,\
    org.netbeans.modules.css.editor,\
    org.netbeans.modules.css.visual,\
    org.netbeans.modules.db,\
    org.netbeans.modules.db.core,\
    org.netbeans.modules.db.drivers,\
    org.netbeans.modules.db.kit,\
    org.netbeans.modules.db.mysql,\
    org.netbeans.modules.db.sql.editor,\
    org.netbeans.modules.db.sql.visualeditor,\
    org.netbeans.modules.dbapi,\
    org.netbeans.modules.editor.bookmarks,\
    org.netbeans.modules.editor.kit,\
    org.netbeans.modules.extbrowser,\
    org.netbeans.modules.gototest,\
    org.netbeans.modules.httpserver,\
    org.netbeans.modules.ide.kit,\
    org.netbeans.modules.javascript.editing,\
    org.netbeans.modules.javascript.hints,\
    org.netbeans.modules.javascript.kit,\
    org.netbeans.modules.javascript.refactoring,\
    org.netbeans.modules.languages,\
    org.netbeans.modules.languages.bat,\
    org.netbeans.modules.languages.diff,\
    org.netbeans.modules.languages.manifest,\
    org.netbeans.modules.languages.sh,\
    org.netbeans.modules.localhistory,\
    org.netbeans.modules.mercurial,\
    org.netbeans.modules.project.ant,\
    org.netbeans.modules.project.libraries,\
    org.netbeans.modules.properties,\
    org.netbeans.modules.properties.syntax,\
    org.netbeans.modules.schema2beans,\
    org.netbeans.modules.sendopts,\
    org.netbeans.modules.server,\
    org.netbeans.modules.servletapi,\
    org.netbeans.modules.subversion,\
    org.netbeans.modules.tasklist.kit,\
    org.netbeans.modules.tasklist.projectint,\
    org.netbeans.modules.tasklist.todo,\
    org.netbeans.modules.tasklist.ui,\
    org.netbeans.modules.timers,\
    org.netbeans.modules.usersguide,\
    org.netbeans.modules.utilities,\
    org.netbeans.modules.utilities.project,\
    org.netbeans.modules.versioning,\
    org.netbeans.modules.versioning.system.cvss,\
    org.netbeans.modules.versioning.util,\
    org.netbeans.modules.web.flyingsaucer,\
    org.netbeans.modules.xml,\
    org.netbeans.modules.xml.axi,\
    org.netbeans.modules.xml.core,\
    org.netbeans.modules.xml.lexer,\
    org.netbeans.modules.xml.multiview,\
    org.netbeans.modules.xml.retriever,\
    org.netbeans.modules.xml.schema.completion,\
    org.netbeans.modules.xml.schema.model,\
    org.netbeans.modules.xml.tax,\
    org.netbeans.modules.xml.text,\
    org.netbeans.modules.xml.tools,\
    org.netbeans.modules.xml.wsdl.model,\
    org.netbeans.modules.xml.xam,\
    org.netbeans.modules.xml.xdm,\
    org.netbeans.modules.xsl,\
    org.netbeans.spi.debugger.ui,\
    org.netbeans.spi.viewmodel,\
    org.netbeans.swing.dirchooser,\
    org.openide.compat,\
    org.openide.util.enumerations
enabled.clusters=\
    gsf1,\
    ide9,\
    platform8
nbplatform.active=default
----

Теперь имеется подмножество модулей NetBeans, которые соответствуют нашему редактору HTML. Однако несмотря на то, что все оставшиеся модули действительно необходимы, скорее всего нам не потребуются связанные с ними элементы интерфейса пользователя. В следующих разделах мы настроим интерфейс пользователя и размещение элементов окна специально для создаваемого редактора HTML.


== Настройка интерфейса пользователя

В интерфейсе пользователя можно оставить столько функций, сколько позволяют выбранные модули. Например, в редакторе HTML возможно, не будут использоваться какие-либо пункты меню "Tools". Также весьма вероятно, что имеются панели инструментов или кнопки на панелях инструментов, без которых можно обойтись. В этом разделе мы будем настраивать интерфейс пользователя среды IDE до тех пор, пока не останемся с набором функций, полностью отвечающим требованиям функционально насыщенного клиентского приложения.


[start=1]
1. Разверните проект приложения на платформе NetBeans, щелкните правой кнопкой мыши узел "Modules" и выберите "Add New", как показано ниже:


image::images/htmleditor_add-module-61.png[]

Появится мастер создания проекта (Ctrl-Shift-N). Присвойте проекту имя  ``BrandingModule``  и нажмите кнопку "Next".


[start=2]
1. В поле "Code Name Base" введите  ``org.netbeans.brandingmodule`` .

[start=3]
1. В поле "XML Layer" введите имя пакета с окончанием "layer.xml", например, "org/netbeans/brandingmodule/layer.xml", а затем нажмите кнопку "Finish".

NOTE:  Если не ввести в это поле путь к файлу "layer.xml", файл создан не будет. В этом случае в основном пакете следует создать файл с именем "layer.xml" и затем вручную зарегистрировать его в файле манифеста модуля следующим образом:


[source,java]
----

OpenIDE-Module-Layer: org/netbeans/brandingmodule/layer.xml
----


[start=4]
1. В модуле "Branding" разверните узел  ``layer.xml`` . Появятся два подузла:


image::images/htmleditor_expanded-xml-layer-61.png[]

NOTE:  Если файл layer.xml был добавлен вручную, необходимо развернуть узел "Important Files" и затем развернуть находящийся в нем узел "layer.xml".


[start=5]
1. В узле  ``<this layer in context>``  представлены все папки и файлы, зарегистрированные всеми модулями на своих уровнях. Для исключения отдельных элементов щелкните их правой кнопкой мыши и выберите "Delete", как показано ниже:


image::images/htmleditor_this-layer-in-context-61.png[]

Затем среда IDE добавит теги к файлу  ``layer.xml``  модуля, который после установки модуля скроет удаленные элементы. Например, щелкнув правой кнопкой мыши  ``Menu Bar/Edit`` , можно удалить ненужные для редактора HTML пункты из меню "Edit". В результате в файле  ``layer.xml``  будут созданы, например, следующие фрагменты:


[source,xml]
----

<folder name="Menu">
    <folder name="Edit">
        <file name="org-netbeans-modules-editor-MainMenuAction$StartMacroRecordingAction.instance_hidden"/>
        <file name="org-netbeans-modules-editor-MainMenuAction$StopMacroRecordingAction.instance_hidden"/>
    </folder>       
</folder>
----

Результатом приведенного выше фрагмента является то, что функции  ``Start Macro Recording``  и  ``Stop Macro Recording`` , обеспечиваемые другим модулем, будут удалены из меню модулем "Branding". Чтобы снова вывести их на экран, просто удалите вышеперечисленные теги из файла  ``layer.xml`` .


[start=6]
1. С помощью вышеописанного метода скройте необходимое количество панелей инструментов, кнопок панели инструментов, меню и пунктов меню.

По завершении загляните в файл  ``layer.xml`` . Общий вид должен соответствовать приведенному ниже, в зависимости от удаленных элементов:


[source,xml]
----

<?xml version="1.0" encoding="UTF-8"? >
<!DOCTYPE filesystem PUBLIC "-//NetBeans//DTD Filesystem 1.1//EN" "https://netbeans.org/dtds/filesystem-1_1.dtd">
<filesystem>
    <folder name="Menu">
        <file name="BuildProject_hidden"/>
        <folder name="File">
            <file name="Separator2.instance_hidden"/>
            <file name="SeparatorNew.instance_hidden"/>
            <file name="SeparatorOpen.instance_hidden"/>
            <file name="org-netbeans-modules-project-ui-CloseProject.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-CustomizeProject.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-NewFile.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-NewProject.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-OpenProject.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-RecentProjects.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-SetMainProject.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-groups-GroupsMenu.shadow_hidden"/>
        </folder>
        <file name="Refactoring_hidden"/>
        <file name="RunProject_hidden"/>
        <folder name="Window">
            <file name="ViewRuntimeTabAction.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-logical-tab-action.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-physical-tab-action.shadow_hidden"/>
        </folder>
    </folder>
</filesystem>
----


== Настройка размещения элементов в окне

С помощью узла  ``<this layer in context>``  можно не только удалять существующие элементы, но и изменять их содержимое. Например, этот редактор HTML работает с файлами HTML, поэтому в отличие от стандартной среды IDE, которая работает и с исходными файлами, и с проектами Java, здесь в исходной схеме размещения целесообразно отображать окно  ``Favorites`` .

Схема размещения элементов окна также описывается в виде файлов на уровнях, хранящихся в папке  ``Windows2`` . Файлы в папке  ``Windows2``  представляют собой "псевдочитаемые" файлы XML, определяемые  link:http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/doc-files/api.html[ интерфейсами API для системы окон]. Они довольно сложны для понимания, однако для целей нашего редактора HTML не обязательно изучать их полностью (см. ниже).


[start=1]
1. В узле  ``<this layer in context>``  модуля "Branding" щелкните узел  ``Windows2``  правой кнопкой мыши и выберите "Find", как показано ниже:


image::images/htmleditor_find-favorites-61.png[]


[start=2]
1. Выполните поиск объекта с именем  ``Favorites`` , без учета регистра. Будет найдено два файла:


image::images/htmleditor_find-favorites2-61.png[]

Первый файл определяет, как будет выглядеть элемент и как он создается. Поскольку эти параметры изменять не нужно, вносить изменения в файл не требуется. Второй файл более интересен для наших целей, так как он содержит следующее:


[source,xml]
----


<tc-ref version="2.0">
    <module name="org.netbeans.modules.favorites/1" spec="1.1" />
    <tc-id id="favorites" />
    <state opened="false" />
</tc-ref>
----


[start=3]
1. Несмотря на то, что большая часть языка XML представляется непонятной, по крайней мере одна строка выглядит многообещающе – даже без чтения какой-либо документации очевидно, что путем замены  ``false``  на  ``true``  можно сделать этот элемент открывающимся по умолчанию. Попробуйте!

[start=4]
1. Аналогичным образом можно изменить состояние открытия по умолчанию на поведение, которое должно быть реализовано в редакторе HTML, для следующих окон:
*  ``CommonPalette.wstcref`` . Состояние открытия окна "Component Palette" –  ``false`` . Измените его на  ``true`` .
*  ``navigatorTC.wstcref`` . Состояние открытия окна "Navigator" –  ``true`` . Измените его на  ``false`` .
*  ``projectTabLogical_tc.wstcref`` . Состояние открытия окна "Projects" –  ``true`` . Измените его на  ``false`` .
*  ``projectTab_tc.wstcref`` . Состояние открытия окна "Files" –  ``true`` . Измените его на  ``false`` .
*  ``runtime.wstcref`` . Состояние открытия окна "Services" –  ``true`` . Измените его на  ``false`` .

Теперь модуль "Branding" должен содержать несколько новых файлов, по одному для каждого из измененных файлов. Фактически эти файлы заменяют собой те, что были найдены на предыдущих этапах, и теперь мы владеем необходимой информацией для изменения схемы размещения элементов окна:


image::images/htmleditor_wstcrefs-overridden-61.png[]

Проверьте, что в файле  ``layer.xml``  теперь имеются нижеприведенные строки. В противном случае скопируйте их и вставьте в файл  ``layer.xml`` .


[source,xml]
----

<?xml version="1.0" encoding="UTF-8"? >
<!DOCTYPE filesystem PUBLIC "-//NetBeans//DTD Filesystem 1.1//EN" "https://netbeans.org/dtds/filesystem-1_1.dtd">
<filesystem>
    <folder name="Menu">
        <file name="BuildProject_hidden"/>
        <folder name="File">
            <file name="Separator2.instance_hidden"/>
            <file name="SeparatorNew.instance_hidden"/>
            <file name="SeparatorOpen.instance_hidden"/>
            <file name="org-netbeans-modules-project-ui-CloseProject.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-CustomizeProject.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-NewFile.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-NewProject.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-OpenProject.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-RecentProjects.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-SetMainProject.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-groups-GroupsMenu.shadow_hidden"/>
        </folder>
        <file name="Refactoring_hidden"/>
        <file name="RunProject_hidden"/>
        <folder name="Window">
            <file name="ViewRuntimeTabAction.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-logical-tab-action.shadow_hidden"/>
            <file name="org-netbeans-modules-project-ui-physical-tab-action.shadow_hidden"/>
        </folder>
    </folder>
    <folder name="Windows2">
        <folder name="Modes">
            <folder name="commonpalette">
                <file name="CommonPalette.wstcref" url="CommonPaletteWstcref.xml"/>
            </folder>
            <folder name="explorer">
                <file name="favorites.wstcref" url="favoritesWstcref.xml"/>
                <file name="projectTabLogical_tc.wstcref" url="projectTabLogical_tcWstcref.xml"/>
                <file name="projectTab_tc.wstcref" url="projectTab_tcWstcref.xml"/>
                <file name="runtime.wstcref" url="runtimeWstcref.xml"/>
            </folder>
            <folder name="navigator">
                <file name="navigatorTC.wstcref" url="navigatorTCWstcref.xml"/>
            </folder>
        </folder>
    </folder>
</filesystem>
----


== Настройка окна "Favorites"

В подпапках папки  ``branding``  проекта приложения на платформе NetBeans, отображенных в окне "Files", можно заменить строки, определенные в исходных файлах NetBeans. В этом разделе будут заменены те строки, которые описывают метки, используемые в окне "Favorites". Например, мы изменим текст "Favorites" на "HTML Files", поскольку это окно предназначено именно для файлов HTML.


[start=1]
1. Откройте окно "Files" и разверните папку  ``branding``  проекта приложения на платформе NetBeans.

[start=2]
1. Создайте новую структуру папок в  ``branding/modules`` . Новой папке должно быть присвоено имя  ``org-netbeans-modules-favorites.jar`` . Внутри этой папки создайте иерархию папок  ``org/netbeans/modules/favorites`` . В последней папке, т.е.  ``favorites`` , создайте новый файл  ``Bundle.properties`` .


image::images/htmleditor_favorites-branding-61a.png[]

Эта структура папок и файл свойств соответствуют структуре в исходных файлах NetBeans, которая связана с окном "Favorites".


[start=3]
1. Добавьте строки, показанные ниже на рисунке, для замены таких же строк, определенных в соответствующем файле свойств в исходных файлах окна "Favorites":


image::images/htmleditor_favorites-branding-61b.png[]

Для упрощения этой задачи скопируйте вышеуказанные строки и вставьте их:


[source,java]
----

Favorites=HTML Files
ACT_AddOnFavoritesNode=&amp;Find HTML Files...
ACT_Remove=&amp;Remove from HTML Files List
ACT_View=HTML Files
ACT_Select=HTML Files
ACT_Select_Main_Menu=Select in HTML Files List

# JFileChooser
CTL_DialogTitle=Add to HTML Files List
CTL_ApproveButtonText=Add
ERR_FileDoesNotExist={0} does not exist.
ERR_FileDoesNotExistDlgTitle=Add to HTML Files List
MSG_NodeNotFound=The document node could not be found in the HTML Files List.
----


== Выполнение приложения

Выполнить наше приложение совсем не сложно – следует просто щелкнуть узел проекта правой кнопкой мыши и выбрать требуемый пункт меню.


[start=1]
1. Щелкните узел проекта приложения правой кнопкой мыши и выберите "Clean and Build All".

[start=2]
1. Щелкните узел проекта приложения правой кнопкой мыши и выберите "Run".

[start=3]
1. После развертывания приложения можно щелкнуть правой кнопкой мыши в окне "Favorites" и выбрать папку, содержащую файлы HTML, а затем открыть файл HTML, как показано ниже:


image::images/htmleditor_html_editor_final-61.png[]


== Подготовка дистрибутива приложения

Выберите один из двух способов распространения приложения. Если необходимо поддерживать максимально возможный контроль над приложением, то для его распространения следует выбрать способ установки по сети. В этом случае каждый раз, когда требуется обновить приложение, это осуществляется локально, а конечные пользователи извещаются об обновлении, которое они будут получать автоматически при следующем запуске приложения через сеть. В качестве дистрибутива также может использоваться файл ZIP, содержащий данное приложение. Тогда все приложение будет доступно конечным пользователям локально. В этом случае обновления и новые компоненты будут распространяться через механизм обновления, описанный ниже.


=== Распространение приложения через файл ZIP

Для обеспечения расширяемости приложения следует предусмотреть возможность установки пользователями модулей для расширения функциональных возможностей приложения. Для этого необходимо просто включить несколько дополнительных модулей, которые свяжут диспетчер подключаемых модулей с редактором HTML.


[start=1]
1. Щелкните правой кнопкой мыши проект приложения платформы NetBeans и выберите "Properties". В диалоговом окне "Project Properties" перейдите на экран "Libraries" и установите флажки  ``Update Centers`` ,  ``Auto Update Services``  и  ``Auto Update UI`` , выделенные ниже:


image::images/htmleditor_auto-update-61.png[]


[start=2]
1. Щелкните узел проекта приложения правой кнопкой мыши и выберите "Clean and Build All".

[start=3]
1. Снова запустите приложение и обратите внимание на появление в меню "Tools" нового пункта меню под названием "Plugins":


image::images/htmleditor_auto-update2-61.png[]

[start=4]
1. Выберите новый пункт меню "Plugins" и установите некоторые подключаемые модули, которые будет удобно использовать в редакторе HTML. Просмотрите материалы на  link:http://plugins.netbeans.org/PluginPortal/[ Plugin Portal ] и найдите несколько подходящих модулей. Конечные пользователи будут обновлять свою локальную установку приложения таким же способом.

[start=5]
1. 
Щелкните правой кнопкой мыши узел проекта приложения и выберите "Build ZIP Distribution".


[start=6]
1. Теперь в папке  ``dist``  (в окне "Files") должен отобразиться файл ZIP, который можно развернуть для просмотра его содержимого:


image::images/htmleditor_unzipped-app-61.png[]

NOTE:  Средство запуска приложения создается в папке  ``bin`` , как показано выше.


=== Распространение редактора HTML через общедоступное хранилище для установки NetBeans по сети

Теперь вместо распространения файла ZIP подготовимся к распространению через быструю установку по сети путем точной настройки файла  ``master.jnlp`` , создаваемого при первом запуске приложения. Даже в том случае, если оно работает, оно еще не готово к распространению. Следует как минимум изменить информационную часть с целью усовершенствования описаний и значков.

Еще одно изменение стандартной инфраструктуры приложения на базе JNLP касается использования общедоступного хранилища JNLP на сайте www.netbeans.org. По умолчанию приложение на базе JNLP, создаваемое для программного пакета, всегда содержит все его модули, а также все модули, от которых оно зависит. Это может быть удобно для использования во внутренней сети, но для широкого распространения в Интернете это менее практично. В случае Интернета намного удобнее, когда все приложения, создаваемые на базе платформы NetBeans, обращаются к одному хранилищу модулей NetBeans, т.к. это подразумевает, что такие модули используются совместно и не должны загружаться несколько раз.

Такое хранилище существует и для среды NetBeans 6.1. Оно содержит не все имеющиеся в среде IDE NetBeans модули, но достаточное их количество для поддержания работы приложений, не входящих в среду IDE, таких как наш редактор HTML. Для использования этого хранилища необходимо только изменить  ``platform.properties``  путем добавления правильного URL-адреса:


[source,java]
----


# share the libraries from common repository on netbeans.org
# this URL is for release60 JNLP files:
jnlp.platform.codebase=https://netbeans.org/download/6_0/jnlp/

----

Как только приложение будет запущено как приложение на базе JNLP, все его совместно используемые подключаемые модули будут загружены с netbeans.org и будут использоваться вместе с другими аналогичными приложениями.

link:http://netbeans.apache.org/community/mailing-lists.html[Мы ждем ваших отзывов]


== Дополнительная информация

Руководство по началу работы с платформой NetBeans завершено. В этом документе была рассмотрена процедура создания подключаемого модуля, добавляющего панель поиска Google к среде IDE. Для получения дополнительных сведений о создании и разработке приложений на платформе NetBeans см. следующие материалы:

*  link:https://netbeans.apache.org/kb/docs/platform.html[Другие связанные руководства]

*  link:https://bits.netbeans.org/dev/javadoc/[Документация Javadoc по интерфейсам API в среде NetBeans]