Сейчас работаю над библиотекой компонентов для одной крупной компании. В таком проекте важен не только конечный результат, но и хорошая документация для разработчиков, которые будут использовать нашу библиотеку. Поэтому было решено сгенерировать хороший ASDoc c примерами и live preview внутри.

Часть 1. Пишем.

Для ActionScript классов шаблон для ASDoc я генерирую одним нажатием кнопки плагина Flex Formatter, что ставится на флеш билдер. Потом просто заполняю его текстом. Возможность писать ASDoc в mxml файлах появилась совсем недавно, поэтому здесь приходится прописывать его руками. Выглядит он примерно так:

<?xml version="1.0"?>

<!-- Standard MXML comment: eventsmyComponentsMyButton.mxml -->

<!---

The class level comment for the component.

This tag supports all ASDoc tags,

and does not require a CDATA block.



@see mx.container.VBox

-->

<mx:VBox xmlns="http://ns.adobe.com/mxml/2009" xmlns:mx="library:adobe/flex/halo" >



<!---

Comment for button

-->

<mx:Button id="myButton" label="This button has comment"/>



<!---

This comment doesn't belong to any component and will be ignored

-->

</mx:VBox>

Часть 2. Генерируем.

Написав все необходимые комментарии, я приступаю к генерации документации. Для этого я воспользуюсь тулом, который входит в состав Flex SDK – asdoc.exe Графического интерфейса эта программка не имеет, поэтому я напишу, как подключить ее через external tools в Flash Builder.

Во Flash Builder выбираем Run –> External Tools –> External Tools Configurations



Создаем новую конфигурацию, кликнув два раза по кнопке “Programs”. Далее, даем имя для вашей новой конфигурации. Я назвал “ASDoc”.

Путь

Здесь мы должны указать путь к нашему тулу. У меня он выглядит так:

D:/Program Files/FlashBuilder/Adobe Flash Builder 4/sdks4.0.0/bin/asdoc.exe

Возможно у вас он будет немного другим.



Рабочая директория

Далее нам нужно указать рабочую директорию. Я прописал ${project_loc} что будет обозначать любой выделенный в Package Explorer проект.

Параметры

Далее нам надо указать несколько дополнительных параметров. Основные из них я опишу здесь:

-source-path
Папка с исходным кодом для вашего проекта. У меня это "src/main/flex". Если папок несколько, то мы их все должны прописать.

-doc-sources
Папка, исходный код в которой нужно задокументировать. У меня она совпадает с source-path.

-output
Директория, в которую вы хотите сгенерировать документацию. Может быть как абсолютной так и относительной.

-window-title
Название, которое должно отображаться в окне браузера.

-main-title
Название, которое отображается в HTML шапке.

-library-path
Относительный путь к дополнительным библиотекам, если ваш проект такие использует. Например у меня используется библиотека с флеш компонентами, собственно у меня и прописано: "src/main/resources/flash".

-exclude-classes
Классы, которые вы не хотите включать в документацию.

Запускаем

Когда конфигурация прописана – нажимаем кнопку “Apply”, и затем “Close”. Далее выбираем наш проект в package explorer, нажимаем Run–>External Tools->Organize Favorites. Там выбираем нашу конфигурацию и нажимаем кнопку Add. Это для того чтобы наша конфигурация появилась в меню на External Tools. Дальше опять Run–>External Tools и тут уже видим нашу конфигурацию и запускаем ее. Все!

За более подробной информацией по параметрам компилятора и используемым в ASDoc тегам можете глянуть этот документ.


Часть 3. Расширяющая.

Иногда просто документации по исходному коду нам может не хватать. Всегда хочется посмотреть исходный код с использованием компонента или запустить его и ‘потрогать’.

Чтобы показать наши компоненты вживую мы создали приложение, которое показывает нужный компонент по определенной URL переменной. Приложение и HTML файл для него положили в папку, где лежит наш ASDoc.

Внутри класса компонента мы указали ссылки на эту страницу и передали нужную переменную. Пишется это примерно так:

