harmony-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From var...@apache.org
Subject svn commit: r630108 [2/4] - in /harmony/standard/site: ./ docs/ docs/documentation/ xdocs/ xdocs/documentation/ xdocs/stylesheets/
Date Fri, 22 Feb 2008 07:16:38 GMT
Modified: harmony/standard/site/docs/quickhelp_contributors.ru.html
URL: http://svn.apache.org/viewvc/harmony/standard/site/docs/quickhelp_contributors.ru.html?rev=630108&r1=630107&r2=630108&view=diff
==============================================================================
--- harmony/standard/site/docs/quickhelp_contributors.ru.html (original)
+++ harmony/standard/site/docs/quickhelp_contributors.ru.html Thu Feb 21 23:16:27 2008
@@ -66,9 +66,9 @@
                 
     <!-- ============================================================ -->
 
-                <p class="menuItem">General</p>
+                <p class="menuItem">Основные ссылки</p>
         <ul>
-                    <li class="menuItem">    <a href="./index.html">Home</a>
+                    <li class="menuItem">    <a href="./index.ru.html">Главная страница</a>
 </li>
            
                         
@@ -84,7 +84,7 @@
 </li>
            
                         
-                    <li class="menuItem">    <a href="./bundles.html">Bundles</a>
+                    <li class="menuItem">    <a href="./bundles.ru.html">Готовые решения ПО</a>
 </li>
            
                         
@@ -94,7 +94,7 @@
                         
         
         </ul>
-            <p class="menuItem">Community</p>
+            <p class="menuItem">Сообщество</p>
         <ul>
                     <li class="menuItem">    <a href="./get-involved.html">Get Involved</a>
 </li>
@@ -118,13 +118,13 @@
                         
         
         </ul>
-            <p class="menuItem">Development</p>
+            <p class="menuItem">Развитие проекта</p>
         <ul>
                     <li class="menuItem">    <a href="./svn.html">Source Code</a>
 </li>
            
                         
-                    <li class="menuItem">    <a href="./quickhelp_contributors.html">Getting Started</a>
+                    <li class="menuItem">    <a href="./quickhelp_contributors.ru.html">Инструкция разработчика</a>
 </li>
            
                         
@@ -142,7 +142,7 @@
                         
         
         </ul>
-            <p class="menuItem">Documentation</p>
+            <p class="menuItem">Документация</p>
         <ul>
                     <li class="menuItem">    <a href="./sitemap.html">Sitemap</a>
 </li>
@@ -170,7 +170,7 @@
                         
         
         </ul>
-            <p class="menuItem">Foundation</p>
+            <p class="menuItem">Организация Апачи</p>
         <ul>
                     <li class="menuItem">    <a href="http://apache.org">ASF</a>
 </li>
@@ -191,68 +191,79 @@
             <!-- MAIN CONTENT -->
             <div id="top">
                                                         <h1>
-      <a name="ИнÑ?трукциÑ? по Ñ?борке и иÑ?пользованию иÑ?ходного кода Apache Harmony">ИнÑ?трукциÑ? по Ñ?борке и иÑ?пользованию иÑ?ходного кода Apache Harmony</a>
+      <a name="Инструкция по сборке и использованию исходного кода Apache Harmony">Инструкция по сборке и использованию исходного кода Apache Harmony</a>
     </h1>
                         <p style="text-align: right">RU | <a href="quickhelp_contributors.html">EN</a></p>
-                                <P><strong>Внимание</strong>: ДаннаÑ? Ñ?траница Ñ?влÑ?етÑ?Ñ? переводом английÑ?кой верÑ?ии на Ñ?айте и находитÑ?Ñ? в Ñ?тадии разработки.</P>
-                                <p>Следуйте Ñ?той инÑ?трукции, чтобы наÑ?троить, Ñ?компилировать и работать Ñ? иÑ?ходным кодом Apache Harmony. ДлÑ? Ñ?того, необходимо: </p>
+                                <p>Следуйте этой инструкции, чтобы настроить, скомпилировать и работать с исходным 
+    кодом Apache Harmony. Для этого, необходимо: </p>
                                 <ol type="1">
-       <li><a href="#prerequisites">УбедитьÑ?Ñ?, что уÑ?тановлено вÑ?е необходимое ПО</a>.  </li>
-       <li><a href="#checkout">Загрузить иÑ?ходный код</a>. </li>
-       <li><a href="#building">Скомпилировать иÑ?ходный код</a>.
+       <li><a href="#prerequisites">Убедиться, что установлено все необходимое ПО</a>.  </li>
+       <li><a href="#checkout">Получить (скачать) исходный код</a>. </li>
+       <li><a href="#building">Скомпилировать исходный код</a>.
     </li>
     </ol>
