Anthill Game Framework

Tiny framework for creating Flash games.

Инструменты пользователя

Инструменты сайта


extensions:guidelines

Рекомендации для расширений и плагинов

Расширение (дополнение) — это дополнительные классы, реализующие решение определенных задач и расширяющие возможности Anthill. Например, в качестве расширения может быть реализован поиск пути, обертка для работы с физическими движками и т.п.

Так же в качестве расширений для Anthill могут выступать и плагины. Плагин от расширения отличается только тем, что должен следовать определенным условиям, чтобы встраиваться в структуру Anthill и обрабатываться. Подробнее о разработке и использовании плагинов читайте в разделе «Создание и использование плагинов». В остальном рекомендации к разработке плагинов и расширений идентичны.


Рекомендации

  1. При разработке плагина или расширения ни в коем случае не изменяйте исходный код Anthill, чтобы гарантировать работу вашего расширения на последующих версиях Anthill и не затруднять пользователям возможность обновления до новых версий.
  2. Создавая плагин, помещайте его в пакет ru.antkarlov.anthill.plugins — так пользователи смогут легко находить, просматривать и обновлять используемые плагины. Если ваш плагин состоит более чем из одного класса, то вы можете создать свой пакет (папку) в ru.antkarlov.anthill.plugins.
  3. Создавая расширение, помещайте его в пакет ru.antkarlov.anthill.extensions — так пользователи смогут легко находить, просматривать и обновлять используемые расширения. Если расширение состоит более чем из одного класса, то вы можете создать свой пакет (папку) в ru.antkarlov.anthill.extensions.
  4. Если вы создали расширение или плагин, реализующее интересные возможности, то не стесняйтесь, и выкладывайте его на странице расширений для Anthill. Вероятно, ваше расширение может пригодиться многим людям и, возможно, вы получите не только положительные отзывы за проделанную работу, но и советы о том, как его улучшить.

Создание Wiki страницы для расширения или плагина

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

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

http://anthill.ant-karlov.ru/wiki/extensions:your_extension_name

Чтобы создать страницу для своего расширения, следуйте следующим шагам:

  1. Убедитесь что вы залогинились в Wiki.
  2. Cкопируйте представленную выше ссылку в адресную строку вашего браузера.
  3. Замените строку your_extension_name на имя вашего расширения и нажмите Enter.
  4. После перехода по ссылке вы увидите сообщение о том, что такой страницы еще не существует. Справа от сообщения будет меню, в котором следует выбрать пункт меню «Создать страницу».
  5. После выбора пункта «Создать страницу» вы попадете в окно редактирования новой страницы, но сама страница не будет создана до тех пор, пока вы не нажмете кнопку «Сохранить».
  6. Не бойтесь допустить какие-либо ошибки или неточности в описании и оформлении страницы для вашего расширения — вы всегда сможете отредактировать и удалить созданную страницу.

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


extensions/guidelines.txt · Последние изменения: 11.05.2013 11:25 — Илья Уткин