Это перевод, оригинал находится здесь

Установка Eclipse на компьютер

Вы можете скачать Eclipse отсюда Eclipse downloads. Если вам нужен Eclipse только для программирования под leJOS NXJ - вам понадобятся только возможности стандартной Java - вам не нужна версия, которая поддерживает Java Enterprise Edition или другие языки, такие как C++ или версия, поддерживающая разработку плагинов для Eclipse. Установочный пакет "Eclipse IDE for Java Developers" вполне достаточен для leJOS NXJ. Убедитесь, что вы скачиваете установочный пакет именно для вашей операционной системы. При этом обратите внимание на то, что даже если у вас 64-битная версия Windows, вам нужна 32-битная версия Eclipse для программирования под leJOS NXJ. Примеры, данные в этом разделе расчитаны на Microsoft Windows, но процесс установки сходен и в других операционных системах. Если вы используете Linux, для вашего дистрибутива, возможно, есть свой установочный пакет Eclipse, который вы предпочтёте использовать.

Распакуйте пакет, который вы скачали в отдельную директорию. Если вы распакуете его на диск C:\, то директория с Eclipse будет называться C:\eclipse.

Вы можете запустить Eclipse путём запуска файлаeclipse.exe из директории, куда вы распаковали Eclipse. Возможно, вы захотите создать ярлык для eclipse.exe на рабочем столе.

При первом запуске Eclipse, вам будет предложено выбрать workspace:

Можно оставить его по умолчанию, или вы можете работать с несколькими workspace-ами и создать такой workspace для ваших проектовleJOS.

Когда вы нажмёте OK, IDE откроет "приветственный экран". После закрытия этого окна, Eclipse будет выглядить следующим образом:

Эта обучающая страничка проведёт вас через процесс инсталляции плагина leJOS, создание проектов leJOS для NXT и PC, и запуск проектов-примеров для NXT и PC которые идут с leJOS.

Наверх страницы

Установка плагина Eclipse

Наиболее предпочтительный способ настройки проекта под leJOS с помощью Eclipse это использование плагина leJOS Eclipse. Этот плагин позволит вам создать NXT проекты для написания программ на Java, которые можно будет запускать как на самом "кирпиче" NXT, так и на PC (для дистанционного управления "кирпичом" через USB или Bluetooth).

Чтоб установить leJOS, щёлкните по пункту меню Help и выберите "Install New Software..." как показано ниже.

Когда вы увидите следующий диалог, введите "http://lejos.sourceforge.net/tools/eclipse/plugin/nxj/" в поле помеченное "Work with:". Затем нажмите enter. Eclipse проверит сайт обновлений и покажет список доступных компонент:

Выберите установку плагина leJOS и нажмите кнопку Next. Прокликайте через несколько следующих диалогов и в конечном итоге кликните Finish. Eclipse начнёт скачивание плагина. Плагин leJOS не имеет электронной подписи, поэтому появится следующее предупреждение:

Нажмите OK и Eclipse продолжит установку плагина:

Дождитесь, пока не появится сообщение о необходимости перезапустить Eclipse:

Кликните "Restart Now" и Eclipse перезапустится.

Обратите внимание, что появилась новая кнопка leJOS на панели инструментов. Вы можете прочитать справку по этому плагину путём выбора в меню Help | Help Contents | leJOS NXJ.

Было бы неплохо ознакомиться со страничкой помощи по плагину, чтоб понять его немного лучше.

Чтоб сконфигурировать плагин для работы в вашей системе, выберите в меню Window | Preferences | leJOS NXJ.

Выберите директорию, куда вы установили leJOS NXJ и выберите её как NXJ_HOME. Выберите любые другие опции, которые вам потребуются. Полезно также включить опцию "Verbose". Такая установка является установкой по умолчанию (defaults) для созданных конфигураций запуска (Run Configurations). Ниже будет показано, как их редактировать.

Когда вы закончите установку всех необходимых настроек, нажмите "Apply" и затем "OK".

Теперь плагин установлен и готов к работе.