-                                <p>ПоÑ?ле уÑ?пешного завершениÑ? компилÑ?ции кода, вы Ñ?можете запуÑ?кать Java* приложениÑ?, иÑ?пользуÑ? Harmony. </p>
-                                <p>ЕÑ?ли вам не нужен веÑ?ь комплект разработчика Harmony Java SE (HDK),
-    и вы намерены работать Ñ? отдельными чаÑ?тÑ?ми кода Apache Harmony, Ñ?ледуйте
-    <a href="#step-by-step">пошаговой инÑ?трукции</a> длÑ? поÑ?троениÑ?
-    отдельных компонент Ñ?того комплекта.  </p>
-                                <p>Проект находитÑ?Ñ? на Ñ?тадии разработки. При обнаружении ошибок,
-    воÑ?пользуйтеÑ?ь поиÑ?ком по архиву <a href="http://harmony.apache.org/mailing.html">
-    почтовой раÑ?Ñ?ылки проекта</a> - возможно, ваша проблема уже выÑ?влена и решена.
-    ЕÑ?ли вы не нашли нужную информацию, пришлите нам опиÑ?ание проблемы, и мы поÑ?тараемÑ?Ñ? помочь.  </p>
+                                <p>После успешной сборки, вы сможете <a href="#running-harmony">запускать Java приложения</a>
+    , используя Harmony. </p>
+                                <p>Если вам не нужен весь комплект разработчика Harmony Java SE (HDK),
+    и вы намерены работать с отдельными частями кода Apache Harmony, следуйте
+    <a href="#step-by-step">пошаговой инструкции</a> для построения
+    отдельных компонент этого комплекта.  </p>
+                                <p>Проект находится на стадии разработки. При обнаружении ошибок,
+    воспользуйтесь поиском по архиву <a href="mailing.html">
+    почтовой рассылки проекта</a> - возможно, ваша проблема уже выявлена и решена.
+    Если вы не нашли нужную информацию, пришлите нам описание проблемы, и мы постараемся помочь.  </p>
                                     
     <h2>
-        <a name="1. ТребованиÑ? к Ñ?иÑ?теме">1. ТребованиÑ? к Ñ?иÑ?теме</a>
+        <a name="1. Требования к системе">1. Требования к системе</a>
     </h2>
       
                         <a id="prerequisites" />
-                                <h3>Общие требованиÑ?</h3>
-                                <p>ДлÑ? работы Ñ? Harmony необходимо уÑ?тановить Ñ?ледующее ПО: </p>
+                                <h3>Общие требования</h3>
+                                <p>Для работы с Harmony необходимо установить следующее ПО: </p>
                                 <ul>
-        <li> Apache Ant верÑ?иÑ? 1.6.5 или более позднÑ?Ñ?
+        <li> Apache Ant версия 1.6.5 или более поздняя
         </li>
         <li> Subversion
         </li>
         <li> Java SE 5 JDK
-        <p><strong>Примечание:</strong> еÑ?ли у ваÑ? включен брандмауÑ?р,
-        наÑ?тройте Ñ?оединение через прокÑ?и-Ñ?ервер длÑ? работы Ñ? ant и svn.
-        ДлÑ? svn, Ñ?ледуйте указаниÑ?м в документации клиентÑ?кого приложениÑ?.
-        Ð?апример, длÑ? иÑ?пользованиÑ? конÑ?ольной верÑ?ии svn внеÑ?ите
-        Ñ?оответÑ?твующие изменениÑ? в файл <code>~/.subversion/servers</code>.
-        ДлÑ? работы ant, укажите Ñ?ледующие значениÑ?  длÑ? переменной окружениÑ?
+        <p><strong>Примечание:</strong> если у вас включен брандмауэр,
+        настройте соединение через прокси-сервер для работы с ant и svn.
+        Для svn, следуйте указаниям в документации клиентского приложения.
+        Например, для использования консольной версии svn внесите
+        соответствующие изменения в файл <code>~/.subversion/servers</code>.
+        Для работы ant, укажите следующие значения  для переменной окружения
         <code>ANT_OPTS</code>:
         </p>
         <pre>-Dhttp.proxyHost=&lt;host&gt;
 -Dhttp.proxyPort=&lt;proxy&gt;</pre>
         </li>
         </ul>
-                                <h3>TребованиÑ? длÑ? отдельных платформ</h3>
-                                <p>В завиÑ?имоÑ?ти от платформы (Ñ?м. Ñ?пиÑ?ок поддерживаемых платформ) вам понадобитÑ?Ñ? рÑ?д других программ, наиболее общий Ñ?пиÑ?ок которых приводитÑ?Ñ? ниже.  </p>
+                                <p>Необязательным (но рекомендкемым) ПО является Eclipse Java Compiler (ECJ), 
+      версия 3.2 или более поздняя. 
+      Вы можете <a href="http://download.eclipse.org/eclipse/downloads/">скачать</a> 
+      ecj.jar как отдельный файл и поместить его в папку <code>ANT_HOME/lib</code>.
+      В качестве альтернативы, вы можете использовать любой другой компилятор для 
+      Java 1.5, совместимый с Ant, посредством переопределения переменной
+      <code>hy.javac.compiler</code>.
+      </p>
+                                <h3>Tребования для отдельных платформ</h3>
+                                <p>В зависимости от платформы (см. <a href="roadmap.html#Porting Matrix">
+    список поддерживаемых платформ</a>) вам понадобится ряд 
+    других программ, наиболее общий список которых приводится ниже.  </p>
                                 <p><strong>Windows</strong> </p>
                                 <ul>
-               <li> SDK длÑ? платформы Windows </li>
+               <li> SDK для платформы Windows </li>
                <li> Microsoft Visual Studio.NET 2003 </li>
-               <li> (по желанию) Внешний компилÑ?тор:
+               <li> (по желанию) Внешний компилятор:
                 <ul>
-                    <li> Microsoft 32-битный компилÑ?тор C/C++, верÑ?иÑ? 7 или более позднÑ?Ñ? </li>
-                    <li> Intel C++ Compiler , верÑ?иÑ? 9.0 </li>
+                    <li> Microsoft 32-битный компилятор C/C++, версия 7 или более поздняя </li>
+                    <li> Intel C++ Compiler , версия 9.0 </li>
                 </ul></li>
             </ul>
                                 <p><strong>Linux</strong> </p>
                                 <ul>
