Главная » Processing » Создание библиотек Processing в проекте Eclipse

0

Приступим

Создание библиотек всегда было непростым занятием, так как работа в проекте Eclipse требовала знания среды и навыков. Команда Processing приложила немало усилий для создания шаблона для Eclipse, чтобы упростить этот процесс. Скачать его можно по адресу: http://code.google.com/p/processing/downloads; распаковывать архив не нужно.

Как это делается

Теперь, когда вы скачали шаблон Library, давайте установим его в Eclipse, чтобы вы могли создать вашу собственную библиотеку. Если вы все еще в перспективе Processing, смите ее обратно в перспективу Java. Откройте меню Window | Open Perspective | Other, выберите перспективу Java (default) и кликните по кнопке OK.

Создайте новы проект Java, открыв меню File | New | Java Project. Введите имя библиотеки в поле Project Name. Я назову библиотеку MyLib. Вы увидите, что Eclipse создаст папку в вашем рабочем пространстве с именем библиотеки. Кликните по кнопке Finish для создания проекта.

Кликните правой кнопкой мыши по папке MyLib и выберите в меню Import. В окне Import

выберите Archive File в папке General и кликните Next.

Кликните по кнопке Browse и выберите шаблон библиотеки – только что скачанный файл

.zip. Кликните Finish для импорта всех файлов из архива в ваш проект.

Затем нам нужно импортировать из Processing в проект файл core.jar. На Windows вы сможете найти этот файл в папке lib рядом с приложением Processing. На Mac вам потребуется открыть приложение Processing, потому, что файл будет где-то там. Для этого выберите в файндере приложение Processing, кликните по нему правой кнопкой мыши и выберите в меню пункт Show Package Contents. Файл core.jar вы найдете в папке Contents | Resources | Java. Выделите его и скопируйте на рабочий стол. Не удаляйте его; в противном случае приложение Processing не будет работать.

Откройте папку workspace в Eclipse и создайте новую папку под именем libs. Перетите в эту папку только что скопированный на рабочий стол файл core.jar. Ваша папка workspace будет выглядеть так, как показано на этом скриншоте:

Затем нам нужно добавить к проекту файл core.jar. Кликните правой кнопкой мыши по папке MyLib и выберите Properties. В списке в левой части окна выберите Java Build Path и кликните по вкладке Libraries вверху окна, так, как показано на этом скриншоте.

Кликните Add External JARs и выберите файл core.jar из папки / workspace/libs.

Кликните Open для добавления файла в ваш проект.

Откройте папку resources из проекта вашей библиотеки в Package Explorer и сделайте двойной клик по файлу build.properties для его открытия. Этот файл содержит некоторые настройки, необходимые процессу сборки для компиляции библиотеки и генации документации. Если в качестве папок по умолчанию вы выбрали скетчбук Processing и рабочее пространство Eclipse, вам не придется вносить больших изменений в этот файл. Просто просмотрите комментарии в этом файле и проверьте правильность расположения папок sketchbook.location, classpath.local.location, classpath. local.include и classpath.libraries.location. Также вам нужно переименовать проект в MyLib. Вы найдете это свойство под (4) в документе.

project.name=MyLib

Вам также нужно изменить свойства под (5) в файле build.properties. Они содержат общую информацию о вашей библиотеке: ваше имя, веб-сайт и описание библиотеки.

Итак, мы достигли конца этого примера. Шаблон библиотеки установлен. Осталось последнее, что нужно сделать: скомпилировать библиотеку и посмотреть, что получилось. Откройте меню Window | Show View | Ant. Вы увидите вкладку Ant в правой части.

Перетащите файл build.xml из папки resources вашего проекта во вкладку Ant. Вы увидите пункт ProcessingLibs, который появится в окне, содержащий все шаги, необхимые для компиляции вашей библиотеки, генерациии документации и других. Выберите пункт ProcessingLibs и кликните по кнопке play во вкладке Ant.

Если все сделано верно, вы увидите массу текста на панели консоли в нжней части экрана. Последней строкой должно быть BUILD SUCCESSFUL. Если последняя строка гласит: BUILD FAILED, что-то пошло не так и вам придется покапаться в сообщениях на консоли, чтобы обнаружить проблему.

Как это работает

Когда я начал писать библиотеки, этого шаблона еще не существовало. Для написания кода я использовал простой текстовый редактор, а для компиляции кода – командную строку; я должен был вручную собирать файлы и упаковывать их для распространения. Использование Eclipse при создании библиотек облегчило задачу, теперь можно экспортировать код как файл *.jar. Шаблон библиотеки выполняет всю рутину за вас м позволяет вам сосредоточиться на создании прекрасной библиотеки. Давайте перечиим, что этот шаблон делает для вас.

Если вы взглянете на проект в Package Explorer, вы увидите массу папок. Все они содержат файлы, требуемые для создания и последующего распространения библиотеки. Рассмотрим их подробнее:

f    Папка src содержит исходный код библиотеки на Java.

f   Папка JRE System Library содержит ссылки на файлы из Java Runtime Environment, необходимые для компиляции нашей библиотеки.

f   Referenced Libraries содержит ссылку на основной файл Processing – core.jar, который мы добавили.

f   Папка data содержит изображения, звуки и все, что нужно для библиотеки.

f   Папка distribution содержит, все, что нужно для распространения библиотеки.

f   Папка examples используется для хранения примеров скетчей для нашей библиотеки. Эти примеры нужны для пользователей библиотеки, чтобы они понимали, как с ней работать.

f   lib содержит сторонние файлы .jar для библиотеки, если вы их добавили.

f   resources содержит файлы для процесса сборки. В процессе установки вы использовали файлы build.properties и build.xml. Файл stylesheet.css создает понятную документацию JavaDoc. Стандартные файлы документации Java выглядят ужасно.

f   Папка web содержит шаблон html. Он нужен для создания небольшого веб-сайта вашей библиотеки на основе информации приведенной под (5) в файле build. properties.

Если сборка пройдет успешно, вы увидите папку MyLib. После этого вы можете загрузить ее на сервер для скачивания.

Источник: Ян Вантомм, Processing 2: креативное программирование, перевод с английского Александры Мишутиной, Published by Packt Publishing Ltd., 2012, BIRMINGHAM – MUMBAI.

По теме:

  • Комментарии