Вы можете загрузить прошивку leJOS NXJ на "кирпич" NXT из плагина кликнув в меню на пункт "leJOS NXJ" и выбрав "Upload Firmware" или кликнув на кнопку leJOS на панели инструментов. Это приведёт к запуску утилиты NXJFlash.

Чтоб создать новый проект leJOS NXJ с использованием плагина, откройте меню "File" и выберите "New", затем "Project..."" как показано ниже:

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

Откройте визард (мастер, диалог создания) нового проекта, как показано выше. Раскройте пункт LeJOS и выберите "LeJOS NXT Project" как показано ниже:

Это запустит визард (мастер) создания нового проекта leJOS NXT:

Введите имя проекта и нажмите Finish. Вернитесь в главное окно Eclipse, вы увидите новый проект. Обратите внимание, что файл classes.jar (который подменяет собой Java Runtime) уже включён в список путей для сборки проекта. Также обратите внимание на маленькую иконку leJOS рядом с именем проекта. Она означает, что этот проект только для NXT-программ.

Сейчас кликните правой кнопкой папку src и выберите "New" и затем "Class" в контекстном меню как показано ниже:

Откроется мастер создания нового Java-класса :

Введите имя пакета и имя класса В примере было выбрано имя класса HelloWorld. Имя пакета com.mydomain соответствует интернет-домену "mydomain.com". Убедитесь, что выбираете правильное имя. Обычно, имя пакета состоит из доменного имени с обратным порядком слов и следующего за ним имени проекта.

Как только вы выберите Finish, будет открыт редактор для класса. Теперь можно начинать программирование. На скриншоте показан следующий код:

package com.mydomain;

import lejos.nxt.Button;

public class HelloWorld {
    /**
     * @param args
     */
    public static void main(String[] args) {
        System.out.println("Hello World!");
        Button.waitForAnyPress();
    }
}

Программа выведет на экран "Hello World!" на LCD экран NXT-кирпича и будет ожидать нажатия любой кнопки. Конечно, вы можете добавить другие классы и пакеты к проекту.

Когда вы будете готовы к загрузке программы в "кирпич", кликните правой кнопкой мыши на классе, который содержит метод main. Выберите "Run As"→"LeJOS NXT Program" в контекстном меню.

Обратите внимание: не выбирайте "Run As"→"Java Application" т.к. это приведёт к локальному запуску программы на обычной виртуальной машине Javaи со стандартным Java runtime. Это не сработает и обычно приводит к ошибкам.

Вы можете увидеть информацию на консоли leJOS NXJ. Обратите внимание, что два дополнительных файла были созданы в корневой директории проекта. Файл nxj это один из файлов, загружаемых в "кирпич" NXT. Файл nxd предназначен для отладки.

Если вы выбрали опцию "Run program after upload", программа будет запущена на "кирпиче" NXT как только будет закончена загрузка.

Создание проекта для PC

Откройте мастер нового проекта, как было показано выше. Раскройте пункт LeJOS и выберите "LeJOS PC Project" как показано ниже:

Это приведёт к открытию мастера создания нового проекта leJOS для PC:

Введите имя проекта и нажмите Finish. Вернитесь в основное окно Eclipse, вы увидите новый проект. Обратите внимание, что такие JAR файлы как pccomm.jar и т.д. и файлы, зависимые от них уже включены в список путей для сборки. Обратите внимание, что у проектов для PC нет маленькой иконки leJOS рядом с именем проекта.

Кликните правой кнопкой папку src и выберите "New" затем "Class" в контекстном меню, как показано ниже:

Откроется мастер создания новых классов Java:

Введите имя пакета и имя класса. В примере было выбрано имя проекта HelloWorld. Имя пакета com.mydomain соответствует интернет-домену "mydomain.com". Убедитесь, что введены корректные имена. Обычно, имя пакета состоит из имени домена с обратным порядком слов и следующего за ним имени проекта.

Как только вы нажмёте Finish, откроется редактор класса. Теперь можно приступать к программированию. Пример на скриншоте показывает следующий код:

package com.mydomain;

import lejos.nxt.Motor;

public class HelloWorld {
    /**
     * @param args
     */
    public static void main(String[] args) {
        System.out.println("Hello World!");
        Motor.A.forward();
    }
}

Программа напечатает "Hello World!" локально, на PC. Затем она попытается соединиться с любым NXT-"кирпичом" и запустит электродвигатель, подключенный к Порту A. Естественно, вы можете добавлять другие классы и пакеты к этому проекту.

Когда вы будете готовы к запуску программы, кликните правой кнопкой на классе, содержащем методmain. Выберите "Run As"→"Java Application" в контекстном меню.

Вы увидите выводимую информацию на локальной консоли в Eclipse. Обратите внимание на строку, следующую за "Hello World!" которая показывает, что программа соединилась с "кирпичом" NXT.

Редактирование конфигураций запуска (run configurations)

При выборе запуска программы под LeJOS NXT или Java приложения в создаётся так называемая конфигурация запуска (run configuration). Её можно редактировать для того, чтоб изменить определённые параметры. В примере ниже включена опция verbose для линковки для данной Run Configuration. Сначала выберите "Run"→"Run Configurations..." в меню:

Откроется следующий диалог. Выберите Run Configuration которую вы хотите изменить:

После внесения всех изменений, нажмите "Apply" и затем "Run" либо "Close". После включения режима линковки с предупреждениями (verbose), вывод консоли во время загрузки программы в "кирпич" изменится:

Linking ...
Class 0: java.lang.Object
Class 1: java.lang.Throwable
Class 2: java.lang.Error
Class 3: java.lang.OutOfMemoryError
Class 4: boolean
Class 5: char
Class 6: float
...
Class 74: lejos.nxt.NXT
Method 0: java.lang.Object.<init>() PC 3880 Signature id 2
Method 1: java.lang.Object.getClass() PC 3881 Signature id 125
Method 2: java.lang.Object.toString() PC 3889 Signature id 127
Method 3: java.lang.Object.wait(long) Native id 8
Method 4: java.lang.Throwable.<init>() PC 3917 Signature id 2
Method 5: java.lang.Throwable.<init>(java.lang.String) PC 3927 Signature id 129
Method 6: java.lang.Throwable.getCause() PC 3942 Signature id 133
...
Method 163: lejos.nxt.NXT.getUserPages() Native id 93
Master record    : 20 bytes.
Class records    : 75 (900 bytes).
Field records    : 61 (64 bytes).
Static fields    : 38 (76 bytes).
Static state     : 38 (144 bytes).
Constant records : 40 (160 bytes).
Constant values  : 40 (524 bytes).
Method records   : 164 (1968 bytes).
Exception records: 20 (160 bytes).
Interface maps   : 3 (4 bytes).
Code             : 126 (3852 bytes).
Total            : 7732 bytes.
Run time options : EnableCompact 
Constant loads   : 40N 8O 1W 39S
Static load/store: 6N 85O
Field  load/store: 2N 91O
Program has been linked successfully
Uploading ...
Found NXT: NXT-51 001653114B51
leJOS NXJ> Upload successful in 1342 milliseconds
program has been uploaded

Дополнительная информация позволит вам расшифровать числа, содержащиеся в дампе стека, который появляется на ЖК экране "кирпича", когда возникает исключение.

Импортирование примеров в Eclipse

Плагин содержит специальный мастер импорта в Eclipse проектов-примеров, которые идут вместе с leJOS. Выберите "File"→"Import..." в меню.

Раскройте пункт General и выберите "leJOS samples and project templates".

Нажмите "Next", и вы увидите следующий диалог, который позволит выбрать импортируемый проект. Обратите внимание, что вы не можете импортировать проект, если проект с таким именем уже есть в workspace.

После нажатия кнопки Finish, импортированный проект появится в главном окне.

Наверх страницы

Использование примеров проектов NXT