-        <li> gcc компилÑ?тор, верÑ?иÑ? 3.3.3 или более позднÑ?Ñ? (ВерÑ?ии до 3.3.3 не теÑ?тировалиÑ?ь но могут работать.) </li>
-        <li> g++ компилÑ?тор </li>
+        <li> gcc компилятор, версия 3.3.3 или более поздняя (Версии до 3.3.3 не тестировались но могут работать.) </li>
+        <li> g++ компилятор </li>
         <li> make </li>
         <li> liblcms1-dev </li>
         <li> libpng12-dev </li>
@@ -263,58 +274,96 @@
         <li> libxml2-dev </li>
         <li> x11proto-xext-dev </li>
     </ul>
-                                <h3>Дополнительные требованиÑ?</h3>
-                                <p>Отдельные компоненты Ñ?иÑ?темы Ñ?борки также завиÑ?ит от Ñ?торонних программных продуктов и библиотек. ПоÑ?кольку Ñ?ти требованиÑ? поÑ?тоÑ?нно Ñ?волюционируют, мы рекомендуем запуÑ?тить Ñ?иÑ?тему Ñ?борки и автоматичеÑ?ки загрузить недоÑ?тающие компоненты через Интернет.  </p>
-                                <p>ДлÑ? поÑ?троениÑ? DRLVM отдельным компонентам Ñ?иÑ?темы требуютÑ?Ñ?: </p>
+                                <p class="note">Примечание:</p>
+                                <p class="notetext">
+      Вам необходимо убедиться, что вы правильно настроили своё окружение для работы с 
+      указанными выше программами. В частности, переменные окружения (такие как PATH)
+      содержат все необходимые файловые пути и т.д., так что вы можете успешно работать
+      со всеми инструментами из командной строки. <br />
+      Например, для использования C++ компилятора на Windows, как правило, потребуется
+      запустить соответствующий скрипт (такой как  
+      "Visual Studio .NET 2003 Command Prompt") непосредственно перед началом сборки.
+      </p>
+                                <h3>Дополнительные требования</h3>
+                                <p>Отдельные компоненты системы сборки также зависит от сторонних программных продуктов и библиотек. 
+    Поскольку эти требования постоянно эволюционируют, мы рекомендуем запустить систему сборки и 
+    автоматически загрузить недостающие компоненты через Интернет.  </p>
+                                <p>Для построения виртуальной машины DRLVM, одного из основных компонентов системы, требуются: </p>
                                 <ul>
-        <li> Xalan-Java, верÑ?иÑ? 2.7.0 (копируетÑ?Ñ? из библиотек клаÑ?Ñ?ов)  </li>
-        <li> Cpp Tasks collection, верÑ?иÑ? 1.0 beta 3 or higher (загружаетÑ?Ñ? из Ñ?ети)  </li>
-        <li> Ant-Contrib набор задач, верÑ?иÑ? 0.6 или более позднÑ?Ñ? (загружаетÑ?Ñ? из Ñ?ети)  </li>
-        <li> Zlib библиотека, бинарные файлы, верÑ?иÑ? 1.2.1 или более позднÑ?Ñ? (загружаетÑ?Ñ? из Ñ?ети)  </li>
-        <li> Apache Portable Runtime Layer , верÑ?иÑ? 1.2.6 (загружаетÑ?Ñ? из Ñ?ети)  </li>
-        <li> APR-util, верÑ?иÑ? 1.2.6 (загружаетÑ?Ñ? из Ñ?ети)  </li>
-        <li> APR-iconv, верÑ?иÑ? 1.1.1 (загружаетÑ?Ñ? из Ñ?ети) </li>
-        <li> Log4cxx , наиболее позднÑ?Ñ? верÑ?иÑ?, из SVN - 467164 (загружаетÑ?Ñ? из Ñ?ети)  </li>
+        <li> Cpp Tasks collection, версия 1.0 beta 3 или более поздняя (загружается из сети)  </li>
+        <li> библиотека Zlib, бинарные файлы, версия 1.2.1 или более поздняя (загружается из сети)  </li>
+        <li> Apache Portable Runtime Layer , версия 1.2.6 (загружается из сети)  </li>
+        <li> APR-util, версия 1.2.6 (загружается из сети)  </li>
+        <li> APR-iconv, версия 1.1.1 (загружается из сети) </li>
+        <li> Log4cxx , наиболее поздняя версия, из SVN - 467164 (загружается из сети)  </li>
     </ul>
-                                <p>Данные компоненты необходимы длÑ? поÑ?троениÑ? иÑ?ходного кода как на Windows, так и на Linux Ñ?иÑ?темах. </p>
-                                <p>Вы можете загрузить и уÑ?тановить дополнительные компоненты до Ñ?борки DRLVM и указать их раÑ?положение, как опиÑ?ано <code>файле</code>, шаг 3.3.1. Там же Ñ?одержитÑ?Ñ? информациÑ? о том, как отключить автоматичеÑ?кую загрузку Ñ?торонних компонент во времÑ? Ñ?борки и иÑ?пользовать уже уÑ?тановленные веÑ
 Ñ?ии.  Примечание: поÑ?кольку требованиÑ? к ПО периодичеÑ?ки изменÑ?ютÑ?Ñ?, не рекомендуетÑ?Ñ? Ñ?амоÑ?тоÑ?тельно уÑ?танавливать недоÑ?тающие компоненты. СиÑ?тема Ñ?борки Ñ?делает Ñ?то за ваÑ?.  </p>
+                                <p>Данные компоненты необходимы для построения исходного кода как на Windows, так и на Linux системах. </p>
+                                <p>Вы можете загрузить и установить дополнительные компоненты до сборки DRLVM и указать их расположение 
+    (например отредактировав файл <code>make/depends.properties</code> в рабочем пространстве компоненты).
+    Однако, поскольку требования к ПО периодически изменяются, не рекомендуется самостоятельно устанавливать 
+    недостающие программы. Система сборки сделает это за вас.  </p>
                    
                                     
     <h2>
