mirror of
https://gitee.com/jmix/cuba.git
synced 2024-12-03 19:57:36 +08:00
1) Исправлена глава Установка CUBA Studio: исправлена ссылка на дистрибутив Студии, удалена информация о логине и пароле доступа к репозиторию.
2) Убрана информация по AccessControl 3) Изменения в соответствии с тикетом https://youtrack.haulmont.com/issue/PL-2013
This commit is contained in:
Mariya Sukhova
parent
55a8d12677
commit
9e8aa15036
@ -8279,13 +8279,15 @@ protected boolean postCommit(boolean committed, boolean close) {
|
||||
<warning>
|
||||
<para>Обязательными вложенными элементами являются элементы <sgmltag>columns</sgmltag> и <sgmltag>rows</sgmltag>. </para>
|
||||
</warning>
|
||||
<para id="gui_attr_grid_rows"><sgmltag>rows</sgmltag> − обязательный элемент, содержит последовательность строк (<sgmltag>row</sgmltag>). Хотя бы один элемент строки является обязательным.</para>
|
||||
<para id="gui_attr_grid_row"><sgmltag>row</sgmltag> − элемент строки, контейнер для содержимого ряда. Состоит из контейнеров или компонентов.</para>
|
||||
<para id="gui_attr_grid_row_flex"><sgmltag>flex</sgmltag> − необязательный атрибут для элемента <sgmltag>row</sgmltag>, задает соотношение высот рядов сетки.</para>
|
||||
<para id="gui_attr_grid_columns"><sgmltag>columns</sgmltag> − обязательный элемент, содержит последовательность <sgmltag>column</sgmltag>.</para>
|
||||
<para id="gui_attr_grid_columns"><sgmltag>columns</sgmltag> − обязательный элемент, содержит последовательность колонок <sgmltag>column</sgmltag>.</para>
|
||||
<para id="gui_attr_grid_count">Атрибут <sgmltag>count</sgmltag> − необязательный атрибут, задает количество колонок, если не заданы элементы <sgmltag>column</sgmltag>.</para>
|
||||
<para id="gui_attr_grid_column"><sgmltag>column</sgmltag> − необязательный элемент для элемента <link linkend="gui_attr_grid_columns">columns</link>, декларирует атрибуты колонок сетки.</para>
|
||||
<para id="gui_attr_grid_column_flex">Атрибут <sgmltag>flex</sgmltag> − необязательный атрибут, задает соотношение ширин колонок.</para>
|
||||
<para>Для того чтобы определить ширину колонок друг относительно друга, необходимо чтобы для контейнера <sgmltag>grid</sgmltag> была установлена ширина (атрибут <link linkend="gui_attr_basic_width">width</link>). Для каждого элемента <link linkend="gui_attr_grid_column">column</link> следует установить требуемое значение атрибута <sgmltag>flex</sgmltag>. Например, в примере, находящемся ниже, ширина колонок сетки определяется соотношением 3:0:1:0. Колонкам 2 и 4 устанавливаются ширины, равные ширинам содержащихся в них компонентов; оставшаяся часть делится в пропорции 3 к 1 (это ширины колонок 1 и 3). Таким образом, ширина колонки, для которой задан атрибут <sgmltag>flex</sgmltag> со значением <literal>0</literal>, равна ширине компонента, содержащегося в данной колонке. Отсутствие атрибута <sgmltag>flex</sgmltag> у элемента <link linkend="gui_attr_grid_column">column</link> приравнивается значению <code>flex="0"</code>.</para>
|
||||
<programlisting><xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="source/section_gui/grid/grid_flex.txt" encoding="UTF-8" parse="text"/></programlisting>
|
||||
<para id="gui_attr_grid_rows"><sgmltag>rows</sgmltag> − обязательный элемент, содержит последовательность строк (<sgmltag>row</sgmltag>). Хотя бы один элемент строки является обязательным.</para>
|
||||
<para id="gui_attr_grid_row"><sgmltag>row</sgmltag> − элемент строки, контейнер для содержимого ряда. Состоит из контейнеров или компонентов.</para>
|
||||
<para id="gui_attr_grid_row_flex"><sgmltag>flex</sgmltag> − необязательный атрибут для элемента <sgmltag>row</sgmltag>, задает соотношение высот рядов сетки. Аналогичен атрибуту <link linkend="gui_attr_grid_column_flex">flex</link> для элемента <link linkend="gui_attr_grid_column">column</link>.</para>
|
||||
<para>Атрибуты <sgmltag>grid</sgmltag>:</para>
|
||||
<informaltable frame="none" pgwide="0" align="left">
|
||||
<tgroup cols="4" colsep="1" rowsep="1" align="left"><colspec colname="c1"/><colspec colname="c2"/><colspec colname="c3"/><colspec colname="c4"/>c <tbody>
|
||||
@ -8651,46 +8653,6 @@ protected boolean postCommit(boolean committed, boolean close) {
|
||||
</section>
|
||||
<section>
|
||||
<title>Разное</title>
|
||||
<section>
|
||||
<title>AccessControl</title>
|
||||
<para>Компонент <sgmltag>accessControl</sgmltag> предназначен для декларативного управления доступом к частям экрана. Он представляет собой контейнер, который никак не отображает себя на экране, а только управляет атрибутами <link linkend="gui_attr_basic_visible">visible</link> и <link linkend="gui_attr_basic_editable">editable</link> входящих в него компонентов.</para>
|
||||
<para>Состояние управляемых компонентов определяется на основе двух элементов, вложенных в <sgmltag>accessControl</sgmltag>: <sgmltag>visible</sgmltag> и <sgmltag>editable</sgmltag>.</para>
|
||||
<para>Соответствующее значение принимается либо из скрипта, возвращающего <code>boolean</code>, либо из свойства объекта <link linkend="AccessData">AccessData</link>, связанного с компонентом.
|
||||
Скрипт задается либо атрибутом <sgmltag>script</sgmltag>, либо непосредственно в тексте элемента.
|
||||
Свойство объекта <link linkend="AccessData">AccessData</link> задается атрибутом <sgmltag>property</sgmltag> и имеет больший приоритет, чем скрипт.</para>
|
||||
<warning>
|
||||
<para>В случае <sgmltag>visible</sgmltag>=<literal>false</literal> вложенные компоненты вообще не создаются, поэтому будьте осторожны при обращении к ним из контроллера.</para>
|
||||
</warning>
|
||||
<para>
|
||||
<programlisting><tab id="mainTab" caption="msg://mainTab">
|
||||
<accessControl data="workflow.client.web.ui.card.CardAccessData" param="accessData">
|
||||
<editable property="notStarted"/>
|
||||
|
||||
<vbox margin="true" expand="attachmentsPane">
|
||||
...</programlisting>
|
||||
</para>
|
||||
<section id="AccessData">
|
||||
<title>Объект AccessData</title>
|
||||
<para>В связи с тем что одни и те же параметры доступа могут многократно потребоваться в разных частях экрана и в коде контроллера, компонент <sgmltag>accessControl</sgmltag> может быть связан с объектом Java или Groovy, вычисляющим и хранящим эти параметры. Таким образом, дорогостоящая инициализация параметра доступа производится только один раз и затем доступна на протяжении жизни экрана.</para>
|
||||
<para>Для связи компонента с данными доступа создайте класс, унаследованный от <code>AbstractAccessData</code>, и задайте следующие атрибуты компонента <code>accessControl</code>:</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><emphasis role="bold">data</emphasis> − имя класса <code>AccessData</code></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><emphasis role="bold">param</emphasis> − имя параметра экрана, в котором будет сохранен объект <code>AccessData</code></para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
<para>В момент создания экрана загрузчик компонента <code>accessControl</code> проверяет наличие экземпляра <code>AccessData</code> в указанном параметре, и если его там нет, создает новый экземпляр.</para>
|
||||
<para>В дальнейшем в коде контроллера можно получить экземпляр <code>AccessData</code> из параметров экрана, например:</para>
|
||||
<programlisting>AbstractWfAccessData accessData = getContext().getParamValue("accessData");</programlisting>
|
||||
<para>При создании класса <code>AccessData</code> следует иметь в виду, что в параметры экрана-редактора всегда передается параметр <parameter>param$item</parameter>, содержащий текущий редактируемый экземпляр сущности. Однако этот экземпляр загружен по <link linkend="views">представлению</link> вызывающего экрана, а не по представлению редактора.</para>
|
||||
<para>Свойства <code>AccessData</code>, на которые можно ссылаться из компонента <code>accessControl</code>, должны быть реализованы по стандарту JavaBeans: методами с сигнатурой boolean <methodname>getXxx()</methodname></para>
|
||||
<para>
|
||||
<programlisting><xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="source/section_gui/CardAccessData.java" encoding="UTF-8" parse="text"/></programlisting>
|
||||
</para>
|
||||
</section>
|
||||
</section>
|
||||
<section id="gui_Action">
|
||||
<title>Action</title>
|
||||
<para><code>Action</code> − интерфейс, абстрагирующий действие от визуального компонента.</para>
|
||||
|
||||
@ -428,7 +428,7 @@ menu-config.sales$Customer.lookup=Покупатели</programlisting>
|
||||
<para>Выберите пункт меню <guimenu>Run</guimenu> −> <guimenu>Deploy</guimenu>. В подкаталоге <filename>build</filename> проекта будет установлен сервер <application>Tomcat</application> с собранным приложением.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Выберите пункт меню <guimenu>Run</guimenu> −> <guimenu>Start application</guimenu>. Через несколько секунд в панели статуса ссылка рядом с надписью <guilabel>Web application</guilabel> станет доступной, и по ней можно осуществить переход к приложению непосредственно из Студии.</para>
|
||||
<para>Выберите пункт меню <guimenu>Run</guimenu> −> <guimenu>Start application server</guimenu>. Через несколько секунд в панели статуса ссылка рядом с надписью <guilabel>Web application</guilabel> станет доступной, и по ней можно осуществить переход к приложению непосредственно из Студии.</para>
|
||||
<para>Логин и пароль пользователя − admin / admin.</para>
|
||||
<para>Запущенное приложение содержит два главных пункта меню (<guimenu>Администрирование</guimenu> и <guimenu>Помощь</guimenu>), функциональность подсистемы безопасности и администрирования системы.</para>
|
||||
</listitem>
|
||||
@ -448,6 +448,9 @@ menu-config.sales$Customer.lookup=Покупатели</programlisting>
|
||||
<listitem>
|
||||
<para>В поле <guilabel>Parent class</guilabel> оставьте установленное значение − <link linkend="standardEntity">StandardEntity</link>. </para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Поле <guilabel>Inheritance strategy</guilabel> служит для объявления стратегии наследования для создаваемой сущности. Это поле оставьте пустым.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Нажмите на кнопку <guibutton>...</guibutton> рядом с именем сущности. На экране отобразится окно <guilabel>Localized message</guilabel>, в нем следует задать <link linkend="localization">локализацию</link> имени сущности на доступных языках.</para>
|
||||
</listitem>
|
||||
@ -455,7 +458,7 @@ menu-config.sales$Customer.lookup=Покупатели</programlisting>
|
||||
<para>Далее создадим атрибуты сущности. Для этого нажмите на кнопку <guibutton>New</guibutton>, находящуюся под таблицей <guilabel>Attributes</guilabel>.</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>В отобразившемся окне <guilabel>Create attribute</guilabel> в поле <guilabel>Name</guilabel> введите название атрибута сущности − <userinput>name</userinput>, в списке <guilabel>Attribute type</guilabel> выберите значение <link linkend="datatype">DATATYPE</link>, в поле <guilabel>Type</guilabel> укажите тип атрибута <userinput>String</userinput> и далее укажите длину текстового атрибута в поле <guilabel>Length</guilabel>, равной 100 символам. Установите флажок <guilabel>Mandatory</guilabel>. Установленный флажок означает, что атрибут является обязательным к заполнению. В поле <guilabel>Column</guilabel> автоматически сгенерируется имя колонки в базе данных. Далее нажмите на кнопку <guibutton>...</guibutton> рядом с названием атрибута. На экране отобразится окно <guilabel>Localized message</guilabel>, в нем следует задать локализацию названия атрибута на доступных языках.</para>
|
||||
<para>В отобразившемся окне <guilabel>Create attribute</guilabel> в поле <guilabel>Name</guilabel> введите название атрибута сущности − <userinput>name</userinput>, в списке <guilabel>Attribute type</guilabel> выберите значение <link linkend="datatype">DATATYPE</link>, в поле <guilabel>Type</guilabel> укажите тип атрибута <userinput>String</userinput> и далее укажите длину текстового атрибута в поле <guilabel>Length</guilabel>, равной 100 символам. Установите флажок <guilabel>Mandatory</guilabel>. Установленный флажок означает, что атрибут является обязательным к заполнению. В поле <guilabel>Column</guilabel> автоматически сгенерируется имя колонки в базе данных. Далее нажмите на кнопку <guibutton>...</guibutton> рядом с названием атрибута. На экране отобразится окно <guilabel>Localized message</guilabel>, в нем следует задать локализацию названия атрибута на доступных языках. Для добавления атрибута нажмите на кнопку <guibutton>Add</guibutton>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Атрибут <code>email</code> создается таким же образом, за исключением того, что в поле <guilabel>Length</guilabel> следует указать значение <userinput>50</userinput>.</para>
|
||||
@ -473,14 +476,14 @@ menu-config.sales$Customer.lookup=Покупатели</programlisting>
|
||||
<para><guilabel>Name</guilabel> − <userinput>date</userinput>, <guilabel>Attribute type</guilabel> − <link linkend="datatype">DATATYPE</link>, <guilabel>Type</guilabel> − <userinput>Date</userinput>. Для атрибута <code>date</code> установите галочку <guilabel>Mandatory</guilabel>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><guilabel>Name</guilabel> − <userinput>amount</userinput>, <guilabel>Attribute type</guilabel> − <link linkend="datatype">DATATYPE</link>, <guilabel>Type</guilabel> − <userinput>Decimal</userinput>.</para>
|
||||
<para><guilabel>Name</guilabel> − <userinput>amount</userinput>, <guilabel>Attribute type</guilabel> − <link linkend="datatype">DATATYPE</link>, <guilabel>Type</guilabel> − <userinput>BigDecimal</userinput>.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
<para>Для каждого атрибута укажите <link linkend="localization">локализованные</link> названия.</para>
|
||||
</section>
|
||||
<section>
|
||||
<title>Создание таблиц базы данных</title>
|
||||
<para>Для создания таблиц базы данных достаточно на вкладке <guilabel>Entities</guilabel> панели навигатора нажать на кнопку <guibutton>Generate DB scripts</guibutton>. После этого откроется страница <guilabel>Database update scripts</guilabel>. На вкладке будут сгенерированы скрипты обновления базы данных от ее текущего состояния (<guilabel>Update scripts</guilabel>) и скрипты создания БД с нуля (<guilabel>Init tables</guilabel>, <guilabel>Init constraints</guilabel>, <guilabel>Init data</guilabel>). Нажмите на кнопку <guibutton>Save scripts</guibutton> в верхнем правом углу рабочей панели и затем <guibutton>Close</guibutton>. Для запуска скриптов обновления остановите запущенное приложение с помощью команды <guimenu>Run</guimenu> −> <guimenu>Stop application</guimenu>, затем выполните <guimenu>Run</guimenu> −> <guimenu>Update database</guimenu>.</para>
|
||||
<para>Для создания таблиц базы данных достаточно на вкладке <guilabel>Entities</guilabel> панели навигатора нажать на кнопку <guibutton>Generate DB scripts</guibutton>. После этого откроется страница <guilabel>Database update scripts</guilabel>. На вкладке будут сгенерированы скрипты обновления базы данных от ее текущего состояния (<guilabel>Update scripts</guilabel>) и скрипты создания БД с нуля (<guilabel>Init tables</guilabel>, <guilabel>Init constraints</guilabel>, <guilabel>Init data</guilabel>). Нажмите на кнопку <guibutton>Save scripts</guibutton> в верхнем правом углу рабочей панели и затем <guibutton>Close</guibutton>. Для запуска скриптов обновления остановите запущенное приложение с помощью команды <guimenu>Run</guimenu> −> <guimenu>Stop application server</guimenu>, затем выполните <guimenu>Run</guimenu> −> <guimenu>Update database</guimenu>.</para>
|
||||
</section>
|
||||
<section>
|
||||
<title>Создание пользовательского интерфейса приложения</title>
|
||||
|
||||
@ -1,305 +1,305 @@
|
||||
<?xml version='1.0' encoding='UTF-8'?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" []>
|
||||
<!-- This document was created with Syntext Serna Free. --><chapter id="chapter_setup" lang="ru">
|
||||
<title>Установка и настройка инструментария</title>
|
||||
<para>Все программное обеспечение, требуемое для разработки на платформе <trademark>CUBA</trademark>, является свободно распространяемыми и кросс-платформенным. </para>
|
||||
<para>Данная глава дает практические инструкции по установке и настройке рекомендованного программного обеспечения:</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><application>Java SE 7 SDK</application></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><application>Gradle 1.0</application> − инструмент автоматизации сборки</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><application>PostgreSQL 9.1</application> − реляционная система управления базами данных </para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><application>IntelliJ IDEA 11 Community Edition</application> − интегрированная среда разработки для Java</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
<para>Веб-интерфейс приложений, создаваемых на основе платформы, поддерживает все популярные современные браузеры, в том числе <application>Google Chrome</application>, <application>Mozilla Firefox</application>, <application>Safari</application>, <application>Internet Explorer 7+</application>.</para>
|
||||
<warning>
|
||||
<title>Внимание</title>
|
||||
<para>Инструкции по установке приведены для операционной системы <application>Windows 7</application>.</para>
|
||||
</warning>
|
||||
<section>
|
||||
<title>Установка PostgreSQL 9.1</title>
|
||||
<para>Сайт: <ulink url="http://www.postgresql.org/">http://www.postgresql.org/</ulink></para>
|
||||
<para>Дистрибутив: <ulink url="http://www.enterprisedb.com/products-services-training/pgdownload#windows">http://www.enterprisedb.com/products-services-training/pgdownload #windows</ulink></para>
|
||||
<orderedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Скачайте соответствующий установочный пакет.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Запустите мастер установки.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В окне <guilabel>Installation Directory</guilabel> предоставляется возможность сменить каталог установки программы.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В окне <guilabel>Data Directory</guilabel> предоставляется возможность сменить каталог для хранения данных.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В окне <guilabel>Password</guilabel> в поля <guilabel>Password</guilabel> и <guilabel>Retype password</guilabel> введите новый пароль для пользователя <database>postgres</database>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В окне <guilabel>Port</guilabel> предлагается ввести номер порта сервера. Оставьте порт по умолчанию.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В окне <guilabel>Advanced Options</guilabel> выберите из списка локаль <code>Russian, Russia</code>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В окне <guilabel>Ready to Install</guilabel> после нажатия на кнопку <guibutton>Next></guibutton> будет произведена установка <application>PostgreSQL</application> на Ваш компьютер.</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
<para>После установки убедимся в работоспособности сервера базы данных. Для этого запустите программу <application>pgAdmin</application> через меню <guimenu>Пуск</guimenu> / <guimenu>PostgreSQL 9.1</guimenu> / <guisubmenu>pgAdmin III</guisubmenu>. На экране отобразится окно, представленное на рисунке:</para>
|
||||
<figure>
|
||||
<title>Установка PostgreSQL</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata align="center" fileref="img/ch1_db_1.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>Подключитесь к серверу, используя пароль пользователя <database>postgres</database>, заданный на этапе инсталляции.</para>
|
||||
<para>Создадим нового пользователя. Для этого в контекстном меню элемента <guilabel>PostgreSQL Database Server 9.1 (localhost:5432)</guilabel> выберите <guimenuitem>Подключение</guimenuitem>. Далее в контекстном меню элемента <guilabel>Роли входа</guilabel> выберите <guimenuitem>Новая роль</guimenuitem>. На экране отобразится окно, представленное на рисунке:</para>
|
||||
<figure>
|
||||
<title>Настройка PostgreSQL. Создание роли входа</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata contentwidth="80%" align="center" fileref="img/ch1_db_2.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>В этом окне в качестве имени роли укажите <userinput role="italic">cuba</userinput>. Далее перейдите на вкладку <guilabel>Определение</guilabel>. </para>
|
||||
<figure>
|
||||
<title>Настройка PostgreSQL. Создание роли входа</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata contentwidth="80%" align="center" fileref="img/ch1_db_3.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>В полях <guilabel>Пароль</guilabel> и <guilabel>Подтверждение</guilabel> введите пароль <userinput>cuba</userinput>. Далее перейдите на вкладку <guilabel>Привилегии роли</guilabel>. </para>
|
||||
<para>Установите флажок <guilabel>Суперпользователь</guilabel> и нажмите на кнопку <guibutton>ОК</guibutton>.</para>
|
||||
<figure>
|
||||
<title>Настройка PostgreSQL. Создание роли входа</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata contentwidth="80%" align="center" fileref="img/ch1_db_4.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>Установка и настройка базы данных завершена.</para>
|
||||
<para>Следует отметить, что имя и пароль пользователя БД выбраны исключительно для целей настоящего руководства, и при реальной эксплуатации приложений могут быть любыми другими. Права суперпользователя требуются только на момент первичного создания базы данных и в дальнейшем могут быть отозваны.</para>
|
||||
</section>
|
||||
<section>
|
||||
<title>Установка Java SE 7</title>
|
||||
<para>Сайт: <ulink url="http://oracle.com/technetwork/java/">http://oracle.com/technetwork/java</ulink></para>
|
||||
<para>Дистрибутив: <ulink url="http://www.oracle.com/technetwork/java/javase/downloads">http://www.oracle.com/technetwork/java/javase/downloads</ulink></para>
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>Скачайте последнюю версию <application>JDK 7</application>, например, <filename>jdk-7u5-windows-x64.exe.</filename></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Запустите файл <filename>jdk-7u5-windows-x64.exe</filename> и установите все компоненты следуя инструкциям программы-установщика.</para>
|
||||
</listitem>
|
||||
<listitem id="path_setting">
|
||||
<para>Создайте переменную среды <envar>JAVA_HOME</envar>. В качестве значения переменной окружения <envar>JAVA_HOME</envar> установите путь к каталогу установки <application>JDK</application>, например, <filename>C:\Program Files\Java\jdk1.7.0_05</filename>.</para>
|
||||
<caution>
|
||||
<title>Подсказка</title>
|
||||
<para>Как установить или изменить переменную среды?</para>
|
||||
<para>В пункте меню <guimenu>Пуск</guimenu> выберите <guimenuitem>Панель управления</guimenuitem>, далее в элементах панели управления выберите элемент <guisubmenu>Система</guisubmenu>. На панели слева выберите ссылку на <guisubmenu>Дополнительные параметры системы</guisubmenu>. В отобразившемся окне <guilabel>Свойства системы</guilabel> перейдите на вкладку <guilabel>Дополнительно</guilabel> и нажмите на кнопку <guibutton>Переменные среды</guibutton>.</para>
|
||||
<para>Чтобы создать новую переменную среды, нажмите на кнопку <guibutton>Создать</guibutton> в панели <guilabel>Системные переменные</guilabel>.</para>
|
||||
<figure>
|
||||
<title>Окно управления переменными среды</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata contentwidth="80%" align="center" fileref="img/ch1_path_2.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>В поле <guilabel>Имя переменной</guilabel> введите <userinput>JAVA_HOME</userinput>, а в поле <guilabel>Значение переменной</guilabel> <userinput>C:\Program Files\Java\jdk1.7.0_05.</userinput></para>
|
||||
<figure>
|
||||
<title>Окно создания переменной среды JAVA_HOME</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata contentwidth="80%" align="center" fileref="img/ch_path_3.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>Чтобы изменить значение существующей переменной среды, например, <envar>Path</envar>, найдите ее в списке на панели <guilabel>Системные переменные</guilabel> и нажмите на кнопку <guibutton>Изменить</guibutton>. В поле <guilabel>Значение переменной</guilabel> введите значение <userinput>%JAVA_HOME%\bin.</userinput></para>
|
||||
<figure>
|
||||
<title>Окно изменения переменной среды Path</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata contentwidth="80%" align="center" fileref="img/ch1_path_4.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
</caution>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>К значению переменной среды <envar>Path</envar> добавьте значение <userinput>%JAVA_HOME%\bin.</userinput> Значение переменной <envar>Path</envar> необходимо обновить для того, чтобы исполняемые файлы <application>JDK</application> стали доступны в командной строке.</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
<para>После установки убедимся в работоспособности java-машины. Для этого запустите командную строку и введите в ней команду </para>
|
||||
<para><prompt>java -version</prompt>.</para>
|
||||
<para>В результате выполнения команды Вы увидите окно командной строки, вид которого представлен на следующем рисунке:</para>
|
||||
<figure>
|
||||
<title>Окно командной строки. Результат выполнения команды java -version</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata align="center" fileref="img/ch1_java_check_version.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>В случае неудачного запуска команды вернитесь к <link linkend="path_setting">пункту 7</link> и проверьте правильность установки переменных среды <envar>JAVA_HOME</envar> и <envar>Path</envar>.</para>
|
||||
<para>Установка и настройка <application>Java</application> завершена.</para>
|
||||
</section>
|
||||
<section id="gradle_install">
|
||||
<title>Установка Gradle 1.0</title>
|
||||
<para>Сайт: <ulink url="http://www.gradle.org/">http://www.gradle.org</ulink></para>
|
||||
<para>Дистрибутив: <ulink url="http://services.gradle.org/distributions/gradle-1.0-all.zip">http://services.gradle.org/distributions/gradle-1.0-all.zip</ulink></para>
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>Скачайте архив <filename>gradle-1.0-all.zip</filename> и распакуйте его, например, в <filename>C:\Program Files (x86)\gradle</filename>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>К значению переменной среды <envar>Path</envar> добавьте значение </para>
|
||||
<para><userinput>C:\Program Files (x86)\gradle\gradle-1.0\bin.</userinput></para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
<para>Убедимся в работоспособности <application>gradle</application>. Для этого в командной строке введите команду</para>
|
||||
<para> <prompt>gradle -version</prompt></para>
|
||||
<para>В результате выполнения команды Вы увидите окно командной строки, вид которого представлен на следующем рисунке:</para>
|
||||
<figure>
|
||||
<title>Окно командной строки. Результат выполнения команды gradle -version</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata align="center" fileref="img/ch1_gradle.png" format="PNG"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
</section>
|
||||
<section>
|
||||
<title>Установка IntelliJ IDEA 11 Community Edition</title>
|
||||
<para>Сайт: <ulink url="http://www.jetbrains.com/">http://www.jetbrains.com</ulink></para>
|
||||
<para>Дистрибутив: <ulink url="http://www.jetbrains.com/idea/download">http://www.jetbrains.com/idea/download</ulink></para>
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>Скачайте последнюю версию <application>IntelliJ IDEA Community Edition</application>. На момент написания данного руководства это <application>IntelliJ IDEA 11</application>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Запустите файл <filename>ideaIC-11.exe</filename>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В первом окне нажмите на кнопку <guibutton>Next</guibutton>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В следующем окне <guilabel>Choose Install Location</guilabel> предоставляется возможность сменить каталог установки программы.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В следующем окне предоставляется возможность установления ярлыка на рабочем столе и ярлыка быстрого запуска приложения.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Далее можно задать имя папки, которое будет отображаться в меню <guimenu>Пуск</guimenu>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В следующем окне установите галочку <guilabel>Run IntelliJ IDEA Community Edition</guilabel>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Произведем настройку среды разработки. В отобразившемся окне предлагается импортировать настройки, если другая версия <application>IDEA</application> уже была установлена на данном локальном компьютере. Если вы устанавливаете <application>IDEA</application> в первый раз, установите переключатель в положение <guilabel>I do not have a previous version of IntelliJ IDEA or I do not want to import my settings</guilabel> и нажмите на кнопку <guibutton>OK</guibutton>.</para>
|
||||
<figure>
|
||||
<title>Установка IntelliJ IDEA</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata align="center" fileref="img/ch1_idea_6.png" format="PNG"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Теперь установим <application>SDK</application>, которое будет использоваться по умолчанию. Для этого в меню <guimenu>File</guimenu> выберите пункт меню <guimenuitem>Project Structure</guimenuitem>. Далее слева в группе <guisubmenu>Project Settings</guisubmenu> выберите строку <guisubmenu>Project</guisubmenu>. На отобразившейся панели настроек нажмите на кнопку <guibutton>New</guibutton> и выберите в контекстном меню пункт <guimenuitem>JSDK</guimenuitem>.</para>
|
||||
<figure>
|
||||
<title>Установка IntelliJ IDEA</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata align="center" fileref="img/ch1_idea_7.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>В отобразившемся окне укажите путь к папке с <application>JDK</application>, например, <filename>C:\Program Files\Java\jdk1.7.0_05</filename>. Для сохранения настроек нажмите на кнопку <guibutton>Apply</guibutton>.</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
<para>Установка и настройка среды разработки <application>IntelliJ IDEA</application> завершена.</para>
|
||||
</section>
|
||||
<section id="cubaStudio_install">
|
||||
<title>Установка CUBA Studio</title>
|
||||
<para>Данный этап необходим, если Вы предполагаете вести разработку приложения на платформе <trademark>CUBA</trademark> при помощи Студии.</para>
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>Установите инструменты сборки и настройте окружение согласно предыдущим разделам данной главы.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Загрузите архив <filename>studio-0.3.zip</filename> по ссылке <ulink url="http://repository.haulmont.com:8587/nexus/content/repositories/releases/com/haulmont/studio/studio/0.3/studio-0.3.zip">http://repository.haulmont.com:8587/nexus/content/repositories/releases/com/haulmont/studio/studio/0.3/studio-0.3.zip</ulink> (для доступа к репозиторию используйте имя <userinput>cuba</userinput> и пароль <userinput>cuba123</userinput>).</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Распакуйте архив в локальный путь, не содержащий пробелов, например, <filename>c:/work/studio</filename></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Запустите командную строку, перейдите в подкаталог <filename>bin</filename> и запустите <application>studio</application></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В окне <guilabel>Studio Server</guilabel> введите следующие параметры:</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><guilabel>Workspace</guilabel> − каталог, в котором будут создаваться проекты, например, <filename>c:/work</filename></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><guilabel>Gradle home</guilabel> − путь к установленному <application>
|
||||
<link linkend="gradle_install">Gradle</link>
|
||||
</application></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><guilabel>Server port</guilabel> − порт, на котором будет запущен сервер <application>CUBA Studio</application></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><guilabel>IDE port</guilabel> − порт, на котором будет принимать подключения плагин к IDE</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><guilabel>Repository</guilabel> − URL <link linkend="artifact_repository">репозитория</link> бинарных артефактов. Нажмите кнопку <guibutton>Auth</guibutton> и укажите имя <userinput>cuba</userinput> и пароль <userinput>cuba123</userinput>.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Запустите сервер <application>CUBA Studio</application>, нажав кнопку <guibutton>Start</guibutton>. В поле <guilabel>URL</guilabel> отобразится адрес, по которому доступен интерфейс <application>CUBA Studio</application>. Нажав <guibutton>-></guibutton>, можно открыть веб-браузер, нажав <guibutton>Copy</guibutton>, − скопировать адрес в буфер обмена.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Запустите веб-браузер и перейдите по указанному адресу.</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
<para>Для интеграции с IDE выполните следующие шаги:</para>
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>В главном меню студии выберите пункт меню <guimenu>Build</guimenu> −> <guimenu>Create IDEA project files</guimenu>. В каталоге проекта будут созданы файлы <filename>*.ipr</filename>, <filename>*.iml</filename></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Распакуйте содержимое архива <filename>c:/work/studio/ideplugins/cuba-idea-plugin-XYZ.zip</filename> в подкаталог <filename>plugins</filename> установленной <application>IntelliJ IDEA</application>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Запустите <application>IntelliJ IDEA</application> и откройте проект c:/work/sales/sales.ipr</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В <application>IntelliJ IDEA</application> в меню <guimenu>File</guimenu> выберите пункт меню <guimenu>Settings</guimenu>. Далее слева в группе <guilabel>Project Settings</guilabel> найдите строку <guilabel>CUBA</guilabel>. На панели <guilabel>Studio integration</guilabel> установите флажок <guilabel>Enabled</guilabel> и нажмите на кнопку <guibutton>OK</guibutton>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Обратите внимание, что в панели статуса Студии загорелась надпись <guilabel>IDE: on</guilabel></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>При нажатии кнопок <guilabel>IDE</guilabel> в студии соответствующие файлы исходных кодов будут открываться редактором <application>IDEA</application>.</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
</section>
|
||||
</chapter>
|
||||
<?xml version='1.0' encoding='UTF-8'?>
|
||||
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" []>
|
||||
<!-- This document was created with Syntext Serna Free. --><chapter id="chapter_setup" lang="ru">
|
||||
<title>Установка и настройка инструментария</title>
|
||||
<para>Все программное обеспечение, требуемое для разработки на платформе <trademark>CUBA</trademark>, является свободно распространяемыми и кросс-платформенным. </para>
|
||||
<para>Данная глава дает практические инструкции по установке и настройке рекомендованного программного обеспечения:</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><application>Java SE 7 SDK</application></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><application>Gradle 1.0</application> − инструмент автоматизации сборки</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><application>PostgreSQL 9.1</application> − реляционная система управления базами данных </para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><application>IntelliJ IDEA 11 Community Edition</application> − интегрированная среда разработки для Java</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
<para>Веб-интерфейс приложений, создаваемых на основе платформы, поддерживает все популярные современные браузеры, в том числе <application>Google Chrome</application>, <application>Mozilla Firefox</application>, <application>Safari</application>, <application>Internet Explorer 7+</application>.</para>
|
||||
<warning>
|
||||
<title>Внимание</title>
|
||||
<para>Инструкции по установке приведены для операционной системы <application>Windows 7</application>.</para>
|
||||
</warning>
|
||||
<section>
|
||||
<title>Установка PostgreSQL 9.1</title>
|
||||
<para>Сайт: <ulink url="http://www.postgresql.org/">http://www.postgresql.org/</ulink></para>
|
||||
<para>Дистрибутив: <ulink url="http://www.enterprisedb.com/products-services-training/pgdownload#windows">http://www.enterprisedb.com/products-services-training/pgdownload #windows</ulink></para>
|
||||
<orderedlist spacing="compact">
|
||||
<listitem>
|
||||
<para>Скачайте соответствующий установочный пакет.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Запустите мастер установки.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В окне <guilabel>Installation Directory</guilabel> предоставляется возможность сменить каталог установки программы.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В окне <guilabel>Data Directory</guilabel> предоставляется возможность сменить каталог для хранения данных.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В окне <guilabel>Password</guilabel> в поля <guilabel>Password</guilabel> и <guilabel>Retype password</guilabel> введите новый пароль для пользователя <database>postgres</database>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В окне <guilabel>Port</guilabel> предлагается ввести номер порта сервера. Оставьте порт по умолчанию.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В окне <guilabel>Advanced Options</guilabel> выберите из списка локаль <code>Russian, Russia</code>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В окне <guilabel>Ready to Install</guilabel> после нажатия на кнопку <guibutton>Next></guibutton> будет произведена установка <application>PostgreSQL</application> на Ваш компьютер.</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
<para>После установки убедимся в работоспособности сервера базы данных. Для этого запустите программу <application>pgAdmin</application> через меню <guimenu>Пуск</guimenu> / <guimenu>PostgreSQL 9.1</guimenu> / <guisubmenu>pgAdmin III</guisubmenu>. На экране отобразится окно, представленное на рисунке:</para>
|
||||
<figure>
|
||||
<title>Установка PostgreSQL</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata align="center" fileref="img/ch1_db_1.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>Подключитесь к серверу, используя пароль пользователя <database>postgres</database>, заданный на этапе инсталляции.</para>
|
||||
<para>Создадим нового пользователя. Для этого в контекстном меню элемента <guilabel>PostgreSQL Database Server 9.1 (localhost:5432)</guilabel> выберите <guimenuitem>Подключение</guimenuitem>. Далее в контекстном меню элемента <guilabel>Роли входа</guilabel> выберите <guimenuitem>Новая роль</guimenuitem>. На экране отобразится окно, представленное на рисунке:</para>
|
||||
<figure>
|
||||
<title>Настройка PostgreSQL. Создание роли входа</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata contentwidth="80%" align="center" fileref="img/ch1_db_2.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>В этом окне в качестве имени роли укажите <userinput role="italic">cuba</userinput>. Далее перейдите на вкладку <guilabel>Определение</guilabel>. </para>
|
||||
<figure>
|
||||
<title>Настройка PostgreSQL. Создание роли входа</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata contentwidth="80%" align="center" fileref="img/ch1_db_3.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>В полях <guilabel>Пароль</guilabel> и <guilabel>Подтверждение</guilabel> введите пароль <userinput>cuba</userinput>. Далее перейдите на вкладку <guilabel>Привилегии роли</guilabel>. </para>
|
||||
<para>Установите флажок <guilabel>Суперпользователь</guilabel> и нажмите на кнопку <guibutton>ОК</guibutton>.</para>
|
||||
<figure>
|
||||
<title>Настройка PostgreSQL. Создание роли входа</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata contentwidth="80%" align="center" fileref="img/ch1_db_4.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>Установка и настройка базы данных завершена.</para>
|
||||
<para>Следует отметить, что имя и пароль пользователя БД выбраны исключительно для целей настоящего руководства, и при реальной эксплуатации приложений могут быть любыми другими. Права суперпользователя требуются только на момент первичного создания базы данных и в дальнейшем могут быть отозваны.</para>
|
||||
</section>
|
||||
<section>
|
||||
<title>Установка Java SE 7</title>
|
||||
<para>Сайт: <ulink url="http://oracle.com/technetwork/java/">http://oracle.com/technetwork/java</ulink></para>
|
||||
<para>Дистрибутив: <ulink url="http://www.oracle.com/technetwork/java/javase/downloads">http://www.oracle.com/technetwork/java/javase/downloads</ulink></para>
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>Скачайте последнюю версию <application>JDK 7</application>, например, <filename>jdk-7u5-windows-x64.exe.</filename></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Запустите файл <filename>jdk-7u5-windows-x64.exe</filename> и установите все компоненты следуя инструкциям программы-установщика.</para>
|
||||
</listitem>
|
||||
<listitem id="path_setting">
|
||||
<para>Создайте переменную среды <envar>JAVA_HOME</envar>. В качестве значения переменной окружения <envar>JAVA_HOME</envar> установите путь к каталогу установки <application>JDK</application>, например, <filename>C:\Program Files\Java\jdk1.7.0_05</filename>.</para>
|
||||
<caution>
|
||||
<title>Подсказка</title>
|
||||
<para>Как установить или изменить переменную среды?</para>
|
||||
<para>В пункте меню <guimenu>Пуск</guimenu> выберите <guimenuitem>Панель управления</guimenuitem>, далее в элементах панели управления выберите элемент <guisubmenu>Система</guisubmenu>. На панели слева выберите ссылку на <guisubmenu>Дополнительные параметры системы</guisubmenu>. В отобразившемся окне <guilabel>Свойства системы</guilabel> перейдите на вкладку <guilabel>Дополнительно</guilabel> и нажмите на кнопку <guibutton>Переменные среды</guibutton>.</para>
|
||||
<para>Чтобы создать новую переменную среды, нажмите на кнопку <guibutton>Создать</guibutton> в панели <guilabel>Системные переменные</guilabel>.</para>
|
||||
<figure>
|
||||
<title>Окно управления переменными среды</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata contentwidth="80%" align="center" fileref="img/ch1_path_2.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>В поле <guilabel>Имя переменной</guilabel> введите <userinput>JAVA_HOME</userinput>, а в поле <guilabel>Значение переменной</guilabel> <userinput>C:\Program Files\Java\jdk1.7.0_05.</userinput></para>
|
||||
<figure>
|
||||
<title>Окно создания переменной среды JAVA_HOME</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata contentwidth="80%" align="center" fileref="img/ch_path_3.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>Чтобы изменить значение существующей переменной среды, например, <envar>Path</envar>, найдите ее в списке на панели <guilabel>Системные переменные</guilabel> и нажмите на кнопку <guibutton>Изменить</guibutton>. В поле <guilabel>Значение переменной</guilabel> введите значение <userinput>%JAVA_HOME%\bin.</userinput></para>
|
||||
<figure>
|
||||
<title>Окно изменения переменной среды Path</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata contentwidth="80%" align="center" fileref="img/ch1_path_4.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
</caution>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>К значению переменной среды <envar>Path</envar> добавьте значение <userinput>%JAVA_HOME%\bin.</userinput> Значение переменной <envar>Path</envar> необходимо обновить для того, чтобы исполняемые файлы <application>JDK</application> стали доступны в командной строке.</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
<para>После установки убедимся в работоспособности java-машины. Для этого запустите командную строку и введите в ней команду </para>
|
||||
<para><prompt>java -version</prompt>.</para>
|
||||
<para>В результате выполнения команды Вы увидите окно командной строки, вид которого представлен на следующем рисунке:</para>
|
||||
<figure>
|
||||
<title>Окно командной строки. Результат выполнения команды java -version</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata align="center" fileref="img/ch1_java_check_version.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>В случае неудачного запуска команды вернитесь к <link linkend="path_setting">пункту 7</link> и проверьте правильность установки переменных среды <envar>JAVA_HOME</envar> и <envar>Path</envar>.</para>
|
||||
<para>Установка и настройка <application>Java</application> завершена.</para>
|
||||
</section>
|
||||
<section id="gradle_install">
|
||||
<title>Установка Gradle 1.0</title>
|
||||
<para>Сайт: <ulink url="http://www.gradle.org/">http://www.gradle.org</ulink></para>
|
||||
<para>Дистрибутив: <ulink url="http://services.gradle.org/distributions/gradle-1.0-all.zip">http://services.gradle.org/distributions/gradle-1.0-all.zip</ulink></para>
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>Скачайте архив <filename>gradle-1.0-all.zip</filename> и распакуйте его, например, в <filename>C:\Program Files (x86)\gradle</filename>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>К значению переменной среды <envar>Path</envar> добавьте значение </para>
|
||||
<para><userinput>C:\Program Files (x86)\gradle\gradle-1.0\bin.</userinput></para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
<para>Убедимся в работоспособности <application>gradle</application>. Для этого в командной строке введите команду</para>
|
||||
<para> <prompt>gradle -version</prompt></para>
|
||||
<para>В результате выполнения команды Вы увидите окно командной строки, вид которого представлен на следующем рисунке:</para>
|
||||
<figure>
|
||||
<title>Окно командной строки. Результат выполнения команды gradle -version</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata align="center" fileref="img/ch1_gradle.png" format="PNG"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
</section>
|
||||
<section>
|
||||
<title>Установка IntelliJ IDEA 11 Community Edition</title>
|
||||
<para>Сайт: <ulink url="http://www.jetbrains.com/">http://www.jetbrains.com</ulink></para>
|
||||
<para>Дистрибутив: <ulink url="http://www.jetbrains.com/idea/download">http://www.jetbrains.com/idea/download</ulink></para>
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>Скачайте последнюю версию <application>IntelliJ IDEA Community Edition</application>. На момент написания данного руководства это <application>IntelliJ IDEA 11</application>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Запустите файл <filename>ideaIC-11.exe</filename>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В первом окне нажмите на кнопку <guibutton>Next</guibutton>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В следующем окне <guilabel>Choose Install Location</guilabel> предоставляется возможность сменить каталог установки программы.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В следующем окне предоставляется возможность установления ярлыка на рабочем столе и ярлыка быстрого запуска приложения.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Далее можно задать имя папки, которое будет отображаться в меню <guimenu>Пуск</guimenu>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В следующем окне установите галочку <guilabel>Run IntelliJ IDEA Community Edition</guilabel>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Произведем настройку среды разработки. В отобразившемся окне предлагается импортировать настройки, если другая версия <application>IDEA</application> уже была установлена на данном локальном компьютере. Если вы устанавливаете <application>IDEA</application> в первый раз, установите переключатель в положение <guilabel>I do not have a previous version of IntelliJ IDEA or I do not want to import my settings</guilabel> и нажмите на кнопку <guibutton>OK</guibutton>.</para>
|
||||
<figure>
|
||||
<title>Установка IntelliJ IDEA</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata align="center" fileref="img/ch1_idea_6.png" format="PNG"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Теперь установим <application>SDK</application>, которое будет использоваться по умолчанию. Для этого в меню <guimenu>File</guimenu> выберите пункт меню <guimenuitem>Project Structure</guimenuitem>. Далее слева в группе <guisubmenu>Project Settings</guisubmenu> выберите строку <guisubmenu>Project</guisubmenu>. На отобразившейся панели настроек нажмите на кнопку <guibutton>New</guibutton> и выберите в контекстном меню пункт <guimenuitem>JSDK</guimenuitem>.</para>
|
||||
<figure>
|
||||
<title>Установка IntelliJ IDEA</title>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata align="center" fileref="img/ch1_idea_7.png"/>
|
||||
</imageobject>
|
||||
</mediaobject>
|
||||
</figure>
|
||||
<para>В отобразившемся окне укажите путь к папке с <application>JDK</application>, например, <filename>C:\Program Files\Java\jdk1.7.0_05</filename>. Для сохранения настроек нажмите на кнопку <guibutton>Apply</guibutton>.</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
<para>Установка и настройка среды разработки <application>IntelliJ IDEA</application> завершена.</para>
|
||||
</section>
|
||||
<section id="cubaStudio_install">
|
||||
<title>Установка CUBA Studio</title>
|
||||
<para>Данный этап необходим, если Вы предполагаете вести разработку приложения на платформе <trademark>CUBA</trademark> при помощи Студии.</para>
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>Установите инструменты сборки и настройте окружение согласно предыдущим разделам данной главы.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Загрузите архив <filename>studio-0.4.zip</filename> по ссылке <ulink url="http://repository.haulmont.com:8587/nexus/content/repositories/releases/com/haulmont/studio/studio/0.4/studio-0.4.zip">http://repository.haulmont.com:8587/nexus/content/repositories/releases/com/haulmont/studio/studio/0.4/studio-0.4.zip</ulink>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Распакуйте архив в локальный путь, не содержащий пробелов, например, <filename>c:/work/studio</filename></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Запустите командную строку, перейдите в подкаталог <filename>bin</filename> и запустите <application>studio</application></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В окне <guilabel>Studio Server</guilabel> введите следующие параметры:</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><guilabel>Workspace</guilabel> − каталог, в котором будут создаваться проекты, например, <filename>c:/work</filename></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><guilabel>Gradle home</guilabel> − путь к установленному <application>
|
||||
<link linkend="gradle_install">Gradle</link>
|
||||
</application></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><guilabel>Server port</guilabel> − порт, на котором будет запущен сервер <application>CUBA Studio</application></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><guilabel>IDE port</guilabel> − порт, на котором будет принимать подключения плагин к IDE</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para><guilabel>Repository</guilabel> − URL <link linkend="artifact_repository">репозитория</link> бинарных артефактов. Нажмите кнопку <guibutton>Auth</guibutton> и укажите имя и пароль доступа к репозиторию.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Запустите сервер <application>CUBA Studio</application>, нажав кнопку <guibutton>Start</guibutton>. В поле <guilabel>URL</guilabel> отобразится адрес, по которому доступен интерфейс <application>CUBA Studio</application>. Нажав <guibutton>-></guibutton>, можно открыть веб-браузер, нажав <guibutton>Copy</guibutton>, − скопировать адрес в буфер обмена.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Запустите веб-браузер и перейдите по указанному адресу.</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
<para>Для интеграции с IDE выполните следующие шаги:</para>
|
||||
<orderedlist>
|
||||
<listitem>
|
||||
<para>В главном меню студии выберите пункт меню <guimenu>Build</guimenu> −> <guimenu>Create IDEA project files</guimenu>. В каталоге проекта будут созданы файлы <filename>*.ipr</filename>, <filename>*.iml</filename></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Распакуйте содержимое архива <filename>c:/work/studio/ideplugins/cuba-idea-plugin-XYZ.zip</filename> в подкаталог <filename>plugins</filename> установленной <application>IntelliJ IDEA</application>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Запустите <application>IntelliJ IDEA</application> и откройте проект c:/work/sales/sales.ipr</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>В <application>IntelliJ IDEA</application> в меню <guimenu>File</guimenu> выберите пункт меню <guimenu>Settings</guimenu>. Далее слева в группе <guilabel>Project Settings</guilabel> найдите строку <guilabel>CUBA</guilabel>. На панели <guilabel>Studio integration</guilabel> установите флажок <guilabel>Enabled</guilabel> и нажмите на кнопку <guibutton>OK</guibutton>.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Обратите внимание, что в панели статуса Студии загорелась надпись <guilabel>IDE: on</guilabel></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>При нажатии кнопок <guilabel>IDE</guilabel> в студии соответствующие файлы исходных кодов будут открываться редактором <application>IDEA</application>.</para>
|
||||
</listitem>
|
||||
</orderedlist>
|
||||
</section>
|
||||
</chapter>
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
16
doc/content/manual/ru/source/section_gui/grid/grid_flex.txt
Normal file
16
doc/content/manual/ru/source/section_gui/grid/grid_flex.txt
Normal file
@ -0,0 +1,16 @@
|
||||
<grid spacing="true" margin="true" width="100%">
|
||||
<columns>
|
||||
<column flex="3"/>
|
||||
<column/>
|
||||
<column flex="1"/>
|
||||
<column flex="0"/>
|
||||
</columns>
|
||||
<rows>
|
||||
<row>
|
||||
<label value="Name"/>
|
||||
<textField id="name" datasource="customerDs" property="name"/>
|
||||
<label value="Email"/>
|
||||
<textField id="email" datasource="customerDs" property="email"/>
|
||||
</row>
|
||||
</rows>
|
||||
</grid>
|
||||
Loading…
Reference in New Issue
Block a user