/**

* A command button is a control that when clicked causes the application to perform an action.

* <a href="../../../../main.html?component=CommandButton">See live preview</a>

*

* @includeExample CommandButtonExample.mxml

*/

А выглядит так:


Вы наверное заметили еще одну подозрительную сторочку:
@includeExample CommandButtonExample.mxml

Так вставляются примеры кода в конец класса, но предварительно они должны быть написаны, как отдельные файлы и подключены через параметр -examples-path.

Удачного вам ASDoco писания :)

[ добавить комментарий ]   |  [ trackbacks 0 ]   |  permalink

---

Очередная игра, от которой не могу щас оторваться.

Играть! Играть! Играть! Играть! Играть! Играть! Играть! Играть! Играть! Играть! Играть! Играть!

Смысл прост: вы - маленькая мышь. Таких как вы запускают в комнату около 25 (все реальные люди). Ваша цель - первым добраться до сыра и принести его в норку. На вашем пути куча ловушек, препятствий, и таких как вы. "Эффект толпы" и кучу забавных ситуаций обещаю вам на 100%. С вами есть "Шаман", он помогает вам обойти эти препятствия и добраться до сыра. Помогает с помощью различных сооружений, которые можно в этой игре построить. Шаманом становится тот, кто первый в рейтинге.

Аналогов такой игрушки пока не видел, поэтому будущее у этой идеи должно быть.

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

[ добавить комментарий ]   |  [ trackbacks 0 ]   |  permalink

---

С новым выходом Adobe Creative Suite CS5 и Flex4 по всему миру прошли Adobe Launch туры. Мне удалось поучаствовать в русском и белорусском турах. Рассказывал про Flex 4 framework, про новый Flash Builder и Catalyst.

Ну а теперь чуть подробнее :)
В первый день я с Язловецким Сергеем выступили в МГУ с докладом про Flex 4 framework (Gumbo). Доклад посчитали немного хардкорным, хотя мы его упрощали как могли по сравнению с белорусским туром.

Нельзя не отметить знакомство с евангелистом из Adobe - Томом Крча
Артемий Малков и Том Крча

Во второй день проходил Flash Gamm . Встреча с старыми друзьями из Альтернативы и многими другими.


Даже я там засветился опухший и не выспавшийся.

На афтерпати с Флеш Гамм довелось пообщатся с Валентином Симоновым.

Теперь перемещаемся в Беларусь. 29 Мая я организовал и выступил на Flex 4 launch tour Belarus. Рассказывал и показывал про Новые инструменты Adobe Flash Platform



Видео, к сожелению, записать не удалось, поэтому решил, что запишу немного скринкастов.

[ добавить комментарий ]   |  [ trackbacks 0 ]   |  permalink

---

Немного запоздалый пост, посвященный выходу нового планшета iPad. Специально для конференции Creative future мы готовили приложение на флеш для этого нашумевшего девайса. Сначала вообще хотели попробовать засунуть туда флекс, но после отзывов умельцев, которым удалось это сделать, передумали.

Решение делать приложение на флеш под планшет и вообще под платформу принималось до всемирно известных костылей от Apple. Но и потом мы не отчаялись и решили продолжить разработку. Ведь в мире куча других девайсов c тачскрином и мультитач.

В разработке активное участие принимали разработчики из BAFPUG, за что им нужно сказать отдельное спасибо! Тестировали все это дело на iPhone. Педалило все ужасно. Малейшая утечка памяти и приложение вылетало. Жили лишь надеждой, что iPad будет по производительнее. Очень помогала презентация Майка Чамберса, где он рассказал про всевозможную оптимизацию Flash приложения, чтобы оно не педалило на iPhone.

Еще ондой из проблем стало то, что пекеджер умеет упаковывать приложение только под iPhone и на iPad оно запускалось в маленьком окошке. От этой проблема спасала кнопка 2х, но качество графики конечно же терялось.

После всех этих стараний флеш на iPad всетаки стал, а мы пришли к выводу, что проще выучить Objective C за 2 недели, чем разрабатывать приложение на флеш под iPhone.