-        <a name="2. Загрузка дерева каталогов кода">2. Загрузка дерева каталогов кода</a>
+        <a name="2. Загрузка федеративной систему сборки">2. Загрузка федеративной систему сборки</a>
     </h2>
       
                         <a id="checkout" />
-                                <p>ИÑ?ходный код Harmony ВМ разделен на неÑ?колько чаÑ?тей. ДлÑ? поÑ?троениÑ? вÑ?ей Ñ?реды иÑ?полнениÑ? вам необходимо поÑ?троить библиотеку клаÑ?Ñ?ов и виртуальную машину. ИÑ?пользуйте объединенную Ñ?иÑ?тему Ñ?борки длÑ? поÑ?троениÑ? вÑ?ей Ñ?реды, а затем работайте Ñ? библиотекой клаÑ?Ñ?ов и/или ВМ по вашемÑ
 ƒ выбору. В наÑ?тоÑ?щее времÑ?, Ñ?иÑ?тема Ñ?борки иÑ?пользует виртуальную машину DRLVM. </p>
-                                <p>ДлÑ? того, чтобы выгрузить объединенную Ñ?иÑ?тему Ñ?борки из SVN репозиториÑ?, иÑ?пользуйте Ñ?ледующую команду:
+                                <p>ПО Harmony разделено на несколько компонент. Для построения всего ПО вам 
+        необходимо построить библиотеку классов, виртуальную машину и инструменты Java разработчика. 
+        Используйте федеративную систему сборки для построения всей среды, а затем работайте с библиотекой 
+        классов и/или ВМ по вашему выбору. В настоящее время, система сборки использует виртуальную машину 
+        DRLVM. </p>
+                                <p>Для того, чтобы загрузить федеративную систему сборки из SVN репозитория, используйте 
+        следующую команду:
         </p>
-                                <pre>$ svn co https://svn.apache.org/repos/asf/harmony/enhanced/trunk</pre>
-                                <p>ДаннаÑ? команда выгружает дерево каталогов Ñ? пуÑ?тыми директориÑ?ми <code>working_classlib</code> и <code>working_vm</code>. ПоÑ?ле поÑ?троениÑ? иÑ?ходного кода на Ñ?ледующем Ñ?тапе, в директорию <code>working_classlib</code> будет выгружена копиÑ?  дерева каталогов библиотеки клаÑ?Ñ?ов, а в директорию <code>working_vm</code> - копиÑ? дерева каталогов DRLVM.  </p>
-                                <p><strong>Примечание</strong>: в ОС Windows, еÑ?ли корневаÑ? директориÑ? Ñ?иÑ?темы Ñ?борки находитÑ?Ñ? на много уровней ниже корневого каталога, излишне длинный путь к библиотеке клаÑ?Ñ?ов может вызвать ошибку при попытке выгрузить иÑ?ходный код. ДлÑ? решениÑ? Ñ?той проблемы, перемеÑ?тите корневую директори
 ю Ñ?иÑ?темы Ñ?борки выше по дереву каталогов или Ñ?мените операционную Ñ?иÑ?тему.  </p>
+                                <pre>$ svn co http://svn.apache.org/repos/asf/harmony/enhanced/trunk</pre>
+                                <p>Данная команда создаст дерево каталогов с пустыми директориями <code>common_resources</code>,
+        <code>working_classlib</code>, 
+        <code>working_vm</code> и <code>working_jdktools</code>. После загрузки исходного кода 
+        на следующем этапе, директория <code>working_classlib</code> будет содержать копию дерева 
+        каталогов библиотеки классов, директория <code>working_vm</code> - копию дерева каталогов DRLVM, 
+        и так далее. </p>
+                                <p><strong>Примечание</strong>: в ОС Windows, если корневая директория системы сборки находится 
+    на много уровней ниже корневого каталога, излишне длинный путь к библиотеке классов может вызвать 
+    ошибку при попытке загрузить исходный код. Для решения этой проблемы, переместите корневую директорию 
+    системы сборки выше по дереву каталогов или смените операционную систему.  </p>
                    
                                     
     <h2>
-        <a name="3. Сборка иÑ?ходного кода комплекта разработчика HDK">3. Сборка иÑ?ходного кода комплекта разработчика HDK</a>
+        <a name="3. Использование федеративной систему сборки">3. Использование федеративной систему сборки</a>
     </h2>
       
                         <a id="building" />
-                                <p> Ð?а Ñ?том Ñ?тапе Ñ?иÑ?тема готова Ñ?компилировать иÑ?ходный код. Во времÑ? первой Ñ?борки Ñ?иÑ?тема загружает вÑ?е необходимые дополнительные компоненты. СиÑ?тема Ñ?борки оповещает пользователÑ? об отÑ?утÑ?твии необходимых компонент или изменении в требованиÑ?х, так что процедуру загрузÐ
 и внешних компонент необходимо будет периодичеÑ?ки повторÑ?ть.  </p>
-                                <p>ДлÑ? того, чтобы загрузить необходимые дополнительные компоненты, иÑ?ходный код Harmony и поÑ?троить готовую Ñ?реду иÑ?полнениÑ? и комплект разработчика Harmony Java SE (HDK), в корневой папке Ñ?иÑ?темы Ñ?борки вызовите Ñ?ледующую команду:
+                                <p> На этом этапе система готова начать сборку. Во время первого запуска системы потребуется загрузка 
+    всех необходимых внешних компонент. Система сборки оповещает пользователя об отсутствии необходимых 
+    компонент или изменении в требованиях, так что процедуру загрузки внешних компонент необходимо 
+    будет периодически повторять.  </p>
+                                <p>Для того, чтобы загрузить необходимые сторонние компоненты, исходные тексты Harmony и построить 
+    готовую среду исполнения и комплекты разработчика Harmony Java SE (JRE, JDK и HDK), в корневой папке 
+    системы сборки вызовите следующую команду:
     </p>
                                 <pre>$ ant -Dauto.fetch=true</pre>
