Introduction

На текущий момент в пакет scripts_0.1.36.zip входят 5 скриптов, одна js-библиотека и один шаблон (для создания класса). Это 36 ревизия, выложенная на странице Downloads, и настоящая документация относится именно к ней.

Понятно, что самая свежая версия, находящаяся в репозитории, может иметь недокументированные изменения. Не факт, что документация будет успевать и за версиями, выкладываемыми в Downloads. Очевидно, что писать и использовать код в разы интереснее, чем писать документацию.

create_class.js

• Автор: Жлоба Юрий
• Лицензия: Public Domain (как это по-русски?)

Скрипт используется для создания нового класса на основе готового шаблона кода. Вызывается по Alt+1 или из меню Scripts->Create AS3 Class. Сперва появляется диалоговое окно, где предлагается указать полное имя класса, причем в окне по умолчанию подставлены пакеты, соответствующие выделенному каталогу в текущем проекте во Flex Navigator (если там какой-то каталог выделен).

Например, у вас во Flex Navigator выделен каталог:

My Project
- src
  - com
    - myCompany
      - appName
        - someStuff

то в этом случае будет подставлено имя:

com.myCompany.appName.someStuff

Вы можете использовать предложеное имя и дописать только имя класса, или можете изменить названия пакетов.

Примечание: по умолчанию считается, что корневая папка для исходных кодов называется src, и именно от нее будут вычисляться имена пакетов

После того, как вы укажете полное имя класса и нажмете ОК, будут созданы папки для новых пакетов (если вы задали новые пакеты), файл для нового класса, в файл будет записан код из шаблона класса, и файл будет открыт в AS3-редакторе.

Шаблон класса берется из scripts/templates/AS3ClassTemplate.as. В нем парсятся 3 переменные: userName, packageName, className. userName берется из настроек Eclipse (Flex), остальные вычисляются из полного имени класса, заданного при создании класса.

Разумеется, если поведение скрипта чем-то вас не устраивает, вы всегда можете залезть в исходник и изменить все по своему усмотрению. Я полагаю, что вы как минимум измените клавиатурное сочетание для запуска скрипта. Ну а изменить шаблон класса под свои нужны -- это сам бог велел. Для того скрипт и создавался.

Немного подробнее об этом скрипте можно прочитать в статье на моем сайте, но имейте в виду, там описана более старая версия скрипта.

expand_snippets.js

• Автор: Жлоба Юрий
• Лицензия: Public Domain

Скрипт предоставляет некий аналог сниппетов -- шаблонов кода, очень мощно реализованых в FDT-плагине и никак не реализованых во Flex. Он вызывается по Alt+2 или из меню Scripts->Expand Snippets, ищет в текущей строке кода сочетания символов, которые он разворачивает в шаблон. В данной версии следующие сочетания символов разворачиваются в следующие шаблоны:

Шаблон учитывает отступ в текущей строке и использует его в шаблоне. Можно указать позицию курсора с помощью переменной {cursor}.

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

Конечно, вы можете добавить свои снипеты и изменить клавиатурное сочетание для запуска скрипта.

add_color.js

• Автор: Илья Панин

Скрипт вызвает стандартное для Flex диалоговое окно выбора цвета и подставляет в текущую позицию в коде hex-код выбранного цвета.

comment_lines.js

• Автор: Paul Colton (Aptana, Inc.)
• Лицензия: EPL 1.0

Скрипт взят из примеров, входящих в стандартную поставку Monkey-плагина, и используется практически без изменений. Я только поменял клавиатурную комбинацию на Ctrl+/, более обычную для Eclipse, и пункт меню для запуска скрипта.

Скрипт комментирует (снимает комментарий) выделенные строки кода в редакторе.

open_navigator.js

• Автор: Жлоба Юрий
• Лицензия: Public Domain

Очень простой, но очень нужные мне скрипт, передающий фокус в панель Flex Navigator. Вообще-то в Eclipse это можно настроить стандартными средствами Windows->Preferences->General->Keys. Но во Flex это почему-то сделать нельзя.

Передавать фокус из активного редактора во Flex Navigator нужно довольно часто. Делать это мышкой совсем неудобно. Делать по комбинации Ctrl+F7 удобнее, но требует нескольких нажаний. Скрипт позволяте делать это в одно нажание, по Alt+3.

lib/main.js

Данный скрип запланирован как библиотека общего кода, которую можно подключать к другим скриптам. Пока в ней определена только функция trace, выводящая сообщения в Console View. Ее нужно использовать как средство отладки скриптов.