[ добавить комментарий ]   |  [ trackbacks 0 ]   |  permalink

---

Разработка через тестирование (англ. test-driven development) — техника программирования, при которой модульные тесты для программы или её фрагмента пишутся до самой программы и, по существу, управляют её разработкой. Является одной из основных практик экстремального программирования.

Но вот кто эту практику применяет на самом деле? Думаю, что не более 10 процентов от всех разработчиков, а то и меньше. Все дело в том, что TDD очень сложно для вхождения. Оно требует от разработчика иного мышления, оно плохо задокументировано, в следствии на него тратится очень много времени и возникает негативное ощущение. Но интерес у публики по-прежнему растет - значит положительный эффект у данной техники есть.

Это и хочет нам покакзать Elad Elrom в своей статье, где он разработал настоящее Flex приложение с примерами, описанием, презентацией и исходным кодом.



p.s. за наводку спасибо Mr_Dr_Jr

[ добавить комментарий ]   |  [ trackbacks 0 ]   |  permalink

---

Нашел презентацию, в которой автор довольно хорошо рассказал про жизненный цикл компонента и необходимость жизненного цикла для компонента. Также в презентации показано, как создавать собственные события и скины для компонента. Мне понравилось.


[ комментариев: 2 ] ( просмотров: 13 )   |  [ trackbacks 0 ]   |  permalink

---

Скрестил blog.tut.by со своими расшаренными записами из Google RSS reader, где я подписан на рассылку новостей от 150 источников. В итоге получился довольно интересный новостной ресурс с наиболее понравившимися мне новостями. А самое гланое и приятное - пост у меня создается в 1 клик. Если вам интересно узнать только самые интересные новости - то добро пожаловать на http://vapes.blog.tut.by/

[ добавить комментарий ]   |  [ trackbacks 0 ]   |  permalink

---

Напишу о своем первом посещении прекрасного и большого города Москва и, соответственно, BURAFPUG. Приехал я туда по делам за неделю до мероприятия. Встретил Роста, заехали в гости к Артемию Малкову в компанию Flexis





Перед самим BURAFPUG погуляли по Москве. Правда опоздали мы на мероприятие по дезинформации местных жителей )





На самом BURAFPUG нас ждали места в 1 ряду. Формат встречи проходил в виде блиц докладов, где каждому давалось несколько минут на доклад. Многие доклады выглядели в виде саморекламы и проделанных проектов, но были и полезные вещи. Увидел много активных блоггеров в живую.



Я рассказал про возможность отловить клик правой кнопкой по флешке не прибегая к посторонним технологиям, типа javascript.



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

P.S. Огромное спасибо Артемию Малкову за организацию данного мероприятия.

[ комментариев: 3 ] ( просмотров: 23 )   |  [ trackbacks 0 ]   |  permalink

---

Нашел в интернете видео про проект, в команде разработки которого я провел год. Это онлайн редактор для печати фотокниг и календарей adoramapix.com



Редактор написан на Flex с использованием фреймворка PureMVC. Серверная часть редактора скомпилена под AIR, она служит для генерации картинок под печать. В итоге изменения в движке проекта автоматически переносятся в серверную часть тоже.

В рамках проекта я занимался возможностью загрузки изображений на сервер и импортом изображений с других фото сервисов. Также принимал активное участие в разработке графическо интерфейса приложения и многое другое.

[ добавить комментарий ]   |  [ trackbacks 0 ]   |  permalink

---

Обожаю Axeeffect за креативность их реклам!



Можно даже так: http://www.russia.ru/axe/4254.html

Создать себе такую можно здесь : http://axeeffect.tv/

[ добавить комментарий ]   |  [ trackbacks 0 ]   |  permalink

---

Видео с участием Джон Ландау, продюсера "Avatar", который рассказывает, как программное обеспечение Adobe, использовалось в производстве фильма.



[ добавить комментарий ]   |  [ trackbacks 0 ]   |  permalink

---

Обзавелся страничкой ссылок на флеш ресурсы.

Категории следующие:

3D Engines
3D Game Engines
3D Animation Framework
3D Physics Engines
Augmented Reality
Animation Tweening Kits
2D Physics Engines
Security
Audio Libraries
Particle Systems
Data Visualization
Loading Kits
OOP Frameworks
Other APIs and libraries

Ссылка на документ: http://vapes.na.by/blog/static.php?page=help

Все собирал с разных источников. Список будет дополнятся , расширятся , переводится на русский язык и висеть на моем сайте в колонке справа.

Все, что упущенно прошу дописывать мне в комменты, я с удовольствием добавлю.

[ комментариев: 2 ] ( просмотров: 19 )   |  [ trackbacks 0 ]   |  permalink

---

Всем заказчикам посвящается ...

Здраствуйтє, сдєлайтє пажалуста ігру шоб можна била мєдвєдєм кушать ягади і рибу. Да, і шоб мєдвєдь єзділ на машинє. І шоб фізіка била рєалістічная: можна тараніть дєрєв"я, падают шишкі, лістья, оси, скунс. Скунс бєгаєт па машинє, но єво можна схватіть лапай — і викінуть с машини. А іщьо — нада шоби єзділі па лєсу другіє мєдвєді на машинах. С німі можна будєт тараніцца. Всє ричат. На паваротах машину далжно занасіть. Руль крутіть можна лапай. І главнає — шоб нє как в аркадах — пєрєклучєніє пєрєдач ручноє. Ну й пєдаль тада тоже можна лапай жать. Когда мєдвєдь єст рибу — абязатєльна далжни аставцца кості і хвост. Чєрєз пять мінут наступаєт зіма

А вот и реализация : http://gamejolt.com/freeware/games/enviro-bear-2000/files/enviro-bear-2000/download/211/233/

И видева : http://www.youtube.com/watch?v=A24tSPNz2so

Причем все по ТЗ !!! Исполнителям респект и уважуха. Весь отдел под столами лежал.

[ комментарий 1 ] ( просмотров: 18 )   |  [ trackbacks 0 ]   |  permalink

---

Да, да, да, вышел долгожданный флеш плеер 10.1. И как всегда писать про это я не собираюсь, а выберу лучшего :)

Как мы знаем в прошлый раз победил Константинер с новостью Flash Player 10 и Moonlight 1 :)

Кто же победит на этот раз ? Присылайте ссылки на свои бояны в комменты на эту статью и я выберу лучшего. Победитель получит 10 WMZ !

[ добавить комментарий ]   |  [ trackbacks 0 ]   |  permalink

---

21 Ноября (суббота) в 13.00, в торгово-развлекательном центре “Александров Пассаж” состоится очередная тематическая встреча Belarusian Adobe Flash Platform User Group, посвященная общению с server side.

На встрече будут представлены следующие доклады:

“Model layer of application” (value-objects, serialization to/from xml/json) - Шамрук Сергей (Intetics)

“Разработка под Flash Media Server” - Жлоба Юрий (Креатек)

“RPC and Flex Messaging of BlazeDS” (Java Server) - Сергей Язловецкий (EPAM systems)

Мероприятие бесплатное, участие открытое и все желающие приветствуются. Как показал опыт предыдущих мероприятий, интерес к встречам среди белорусских разработчиков достаточно велик, поэтому для участия требуется обязательно предварительно зарегистрироваться. Сделать это можно здесь.

Организатором мероприятия является постоянный партнер BAFPUG - компания Intetics.

И собсна Я :)

[ добавить комментарий ]   |  [ trackbacks 0 ]   |  permalink

---

Minuscule - Ladybug - The most popular videos are a click away

Вчера нарвался на клевый мульт про насекомых. Погуглив, оказалось что это целый французский сериал. А ведь нечто типа такого я мутил на флеш в студенческие годы. Теперь задумался ...

[ комментариев: 2 ] ( просмотров: 18 )   |  [ trackbacks 0 ]   |  permalink

---