-                                <p>ДаннаÑ? команда выгружает вÑ?е Ñ?торонние компоненты, которые могут раÑ?проÑ?транÑ?тьÑ?Ñ? под различными лицензиÑ?ми, отличающимиÑ?Ñ? от лицензии Apache, Ñ?м. полный Ñ?пиÑ?ок лицензий в файле <code>THIRD_PARTY_NOTICES.txt</code> в корневой папке.  </p>
-                                <p>Выгружать дополнительные компоненты нужно только во времÑ? первого прогона Ñ?борки. ДлÑ? поÑ?ледующих прогонов, иÑ?пользуйте команду
+                                <p>Данная команда загружает сторонние компоненты, которые могут распространяться под различными 
+    лицензиями, отличающимися от лицензии Apache, см. полный список лицензий в файле 
+    <code>THIRD_PARTY_NOTICES.txt</code> в корневой папке.  </p>
+                                <p>Скачивать дополнительные компоненты потребуется только во время первого прогона сборки. 
+    Для последующих прогонов, достаточно использовать команду
     </p>
                                 <pre>$ ant</pre>
-                                <p> ДлÑ? поÑ?троениÑ? полной Ñ?борки рекомендуетÑ?Ñ? увеличить объем динамичеÑ?кой памÑ?ти (Java heap), иÑ?пользуемой программой Apache Ant.
-     ДлÑ? Ñ?того, измените значение переменной окружениÑ? ANT_OPTS в завиÑ?имоÑ?ти от вашей операционной Ñ?иÑ?темы, например:
+                                <p> Для построения полной сборки рекомендуется увеличить объем динамической памяти (Java heap), 
+    используемой программой Apache Ant. Для этого, измените значение переменной окружения ANT_OPTS 
+    доступным для вашей операционной системы способом, например:
     </p>
                                 <pre>ANT_OPTS='-Xms256m -Xmx512m' </pre>
-                                <p>ЕÑ?ли вы предполагаете иÑ?пользовать отдельные чаÑ?ти иÑ?ходного кода, вам не нужен веÑ?ь комплект разработчика. В таком Ñ?лучае, не вызывайте ant и Ñ?ледуйте пошаговой инÑ?трукции.  </p>
+                                <p>Если вы предполагаете использовать только отдельные части исходного кода, вам не обязательно 
+    строить весь комплект 
+    разработчика. В таком случае, не вызывайте ant и следуйте пошаговой инструкции как указано ниже.  
+    </p>
                    
                 <p class="backtotop"><a href="#top">Back to top</a></p>
                                         <h1>
-      <a name="ПошаговаÑ? инÑ?трукциÑ? Ñ?борки иÑ?ходного кода">ПошаговаÑ? инÑ?трукциÑ? Ñ?борки иÑ?ходного кода</a>
+      <a name="Пошаговая инструкция сборки отдельных компонент">Пошаговая инструкция сборки отдельных компонент</a>
     </h1>
                             
     <h2>
@@ -322,188 +371,126 @@
     </h2>
       
                         <a id="step-by-step" />
-                                <p>ДлÑ? извлечениÑ? дерева каталогов, иÑ?пользуйте Ñ?оответÑ?твующее имÑ?, указанное в Ñ?крипте <code>build.xml</code> в объединенной Ñ?иÑ?теме Ñ?борки. В корневой директории объединенной Ñ?иÑ?темы Ñ?борки, выполните Ñ?ледующую команду:
+                                <p>Для извлечения полного дерева каталогов для всех компонент, удобно использовать скрипт 
+    <code>build.xml</code> федеративной системы сборки. В корневой директории системы сборки, 
+    выполните следующую команду:
     </p>
                                 <pre>$ ant populate-src</pre>
-                                <p>ДаннаÑ? команда выкачивает библиотеку клаÑ?Ñ?ов и ВМ в директориÑ?х  <code>working_classlib</code> и <code>working_vm</code> Ñ?оответÑ?твенно, причем верÑ?иÑ? извлеченного кода Ñ?оответÑ?твует верÑ?ии файла <code>build.xml</code>. ПоÑ?кольку дерево каталогов довольно велико, извлечение вÑ?его каталога может занÑ?ть продолжительное времÑ?.  
 </p>
+                                <p>Данная команда скачивает из SVN репозитория исходные тексты библиотек классов, 
+    ВМ и утилит в директории <code>working_classlib</code>,
+    <code>working_vm</code> и <code>working_jdktools</code> соответственно, 
+    причем версия извлеченного кода соответствует версии файла <code>build.xml</code>. 
+    Поскольку дерево каталогов довольно велико, загрузка всех каталогов может занять продолжительное время.  </p>
+                                <p>
+    При желании, вы можете сэкономить время и сетевые ресурсы, скачав только интересующие вас компоненты вручную. 
+    В таком случае, для сборки вам дополнительно потребуется готовый пакет разработчика 
+      <a href="hdk.html">HDK</a>, который вы можете скачать с сайта Apache Harmony.
+    </p>
                    
                                     
     <h2>
         <a name="2. Обновление Дерева Каталогов">2. Обновление Дерева Каталогов</a>
     </h2>
       