Разверните проект примера и кликните правой кнопкой мыши на проекте, который вы хотите запустить. Вы должны выбрать класс, который содержит метод main method. Если вы не знаете, в каком классе этот метод, кликните правой кнопкой на пакете. Выберите "Run As"→"LeJOS NXT Program" и пример будет слинкован и загружен в "кирпич" NXT.

Наверх страницы

Использование примеров проектов для PC

Разверните проекты для PC (поддерево) и кликните правой кнопкой мыши на примере, который вы хотите запустить. Вы должны выбрать класс, содержащий метод main. Если не знаете, что это за класс, кликните правой кнопкой на пакете. Выберите "Run As"→"Java Application" и пример будет запущен.

Наверх страницы

Использование примеров

Примеры - это хороший пример того, как надо создавать проекты для leJOS в Eclipse, которые так же содержат сборочный Ant-файл. Кроме build.xml, эти проекты идентичны таковым, созданным мастером проектов, описанным выше.

org.lejos.example это пример проекта программы выполняемой на стороне NXT-"кирпича" и, следовательно build.xml включает в себя необходимые задачи для сборки и загрузки программы. org.lejos.pcexample это пример проекта программы, выполняемой на стороне PC, который дистанционно управляет кирпичом NXT. Ant-скрипт автоматически включает все необходимые JAR файлы, которые должны быть включены в classpath проекта.

Чтоб использовать их как шаблон, импортируйте их как указано выше и переименуйте проект. Хорошей практикой является включение названия вашей организации в имя проекта и избегание имён, которые могут конфликтовать с другими проектами в workspace-е. Однако, если вы единственный пользователь проекта, это делать не обязательно. Затем отредактируйте файл the build.properties, который содержит все важные параметры, как например, имя основного класса.

Для того, чтоб попробовать Ant скрипт из Eclipse, кликните правой кнопкой на файле build.xml и выберите "RunAs"→"Ant Build". В случае, если это проект примера, вы должны увидеть подробный вывод линковщика в консольном окне Eclipse и затем бинарный файл будет загружен на "кирпич" NXT и запущен.

Если вы захотите собрать другую цель - кликните на ней правой кнопкой и выберите "Run As"→"Ant Build...".

Наверх страницы

Установка GUI-инструментария leJOS

leJOS NXJ идёт с набором GUI-инструментария, который может быть использован для прошивки "кирпича", узнавания, какие файлы загружены на NXT, мониторинга и отладки программ на NXT, выкачивания файлов логов с NXT и т.д. Он полезен, чтоб иметь возможность запускать эти инструменты как из Eclipse, так и в качестве внешнего инструментария.

Чтоб создать внешний инструмент, кликните на треугольную стрелочку вниз рядом с иконкой запуска внешних инструментов на панели инструментов и выберите "External Tools Configuration":

Затем выберите "Program" и кликните на кнопку "New Launch Configuration", вы должны будете увидеть:

Наберите имя вашей конфигурации (например "NXJ Flash" (прошить NXJ)), кликните на кнопку Browse File System, найдите директорию bin в месте, куда вы установили leJOS NXJ и выберите nxjflashg.bat.

Если у вас есть несколько установленных копий leJOS, вы можете зайти во вкладку Environment и настроить NXJ_HOME на одну из директорий, где установлен leJOS.

Другой GUI-инструментарий, который вы должны установить, включает

• nxjbrowse - Эксплорер (проводник) для файлов NXJ
• nxjconsoleviewer - GUI просмотрщик для отладочного вывода RConsole/li>
• nxjmonitor - Удалённое мониторирование программ, запущенных на NXT
• nxjdataviewer - GUI-tool для перекачки логов с "кирпича" NXT
• nxjcontrol - GUI-tool, который комбинирует функцию всех вышеперечисленныйх инструментов и добавляет ноые.

Возможно, вы захотите также установить инструменты такие командной строки как:

• nxjflash - консольная утилита для прошивки
• nxjconsole - консольный просмотрщик для удалённой отладки
• nxjsocketproxy - прокси для связи с PC и программами из Интернет, использующими сокеты

Наверх страницы