Было время, когда я решил попробовать себя в роли баннермейкера. В техническом плане работа легкая, да и весь креатив тоже мой. Сложным оказалось угодить заказчику, поэтому никогда не беритесь за работу, если ТЗ похоже на ХЗ :) Чем больше инфы вы с него вытащите - тем точнее вы попадете в цель, тем меньше вам придется переделывать, тем больше времени и денег сэкономите. Чтобы узнать как можно больше, я давал заказчику заполнить анкету, приводил работы фрилансеров и просил указать те, что пришлись заказчику по душе.

Сначала просил деньги за обьем работы - не выгодно! Получалось, что сделаешь 3 варианта, а заплатят за один. Потом стал брать деньги за час работы - стало лучше, и заказчик стал думать больше, прежде чем отдать работу на переделку.

В общем я завязал с баннермейкерством :) Теперь исключительно приложения, игры, или сайты.

Примеры работ тут. Даже не тормозят, когда все вместе запущены ;)

[ добавить комментарий ]   |  [ trackbacks 0 ]   |  permalink

---

[ комментарий 1 ] ( просмотров: 15 )   |  [ trackbacks 0 ]   |  permalink

---

Кто сказал, что нельзя ? Я сам в шоке :)

Благодаря прекрасному методу FileReference.data жизнь флекс и флеш разработчиков стала намного интереснее.

Я думаю, что каждый, кто делал флеш аплоадер сталкивались с багом https://bugs.adobe.com/jira/browse/FP-1419 , который гласит, что после 30 секунт аплоада POST методом (FileReference.upload()) флеш плеер может перестать получать событие complete. И процесс аплодинга зависал.

Я поднял этот вопрос среди евангелистов компании Adobe, на что получил следующий ответ:

Hi,
Apologize for the long delay. I've talked with several peoples, there is no known workaround, no final date when the bug is going to be fixed. My only idea for a workaround is:

- open a channel between FP and server - use blazeds, or write your own code for that (if you cannot use blazeds). It could be streaming or long polling. If you use streaming be aware that you are keeping an http connection locked just for that
- the server will know when the upload is finished, and it can fire an event
- a listener for this event is invoked, and it will write a message using the open channel. The client will receive the message and it will know that the upload/processing is finished.

Best, Cornel.

Поскольку наш сервер сайд на .Net, то про blazeds можно забыть. Остальное очень схожее с FTP upload.

Погуглив я нашел 2 примера. Один был для AIR ,а второй отсюда. Конечно же второй понравился мне больше :)
Скопипастив код в свое приложение, я попробовал залить пару файлов на свой FTP ... работает! Конечно же только под 10 флеш плеер.

Ну и немного улучшив примерчик я даю вам шанс самим убедиться.

Конечно же придется выяснить кучу вопросов насчет такого процесса аплодинга но первый шаг уже есть...

P.S. Вы случайно не знаете, какой максимальный размер может принимать ByteArray ? у меня тут файлы по 60 Mb.

[ комментариев: 2 ] ( просмотров: 23 )   |  [ trackbacks 0 ]   |  permalink

---

Расскажу про создание такого колорпикера и почему я до такого докатился :)

Дело в том, что на мой текущий проект понадобился колорпикер. Стандартный колорпикер с web colors никого не устраивал. Тогда поставили DropDownColorPicker из Astra Flex Components - оказался сложным для простого пользователя. Решили вернуть стандартный колор пикер, но заимплементить функцию eye dropper - жалоб стало меньше, но пошли другие жалобы, что пользователю приходится самому искать картинку спектра. Тогда решили, что найдем и вставим эту картинку сами. В итоге получилось то, чтовы видите на картинке, или тут.

Расширить стандартный колорпикер не удалось, поэтому пришлось взять исходники и немножко их подправить :) События, свойства, стиль остались те же + возможность заменить картинку спектра через стиль и возможность брать цвет с application.

В общем сравнивайте сами.

P.S. А еще мне бы хотелось посмотреть на наиболее удачные решения для колорпикера.

[ добавить комментарий ]   |  [ trackbacks 0 ]   |  permalink

---

Next

Search:

 

Valery Pesetski. - Page Generated in 0.0736 seconds