-                        <p>По прошеÑ?твии времени, вы можете Ñ?инхронизировать вашу копию иÑ?ходного кода Ñ? текущей верÑ?ией на SVN репозитории, вызываÑ? команду <code>svn</code> update в нужной директории, например:
+                        <p>По прошествии времени, вы можете синхронизировать вашу копию исходного кода с текущей версией 
+    в SVN репозитории, вызывая команду <code>svn update</code> в нужной директории, например:
     </p>
                                 <pre>$ cd working_classlib
 $ svn update</pre>
-                                <p>Таким Ñ?поÑ?обом вы можете получать обновлениÑ? кода библиотеки клаÑ?Ñ?ов и ВМ. ПоÑ?ле иÑ?полнениÑ? команды в вашем дереве каталогов отобразÑ?тÑ?Ñ? вÑ?е изменениÑ?, внеÑ?енные в  SVN репозиторий поÑ?ле предыдущей Ñ?инхронизации. ЕÑ?ли у ваÑ? еÑ?ть доÑ?туп к репозиторию Ñ? правом запиÑ?и, вы можете заг
 ружать обновлениÑ? командой <code>svn checkin</code>. Примечание: еÑ?ли поÑ?ле обновлениÑ? дерева каталогов поÑ?влÑ?етÑ?Ñ? ошибка при поÑ?троении библиотеки клаÑ?Ñ?ов, удалите результаты предыдущей Ñ?борки командой
+                                <p>Таким способом вы можете получать обновления кода любого из компонент. 
+    После исполнения команды в вашем дереве каталогов отобразятся все изменения, внесенные в 
+    SVN репозиторий после предыдущей синхронизации. 
+    </p>
+                                <p class="note">Примечание:</p>
+                                <p class="notetext">
+    если после обновления дерева каталогов появляется ошибка при построении библиотеки классов, 
+    удалите результаты предыдущей сборки командой
     </p>
                                 <pre>$ ant clean</pre>
                    
                                     
     <h2>
-        <a name="3. Сборка библиотеки клаÑ?Ñ?ов">3. Сборка библиотеки клаÑ?Ñ?ов</a>
+        <a name="3. Сборка компонентов">3. Сборка компонентов</a>
     </h2>
       
-                        <p>Ð?а данном Ñ?тапе Ñ?иÑ?тема готова Ñ?компилировать иÑ?ходный код. Сначала проиÑ?ходит Ñ?борка библиотеки клаÑ?Ñ?ов, поÑ?кольку от нее завиÑ?ит Ñ?борка виртуальной машины, и наличие библиотеки клаÑ?Ñ?ов необходимо длÑ? функционированиÑ? вÑ?ей Ñ?реды иÑ?полнениÑ?.  </p>
-                                <p>Во времÑ? первой Ñ?борки Ñ?иÑ?тема загружает вÑ?е необходимые дополнительные компоненты. СиÑ?тема Ñ?борки оповещает пользователÑ? об отÑ?утÑ?твии необходимых компонент или изменении в требованиÑ?х, так что процедуру загрузки внешних компонент необходимо будет периодичеÑ?ки повт
 ¾Ñ€Ñ?ть.  </p>
-                                <p>ДлÑ? загрузки внешних компонент и Ñ?борки библиотеки клаÑ?Ñ?ов иÑ?пользуйте Ñ?ледующие команды:
+                        <p>На данном этапе система готова скомпилировать исходный код. Необходимо собирать компоненты в 
+    следующем порядке: сперва библиотеку классов, затем ВМ, затем утилиты. Это важно, поскольку между 
+    компонентами существуют зависимости, каждая последующая компонента использует результаты сборки
+    предыдущей.
+    </p>
+                                <p>
+    Все компоненты имеют унифицированные интерфейсы к системам сборки, т.е. они поддерживают
+    одинаковый базовый набор команд и переменных. Поэтому последующие шаги даются на примере
+    библиотеки классов, но применимы ко всем другим компонентам.
+  </p>
+                                <p>Во время первой сборки система загружает все необходимые сторонние компоненты. 
+    Система сборки оповещает пользователя об отсутствии необходимых компонент или изменении в требованиях, 
+    так что процедуру загрузки внешних компонент потребуется периодически повторять.  </p>
+                                <p>Для загрузки внешних компонент и сборки библиотеки классов используйте следующие команды:
     </p>
                                 <pre>$ cd working_classlib
 $ ant fetch-depends
 $ ant</pre>
-                                <p>ДлÑ? теÑ?тированиÑ? библиотеки клаÑ?Ñ?ов вам необходима виртуальнаÑ? машина. ЕÑ?ли у ваÑ? уже еÑ?ть ВМ, запуÑ?тите полный набор теÑ?тов длÑ? библиотеки клаÑ?Ñ?ов Ñ?ледующей командой:
+                                <p> Теперь вы можете протестировать результаты сборки. Каждая компоненты включает
+    достаточно полный набор тестов на функциональность и должна успешно выполнять 100% из них.
+    Примечание: для тестирования библиотеки классов вам необходима виртуальная машина. 
+    Вы можете использовать не только DRLVM, см. раздел 
+    <a href="#assemble-jdk">Конструирование среды исполнения</a>. 
+    Если вы хотите тестировать библиотеку классов вместе с DRLVM, приступайте к сборке DRLVM.<br />
+    Выполните следующую команду для построения и прогона полного набора тестов:
     </p>
                                 <pre>$ ant test</pre>
-                                <p>ДлÑ? теÑ?тированиÑ? подходит не только виртуальнаÑ? машина DRLVM, Ñ?м. раздел СоÑ?тавление Ñ?реды иÑ?полнениÑ? из поÑ?троенных компонент. ЕÑ?ли вы хотите теÑ?тировать библиотеку клаÑ?Ñ?ов вмеÑ?те Ñ? DRLVM, Ñ?ледуйте дальнейшим инÑ?трукциÑ?м длÑ? ее Ñ?борки.  </p>
-                   
-                                    
-    <h2>
-        <a name="4. Сборка виртуальной машины DRLVM">4. Сборка виртуальной машины DRLVM</a>
-    </h2>
-      
-                        <h3>4.1. Перейдите в директорию build.</h3>
-                                <p>ПоÑ?ле Ñ?борки библиотеки клаÑ?Ñ?ов, поÑ?тройте ВМ длÑ? получениÑ? функционирующей Ñ?реды иÑ?полнениÑ?.
-    ДлÑ? Ñ?того, вернитеÑ?ь в корневую директорию объединенной Ñ?иÑ?темы Ñ?борки и перейдите в директорию
-    <code>working_vm</code>, а затем в поддиректорию build: </p>
-                                <pre>$ cd working_vm/build</pre>
-                                <h3>4.2. Ð?аÑ?тройте рабочее окружение.</h3>
-                                <ul>
-        <li> ВнеÑ?ите изменениÑ? в файл <code>drlvm.properties</code>.
-        <p>Укажите Ñ?иÑ?теме Ñ?борки DRLVM директорию Ñ? библиотекой клаÑ?Ñ?ов: в директории <code>build</code>
-        переименуйте файл <code>drlvm.properties.example</code> в <code>drlvm.properties</code>. </p>
-        <pre>$ cp drlvm.properties.example drlvm.properties</pre>
-        <p>Этот файл Ñ?одержит значение параметра, Ñ?ообщающего Ñ?иÑ?теме Ñ?борки DRLVM,
-        что библиотека клаÑ?Ñ?ов находитÑ?Ñ? в директории <code>working_classlib</code>.
-        ДлÑ? того чтобы указать другую Ñ?борку библиотеки клаÑ?Ñ?ов, укажите другой файл
-         Ñ? Ñ?оответÑ?твующим значением при вызове команды Ñ?борки. </p>
-        <p>Проверьте, что в иÑ?пользуемом файле параметр <code>deploy.canonical.flag</code>
-        имеет значение TRUE. Этот параметр позволÑ?ет Ñ?иÑ?теме Ñ?борки Ñ?оздать директорию
-        <code>deploy/jre/bin</code>, котораÑ? понадобитÑ?Ñ? на Ñ?ледующих Ñ?тапах Ñ?борки.  </p>
-        </li>
-
-        <li> Укажите иÑ?пользуемый компилÑ?тор.
-        <p>ДлÑ? того чтобы перейти на другой компилÑ?тор или режим Ñ?борки
-        Ñ? помощью переменных окружениÑ?, иÑ?пользуйте Ñ?ледующие команды: </p>
-               <table>
-                  <tr>
-                    <th class="TableHeading">
-                      КомпилÑ?тор
-                    </th>
-                    <th class="TableHeading">
-                       Windows
-                    </th>
-                    <th class="TableHeading">
-                       Linux
-                    </th>
-                  </tr>
-                  <tr>
-                    <td class="TableCell">
-                      MSVC compiler
-                    </td>
-                    <td class="TableCell">
-                      set CXX=msvc
-                    </td>
-                    <td class="TableCell">
-                      N/A
-                    </td>
-                  </tr>
-                  <tr>
-                    <td class="TableCell">
-                      Intel(R) compiler
-                    </td>
-                    <td class="TableCell">
-                      set CXX=icl
-                    </td>
-                    <td class="TableCell">
-                      export CXX=icc
-                    </td>
-                  </tr>
-                  <tr>
-                    <td class="TableCell">
-                      GCC compiler
-                    </td>
-                    <td class="TableCell">
-                      N/A
-                    </td>
-                    <td class="TableCell">
-                      export CXX=gcc
-                    </td>
-                  </tr>
-                </table>
-                </li>
-        <li>Укажите режим Ñ?борки: отладочный (debug) или рабочий (release).
-        <p>По умолчанию, Ñ?иÑ?тема Ñ?борки работает в отладочном режиме. ДлÑ? переключениÑ? в рабочий режим, выполните Ñ?ледующие команды: </p>
-        <p><strong>Windows</strong>: </p>
-        <pre>&gt; set BUILD_CFG=release
-&gt; build.bat</pre>
-        <p><strong>Linux</strong>:
-        </p>
-        <pre>$ BUILD_CFG=release ./build.bat</pre>
-        </li></ul>
-                                <h3>4.3. Загрузите дополнительные компоненты.</h3>
-                                <p>Перед тем, как запуÑ?тить Ñ?борку, необходимо загрузить вÑ?е дополнительные компоненты. Обратите внимание: Ñ?та операциÑ? может занÑ?ть длительное времÑ?.   </p>
-                                <p><strong>Windows</strong>: </p>
-                                <pre>C:...\trunk\working_vm\build&gt;build.bat update </pre>
-                                <p><strong>Linux</strong>: </p>
-                                <pre>$ sh build.sh update </pre>
-                                <h3>4.4 ЗапуÑ?тите Ñ?борку кода.</h3>
-                                <p>Чтобы запуÑ?тить Ñ?борку, вызовите Ñ?ледующую команду:  </p>
-                                <p><strong>Windows</strong>: </p>
-                                <pre>C:...\trunk\working_vm\build&gt;build.bat</pre>
-                                <p><strong>Linux</strong>: </p>
-                                <pre>$ sh build.sh</pre>
-                                <h3>4.5. ЗапуÑ?тите набор теÑ?тов длÑ? проверки правильноÑ?ти Ñ?борки.</h3>
-                                <p>ДлÑ? проверки правильноÑ?ти Ñ?борки, запуÑ?тите набор теÑ?тов acceptance tests командой:  </p>
-                                <p><strong>Windows</strong>: </p>
-                                <pre>C:...\trunk\working_vm\build&gt;build.bat test</pre>
-                                <p><strong>Linux</strong>: </p>
-                                <pre>$ sh build.sh test</pre>
-                                <p><strong>Примечание</strong>: в наÑ?тоÑ?щее времÑ?, kernel теÑ?ты не проходÑ?т.
-    ДлÑ? уÑ?пешного прохождениÑ? теÑ?тов, иÑ?пользуйте C Unit и Smoke теÑ?ты.  </p>
-                                <p>Сборка виртуальной машины уÑ?пешно завершена. ПолнаÑ? функционирующаÑ? Ñ?реда иÑ?полнениÑ? готова к иÑ?пользованию и находитÑ?Ñ? в директории <code>deploy/jre</code> внутри директории <code>build</code>.  Чтобы Ñ?то проверить, вы можете, например, узнать верÑ?ию иÑ?пользуемой Ñ?реды иÑ?полнениÑ?:
-</p>
-                                <pre>$ cd deploy/jre/bin
-$ ./java -version
-Apache Harmony Launcher:
-(c) Copyright 1991, 2006 The Apache Software Foundation or its licensors, as applicable.
-java version "1.5.0"
-pre-alpha : not complete or compatible
-svn = r479551, (Nov 27 2006), Windows/ia32/msvc 1310, debug build
-http://harmony.apache.org
-</pre>
+                                <p>
+    Сборка завершена. Результаты сборки для каждого компонента находятся 
+    в директории <code>deploy/jdk/jre</code> внутри соответствующего рабочего пространства.
+    </p>
+                                <p class="note">Примечание</p>
+                                <p class="notetext">
+      DRLVM создаёт директорию deploy только если переменная <code>deploy.canonical.flag</code> 
+      была выставлена в значение <code>TRUE</code>. В противном случае результаты сборки
+      расположены глубже по дереву каталогов как <code>build/&lt;ваша-платформа&gt;/deploy/jdk/jre</code>.
+    </p>
+                                <p> 
+     Вы можете получить дополнительную информацию о доступных командах и опциях для 
+     каждого из компонент при помощи команды:
+    </p>
+                                <pre>$ ant help</pre>
                    
                                     
     <h2>
-        <a name="5. КонÑ?труирование Ñ?реды иÑ?полнениÑ? из Ñ?компилированных компонент">5. КонÑ?труирование Ñ?реды иÑ?полнениÑ? из Ñ?компилированных компонент</a>
+        <a name="5. Конструирование среды исполнения из скомпилированных компонент">5. Конструирование среды исполнения из скомпилированных компонент</a>
     </h2>
       
-                        <p>Разработчики библиотек клаÑ?Ñ?ов могут иÑ?пользовать виртуальную машину DRLVM
-    или уÑ?тановить другую Ñ?овмеÑ?тимую ВМ. Ð?апример, вы можете иÑ?пользовать IBM
-    virtual machine котораÑ? была предоÑ?тавлена компанией IBM длÑ? нужд разработчиков
-     проекта на уÑ?ловиÑ?х пробной, не открытой лицензии на выполнÑ?емый код.
-     ДлÑ? уÑ?тановки ВМ Ñ?ледуйте прилагающейÑ?Ñ? документации. Вы можете развернуть
-     дерево каталогов библиотек клаÑ?Ñ?ов поверх дерева каталогов Harmony,
-     так что директории 'jdk' Ñ?овпадут.  </p>
+                        <a id="assemble-jdk" />
+                                <p>Разработчики библиотек классов могут использовать виртуальную машину DRLVM
+    или установить другую совместимую ВМ. Например, вы можете использовать IBM
+    virtual machine которая была предоставлена компанией IBM для нужд разработчиков
+     проекта на условиях пробной, не открытой лицензии на выполняемый код.
+     Для установки ВМ следуйте прилагающейся документации. Вы можете развернуть
+     дерево каталогов библиотек классов поверх дерева каталогов Harmony,
+     так что директории 'jdk' совпадут.  </p>
                                 <p><strong>Windows</strong>: </p>
                                 <pre>$ unzip &lt;path_to_vm_zip&gt; -d ../..</pre>
                                 <p><strong>Linux</strong>: </p>
                                 <pre>$ tar xzf &lt;path_to_vm_tarball&gt; --directory ../..</pre>
-                                <p>ДлÑ? работы Ñ? библиотекой клаÑ?Ñ?ов Harmony, иÑ?пользуйте подробную
-    документацию длÑ? Ñ?того компонента.  Разработчики виртуальной машины
-    DRLVM иÑ?пользуют ВМ, поÑ?троенную в результате Ñ?борки, то еÑ?ть
-    Ñ?реду иÑ?полнениÑ?, Ñ?оÑ?тоÑ?щую из DRLVM и библиотеки клаÑ?Ñ?ов.  </p>
+                                <p>Для работы с библиотекой классов Harmony, используйте подробную
+    <a href="subcomponents/classlibrary/index.html">документацию</a> для этого компонента. 
+    </p>
+                                <p> Разработчики виртуальной машины
+    DRLVM могут пользоваться результатами сборки DRLVM напрямую, они включают в себя полную 
+    среду исполнения Java, состоящую из DRLVM и библиотеки классов.  </p>
                    
                 <p class="backtotop"><a href="#top">Back to top</a></p>

[... 20 lines stripped ...]


Mime
View raw message