Спасибо Илье «_Smirnoff» Смирнову за хорошую новость! В продаже появилась новая книга на русском языке про разработку приложений под платформу Adobe AIR при помощи JavaScript и HTML: «Adobe AIR. Разработка приложений с помощью Ajax».

Думаю, что она станет неплохим дополнением к книге «Adobe AIR. Практическое руководство по среде для настольных приложений Flash и Flex» для разработчиков, желающих воспользоваться предоставляемой Adobe AIR возможностью создавать приложения на языке JavaScript.

Вот аннотация к этой книге на сайте Books.ru:

«Книга посвящена разработке Web-приложений в кросс-платформенной рабочей среде Adobe Integrated Runtime (AIR) для Microsoft Windows XP (SP2)/Windows Vista и Mac OS X 10.4/10.5 с использованием технологии Ajax (HTML и JavaScript). Рассматривается создание, запуск, отладка и развертывание AIR-приложений, взаимодействие приложений с сетевыми ресурсами, применение средств разработки AIR, создание окон и меню, импорт и экспорт данных, работа с файлами, папками и базами данных, использование медиакомпонентов.

Сопровождающий книгу Web-сайт www.DMCInsights.com/air содержит примеры скриптов, весь программный код, приведенный в книге, новые версии программного обеспечения и множество другой полезной информации».

Не поленюсь и еще раз процитирую пару своих абзацев вот из этой заметки:

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

Осталось еще дождаться выходящей в январе книги «Learning Flex 3. Getting up to Speed with Rich Internet Applications». Да и не помешало бы заиметь чуть больше свободного времени, чтобы успеть быстрее все это прочитать.

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

Сегодня вышел релиз Adobe AIR 1.5 для Linux. Это означает, что с сегодняшнего дня эту среду исполнения можно считать по-настоящему кроссплатформенной. С чем я вас и поздравляю.

Ссылки по теме:

• Замечания к текущему релизу среды для Linux на русском.
• Скачать среду исполнения Adobe AIR 1.5 для Linux.
• Скачать Adobe AIR 1.5 SDK для Linux.
• Инструкция по установке Adobe AIR на 64-битных сборках Linux (что ж поделать, не обошлось и тут без работы в терминале и ручного конфигурирования, благо линуксойды любят этим заниматься =).

Более подробно об этом можно почитать в блоге разработчиков AIR.

Еще обращу ваше внимание на то, что в продаже уже есть книга на русском языке о том, как разрабатывать AIR-приложения.

6 комментариев

Оказывается, в продаже появились две новые книги по Flex и AIR на русском языке, которые я сегодня благополучно заказал для себя на Books.ru.

Первая книга называется «Adobe AIR. Практическое руководство по среде для настольных приложений Flash и Flex». Оригинальное название на английском звучит как «Adobe AIR in Action». Это небольшая по объему (всего 350 страниц) книга, в которой речь, как я понимаю, идет о версии 1.0 среды AIR. В виду полного отсутствия каких-либо других книг по AIR на русском языке, я считаю, что это издание является «must have» для разработчиков AIR приложений. Тем более что отличия между версиями 1.0 и 1.5 среды AIR не столь значительны, чтобы информация в книге оказалась устаревшей (в основном эти изменения связанны с внедрением совместимости с Flash Player 10).

К слову сказать, книги из серии «… in action» уже давно зарекомендовали себя среди программистов, как лучшие практические издания по конкретным тематикам. Научным редактором перевода, насколько мне известно, является Михаил Антипин. Так что, скорее всего нас ожидает интересное содержание в хорошем качестве перевода.

Вторая книга называется «Программирование c использованием Adobe Flex». Она толще, чем предыдущая – объемом в 570 страниц. В книге описываются приемы работы со второй версией Flex фреймворка. Опять же никаких кардинальных изменений между версиями 2 и 3 Flex не было, так что информация, содержащаяся в книге, все еще актуальна. Неактуальной информация будет для вас только в том случае, если вы сразу решили изучать Flex 4 Gumbo, который в настоящий момент находится в состоянии alpha-версии. Но стоит эта книга немало – более 800 рублей, которые, тем не менее, с лихвой окупятся, если воспользоваться полученными из книги знаниями.

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

Осталось еще дождаться выходящей в январе книги «Learning Flex 3. Getting up to Speed with Rich Internet Applications». Да и не помешало бы заиметь чуть больше свободного времени, чтобы успеть быстрее все это прочитать.

9 комментариев

Вы не знаете, что такое AIR? Но вы хотите исправить этот факт и не знаете с чего начать? Что ж на вашу улицу пришел праздник! В течении последней недели небезызвестный Senocular опубликовал несколько весьма интересных и полезных уроков.
Да-да, вы не ошиблись, он самый — автор ActionScript 3 Tips and Tricks (русская версия). Теперь он предлагает нашему вниманию свои уроки по AIR. И так на сегодняшний день доступны следующие уроки:

• AIR 101 — первое знакомство с AIR, все очень подробно;
• About the AIR Update for Flash CS3 — вводная статья о дополнении к Flash CS3, позволяющем собирать без особых усилий air-приложение во Flash IDE;
• Using AIR to Get and Set Clipboard Text — α-версия AIR (известная тогда под именем Apollo) не умела работать с буфером обмена, с выходом β ситуация изменилась – copy/paste теперь с нами;
• Setting Up an AIR Application with File Associations — ассоциируем любой тип файлов с нашим air-приложением;
• Custom Move and Resize Window Controls in AIR — хотите свои кнопки управления окна? — Пожалуйста;
• Creating an Image Viewer in AIR With Drag and Drop — ваши пользователи любят таскать файлы? Отлично, теперь вы можете предоставить им такую возможность.

Пока все. Читаем.

5 комментариев

На прошлой неделе завершил работу над своим первым небольшим коммерческим приложением, работающим в среде AIR (Apollo). Теперь буду с гордостью считать, что являюсь одним из первых российских девелоперов, начавших работать с этой платформой на коммерческой основе. =)

Работа приложения заключается в том, чтобы при помощи манипуляций пользователя на выходе получить определенным образом структурированный XML файл, который будет являться конфигурационным файлом уже для другого приложения. Т.е. по сути, мое приложение является своеобразным конфигуратором для другого приложения. Так что довелось поработать с файловой системой и немного с Window API. Но суть не в этом, а в том, что после создания приложения встал вопрос о том, как оно будет распространяться. Вынуждать конечного пользователя (наверняка далекого от компьютерных технологий) самостоятельно устанавливать среду исполнения AIR (Apollo), а затем и .air файл с приложением, как-то не хотелось, поэтому было решено упаковать приложение и среду исполнения в единый инсталляционный файл.

После непродолжительного поиска в Гугле и чтения тематических сайтов была найдена программа «Inno Setup Compiler», распространяющаяся свободно, т.е. кроме того, что вы можете бесплатно ее использовать, доступны еще и исходные коды программы на Delphi. На сайте разработчиков написано, что программа по возможностям и стабильности не уступает многим коммерческим инсталляторам. Что ж, охотно верим. По крайней мере, для наших целей ее возможностей будет более чем достаточно.

«Inno Setup Compiler» относится к классу программ, имеющих в своем распоряжении мастер, помогающий установить начальные характеристики инсталлятора, и редактор кода, при помощи которого можно отредактировать другие опции программы установки. Давайте сразу определимся, каким мы хотим видеть процесс установки нашего приложения:

1. После принятия пользователем лицензионных соглашений заблокировать интерфейс мастера установки.
2. Распаковываются установочные файлы AIR (Apollo) и нашего приложения. Тут необходимо решить вопрос с директорией, в которую будут распакованы файлы. Я решил в качестве целевой папки использовать директорию, в которой будет находиться инсталлятор (хотя это совершенно не годится, если инсталлятор будет растространяться на компакт-дисках).
3. Устанавливается среда AIR.
4. Устанавливается наше AIR приложение.
5. Завершение установки. Снимается блокировка с окна мастера установки. Показывается единственная кнопка «Готово».

Еще нужно отметить, что совершенно не нужно, чтобы наша программа установки была прописана в реестре в качестве установленной на компьютере программы. Хоть «Inno Setup Compiler» и позволяет без труда организовать это, но это будет лишним, поскольку после установки деинсталлировать будет нечего — все распакованные файлы, возможно, будут еще нужны пользователю для произведения каких-либо манипуляций с ними «вручную».

И так, приступим. Для начала создадим новый файл описывающий процесс установки: File → New. Автоматически должен запуститься мастер создания файла установки. На втором экране мастера мы можем указать:

• название приложения;
• название приложения, включающее версию приложения;
• компанию-создателя приложения;
• сайт поддержки приложения.

На третьем экране мастера нужно указать папку установки программы. Т.к. наша программа не нуждается в оной, ставим галочку на пункте The application doesn’t need a folder. На четвертом экране мастера нам нужно прописать файлы, которые будут включены в инсталлятор. Поэтому при помощи кнопок Browse, указываем пути до файла установки Apollo Runtime и до файла нашего приложения. После этого нужно указать папку, в которую будет распакован каждый из этих файлов. Поэтому поочередно выделяем каждый файл, жмем на кнопку Edit и в выпадающем списке Destination base folder меняем значение на Setup source directory. На пятом экране мастера можно указать пути до файла лицензии, и до информационных файлов, которые будут показаны до и после процесса установки. На шестом экране мастера можно выбрать языки, на которых будет осуществляться процесс установки. Я указал английский и русский. На седьмом экране нужно указать папку, в которую будет помещен скомпилированный файл установки, название файла установки, и, если нужно, иконку файла установки и пароль. Нажимаем кнопку Готово. Мастер завершает свою работу, а мы переходим к непосредственному редактированию скрипта.

Сразу скажу, что с «Inno Setup Compiler» поставляется довольно подробный файл справки, поэтому за списком поддерживаемых секций, команд и флагов идем и смотрим справку. Если мы протестируем сейчас наш инсталлятор, то увидим, что на данный момент он только распаковывает входящие в его состав файлы и на этом завершает свою работу. Но нам нужно, чтобы автоматически запускалась установка среды AIR и .air файла нашего приложения. Для реализации этой задачи нам нужно добавить в скрипт установки секцию Run, в которой мы и опишем процесс установки этих файлов:

В этой секции указываются пути к файлам, запуск которых должен быть произведен. Я использовал префикс {src}, чтобы указать на папку, в которой находится инсталлятор. Добавил сообщение, которое будет описывать, что именно выполняется в настоящий момент, обозначив его в параметре StatusMsg. В качестве дополнительных флагов указал shellexec, который сообщит нашему инсталлятору, что запускаемый файл не является исполняемым .com или .exe файлом, а так же флаг waituntilterminated, который заставит инсталлятор дождаться полного прекращения работы запускаемого процесса и заблокировать при этом интерфейс окна инсталлятора.

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

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

8 комментариев

Перед вами простой пример того, как получить параметры, переданные через командную строку во Flex based Apollo приложение:

Событие InvokeEvent рассылается с запуском приложения, независимо от того запущено оно кликом по иконке или из командной строки. Любые аргументы переданные посредством командной строки будут представлены как массив строк, к которому можно обратиться через event.arguments.

Для тех кто работает во Flex Builder 2.0.1, к сожалению, нет возможности тестирования передачи аргументов через командную строк (такая возможность появиться в следующих версиях Flex Builder). Так что, чтобы протестировать передачу параметром своему предложению, придется воспользоваться услугами adl как в следующем примере:

То есть все, что стоит после «--» будет передано в приложение как аргументы командной строки.

Взято у Майка Чемберза.

За дополнительной информацией сюда.

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

Изначально AIR (Apollo) не имеет возможностей по работе с внешней базой данных «напрямую», о чем написано в Apollo DeveloperFAQ, однако там же сказано, что такие возможности можно получить написав соответсвующий драйвер, доказательством чего стал asSQL — as-драйвер для работы с MySQL, написанный Мэттом МакЛином (Matt MacLean).
На странице проекта вы можете посмотреть на примеры использования asSQL, ознакомиться с документацией, а также скачать сам драйвер в виде SWC. Исходные коды по заверению Мэтта будут опубликованы после того, как он приведет их в порядок, так что любителям порыться в сорсах пока придется подождать.

Подсмотрено у Майка Чемберза.

UPDATE: видимо, я в последнее время слишком увлекся AIR (Apollo), что, заметив новость о asSQL, поспешил отнести ее в раздел AIR. Теперь восстанавливаю правду: asSQL — это библиотека, позволяющая Flex/Flash/AIR приложениям работать с mySQL «напрямую», минуя серверсайд. Впредь буду внимательней.

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

Вот наконец-то выдалось несколько свободных деньков, которые я посвятил своему знакомству с AIR (Apollo) и переводу третьей главы книги Apollo for Adobe Flex Developers. Pocket Guide. Скачал SDK, документацию и погрузился в процесс. Однако работа в консоли меня быстро утомила (а качать Apollo extension я не стал, по причине того, что мой билдер все никак не обновиться до версии 2.0.1), поэтому я решил автоматизировать процесс создания Flex-based Apollo приложений с помощью FlashDevelop. Но обо всем по порядку.

Установка Apollo SDK

• Собственно, нам потребуется два SDK: Flex SDK 2.0.1 и Apollo SDK, первое скачиваем здесь, второе — здесь;
• теперь создаем папку, пусть это будет C:apollo_sdk. Распаковываем в эту папку содержимое архива c Flex SDK, затем в эту же папку распаковываем архив с Apollo SDK. На вопросы о замене файлов отвечаем твердое «да».

Установка и настройка FlashDevelop

• О том, как установить и настроить FlashDevelop я рассказывать не буду, почитать об этом вы можете здесь;
• после того как FlashDevelop установлен и настроен, нам всего лишь надо добавить в него шаблон для создания Flex-based Apollo приложений. Для этого скачайте и распакуйте архив с шаблоном в папку [FlashDevelop_HOME]/Data/ProjectTemplates.

Вот теперь мы готовы к созданию Apollo приложения, если кто забыл, то весь сыр-бор именно ради этого. В качестве примера предлагаю написать простенький веб браузер, как в книге Apollo for Adobe Flex Developers.

Создание Apollo приложения

Открываем FlashDevelop и создаем новый Flex-based Apollo project. Задаем ему имя и указываем местоположение. После того как проект создан, открываем файл App.mxml и создаем в нем код нашего веб браузера:

Теперь нажимаем ANT Build, если все сделано правильно, то в папке deploy должен появиться файл App.air — это и есть установочный файл нашего Apollo приложения. Понятное дело, что на этапе разработки очень не удобно после каждой сборки устанавливать и удалять разрабатываемое приложение. Поэтому в build.xml предусмотрена задача test. Так что открываем build.xml и заменяем значение атрибута default тэга project на test. Снова нажимаем ANT Build и любуемся нашим веб браузером.

Описание build.xml и build.properties

Отдельное спасибо Юре Яровому за файл build.xml, он сделал его простым и понятным.

Build.xml состоит из шести задач:

• compile.swf — компилирует swf-файл нашего приложения;
• copy.xml — копирует xml-файл, в котором описаны параметры приложения;
• copy.icons — копирует папку с иконками приложения;
• compile.air — компилирует установочный air-файл;
• build — компилирует swf, копирует xml-файл и папку с иконками, после чего компилирует air-файл и удаляет swf, xml и иконки;
• test — компилирует swf, копирует xml и запускает Apollo приложение в тестовом режиме.

В build.properties вы сможете изменить содержание итогового xml-файла приложения. Подробнее об xml-файле Apollo приложения можно прочесть здесь.

На этом все. Удачи!

4 комментария

Содержание

• Введение
• Модель безопасности
• Доступ к файлам и папкам

• Свойства класса File для доступа к основным директориям системы
• Свойства url и nativePath объекта File
• Структуры URI

• app-storage
• app-resource
• file

• Методы open() и openAsync()
• Режимы открытия файлов
• Методы чтения и записи
• Дополнительная информация

Введение

Apollo имеет файловый API ввода/вывода, который позволяет приложениям считывать и создавать файлы и папки на компьютере пользователя, и в целом обладает следующим функционалом:

• позволяет создавать и удалять файлы и папки;
• позволяет копировать и перемещать файлы и папки;
• позволяет получать список содержимого папок;
• получать доступ к системной информации о файлах и папках;
• позволяет считывать и записывать бинарные файлы;
• позволяет считывать и записывать текстовые файлы;
• позволяет сериализацию и десериализацию объектов ActionScript.

Низкоуровневая функциональность для работы с файловой системой доступна только в коде ActionScript. Flex-фреймворк для Apollo содержит компоненты для работы с файлами и папками, но они являются всего лишь графическими компонентами для навигации по файловой системе и выбора файлов и папок. Эти компоненты не предоставляют прямой доступ к другим основным файловым операциям ввода/вывода.

В дополнение к информации, содержащейся в этой главе, смотрите примеры из раздела «Работа с файловой системой» в пятой главе книги. В этих примерах иллюстрируются некоторые концепции, описанные здесь, и в них приводятся примеры работающего MXML-кода, который вы можете протестировать, используя Flex Builder или Apollo SDK.

Модель безопасности

Apollo, в конечном счете, будет предусматривать комплексную модель безопасности, которая будет контролировать доступ к локальным ресурсам, таким как файловая система. Однако эта модель безопасности не была включена в альфа-версию Apollo.

Необходимо помнить о том, что Apollo-приложение устанавливается на компьютер пользователя и только после этого запускается. В следствие с этим, некоторые правила, которые используются для загрузки и запуска других приложений из интернета, также применимы для загрузки и запуска Apollo приложений. Пользователь должен загружать и устанавливать приложения только из тех источников, которым доверяет.

Доступ к файлам и папкам

Apollo приложения могут работать на различных платформах, например на Windows и Mac OS. Файловый API использует кроссплатформенный синтаксис кода, так что вам не придется писать код, зависящий от конкретной операционной системы.

Вот, к примеру, различия в путях к пользовательским файлам в системах Mac OS и Windows:

• типичный путь к файлу на Mac OS: /Users/joe/Documents/test.txt;
• типичный путь к файлу на Windows: C:Documents and SettingsjoeMy Documentstest.txt.

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

В ActionScript объект File является указателем на какой-либо файл или папку. Класс File содержит статичное свойство documentsDirectory. В нем хранится объект типа File, который в свою очередь является указателем на папку с документами пользователя. Т. е. на папку «My Documents» в Windows, и на папку «Documents» в пользовательской директории на Mac OS, как показано в следующем примере:

В том случае, если объект File является указателем на директорию, то вы можете воспользоваться методом resolve(), для смены этого указателя на файл или папку, находящиеся в этой директории, даже если ни файл, ни папка еще не существуют. Например, следующий код создает подпапку Apollo Test в директории документов пользователя:

Объект File может указывать на любой файл или директорию. Кроме того, объект File может указывать даже на несуществующий файл или папку, как было показано в предыдущем примере. Это позволяет экземпляру File ссылаться на директорию, которую вы еще только желаете создать.

Свойства класса File для доступа к основным директориям системы

Класс File содержит следующие статические свойства, которые указывают на часто используемые папки на компьютерах пользователей:

Свойства url и nativePath объекта File

Свойство url объекта File возвращает расположение файла или папки в виде кроссплатформенной URL строки, как показано в следующем примере:

В то же время, свойство nativePath возвращает строку в адресной нотации текущей операционной системы. Например, вы можете использовать следующий код для получения доступа к определенному файлу в Windows:

Но вместо этого гораздо надежнее воспользоваться одним из свойств, перечисленных в вышележащей таблице (например, свойством appStorageDirectory, которое указывает на папку установки приложения независимо от операционной системы) и методом resolve(), чтобы создать относительный путь к нужному нам файлу:

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

Структуры URI

Структура URI определяет начало URL, так как строка «file» в следующем примере:

app-storage

Обозначает директорию для хранения ресурсов приложения, как показано в следующем примере:

app-resource

Обозначает папку установки приложения, как показано ниже:

file

Свойство url других объектов File возвращает URL с путем к файлу в стандартной file схеме URI:

Синхронные и асинхронные версии методов

Многие методы классов File и FileStream (такие как File.copyFile() и File.copyFileAsync()) имеют как синхронные, так и асинхронные версии.

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

Следующий пример иллюстрирует операцию копирования файла с использованием синхронного метода copyTo():

В следующем примере показано копирование файла с использованием асинхронного метода copyToAsync():

В следующей таблице перечислены асинхронные методы класса File (для каждого из которых есть свой синхронный аналог) и события, которые рассылаются после выполнения метода:

Для того чтобы открыть файл используйте метод open() или openAsync() объекта FileStream. В первом случае операция открытия файла является синхронной, во втором — асинхронной. Чтобы узнать больше про эти методы, смотрите раздел «Методы open() и openAsync()» ниже в этой главе.

Используйте асинхронные методы там, где вы хотите быть уверенными, что основной ActionScript процесс (такой, например, как обновление прогресса выполнения операции) не будет остановлен во время выполнения файловой операции. Т.е. вы можете использовать синхронный метод open() объекта FileStream, если собираетесь открыть файл размером менее 1 Мб, однако используйте метод openAsync() если размер открываемого файла большой или заранее не известен.

За дополнительной информацией об асинхронных методах обратитесь к главе «Handling Events» книги «Programming ActionScript 3.0».

Чтение содержимого папки

Метод File.listDirectory() возвращает массив, состоящий из объектов типа File, представляющих собой файлы и папки, содержащиеся в директории, для которой был вызван этот метод. Для примера, следующий код выводит список содержимого папки рабочего стола:

Метод File.listDirectory() возвращает массив состоящий из файлов и папок, только непосредственно находящихся в текущей директории. Т.е. он не возвращает содержимое подпапок. Но вы, конечно же, можете написать код, обходящий вложенные папки, для того, чтобы получить список их содержимого, воспользовавшись методом File.listDirectoryAsync(), чтобы позволить выполняться другому ActionScript коду, до того момента, пока операция обхода вложенных папок не будет выполнена.

За дополнительной информацией об асинхронных методах обратитесь к главе «Handling Events» книги «Programming ActionScript 3.0».

Доступ к файловой информации

В классе File содержится несколько свойств, с помощью которых можно получить информацию о файле или папке.

Кроме того, класс File унаследовал от класса FileReference несколько полезных свойств:

Copying and Moving

Процедуры копирования и перемещения файлов и папок

Методы File.copyTo() и File.moveTo(), соответственно, копируют и перемещают файл или папку в указанное новое местоположение. Например, следующий код копирует файл test.txt, находящийся в папке Apollo Test, которая находится в папке документов пользователя, в папку User Data, находящуюся в папке хранения ресурсов приложения:

Используйте асинхронные версии File.copyToAsync() и File.moveToAsync() этих методов, если операция копирования или перемещения может занять много времени.

Каждый из этих методов содержит параметр clobber, установка значения true которого включает режим перезаписи исходных файлов. По умолчанию значением параметра является false.

Создание файлов и папок

Статичные методы File.createTempFile() и File.createTempDirectory() класса File позволяют вам создавать временные файлы и папки. Apollo гарантирует, что файл или папка, созданные при помощи этих методов, будут новыми, и будут иметь уникальные названия. Для примера, следующий код создает временный файл:

Временные файлы и папки не удаляются автоматически при закрытии Apollo приложения. Необходимо «вручную» удалять их перед закрытием. Смотрите раздел «Удаление файлов и папок» для получения дополнительных сведений об операциях удаления.

Метод File.createDirectory() позволяет вам создавать новые папки в локациях, определяемых объектом File:

Когда вы открываете объект FileStream для операций записи, то папки, содержащиеся в пути к файлу, создаются автоматически, если это необходимо. Для получения дополнительной информации об объекте FileStream обратитесь к разделу «Чтение и запись файлов» ниже в этой главе.

Удаление файлов и папок

Метод File.deleteFile() удаляет файл. Метод File.deleteDirectory() удаляет папку. Метод File.moveToTrash() позволяет вам переместить файл или директорию в системную корзину.

Каждый из этих методов имеет асинхронный аналог.

Чтение и запись файлов

Класс FileStream предоставляет методы, позволяющие приложению читать и записывать данные в файл.

Ниже представлен приблизительный процесс считывания и записи данных в файл:

1. Создание объекта класса File, являющегося указателем на файл, данные которого необходимо прочесть или записать. За подробностями обратитесь к разделу «Доступ к файлам и папкам» выше в этой главе.

2. Создать экземпляр объекта FileStream, к примеру, следующим образом:

   ТЕКСТ С ПОДСВЕТКОЙ
   Actionscript:

   1. var stream:FileStream = new FileStream( );

3. Вызвать метод FileStream.open() или FileStream.openAsync(), передав ему в качестве параметра объект класса File, указывающий на необходимый файл, а так же определенный режим открытия файла в виде параметра fileMode. Пример:

   ТЕКСТ С ПОДСВЕТКОЙ
   Actionscript:

   1. stream.open(file, FileMode.READ);

   Для получения дополнительной информации смотрите раздел «Режимы открытия файлов» ниже в этой главе.

4. Если был вызван асинхронный метод FileStream.openAsync(), то необходимо также назначить метод слушатель события открытия файла, как это делается, смотрите в разделе «Методы open() and openAsync()» чуть ниже.
5. Произвести операции по чтению и записи данных в файл. За дополнительной информацией обратитесь к разделу «Методы записи и чтения» ниже в этой главе.

6. Закрыть файл, используя метод FileStream.close(), например:

   ТЕКСТ С ПОДСВЕТКОЙ
   Actionscript:

   1. stream.close();

Разберем более детально шаги 3, 4 и 5. Для начала, рассмотрим синхронную процедуру чтения текста в кодировке UTF-8 из файла:

А это та же самая операция, но в асинхронном варианте:

Методы open() и openAsync()

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

Когда вы открываете файл асинхронным методом FileStream.openAsync(), то вам нужно зарегистрировать слушателей событий для отслеживания прогресса операции открытия.

Вызов метода FileStream.open() является синхронной операцией. Если ваше приложение открывает файл, используя синхронный метод, то до завершения файловой операции не будет выполняться никакой другой код в приложении. Так, в следующем примере, сначала будут полностью завершены методы stream.open(), stream.writeUTFBytes(), stream.close(), и только после этого будет возможно выполнение следующего кода:

Преимуществом открытия файла с использованием синхронной операции является то, что вам придется писать меньшее количество кода для осуществления этой задачи. Минусом является то, что выполнение другого ActionScript кода будет приостановлено на время выполнения операции. Как результат, если вы работаете с файлами большими по объему, либо файлами, доступ к которым осуществляется через медленное сетевое соединение, то нужно будет подумать о целесообразности применения асинхронного метода FileStream.openAsync().

Когда вы используете метод FileStream.openAsync(), то все следующие процессы должны быть обработаны асинхронно с помощью слушателей событий:

• Закрытие файла. Объект FileStream рассылает событие close, когда файл закрыт.
• Чтение данных в буфер. Объект FileStream рассылает событие progress во время считывания новой порции данных из файла и событие complete, когда все данные прочитаны. Если данные из файла были уже прочитаны однажды, то вызов метода чтения повторно (такого как, readBytes()) выполнит чтение как синхронный процесс.
• Ошибки ввода/вывода. Объект FileStream рассылает событие ioError при обнаружении ошибки. Для этого возможно несколько причин, например, была произведена попытка записи в файл, когда тот открывался только для чтения. Однако, некоторые ошибки, такие, например, как доступ к чтению данных из файла в то время, когда файл еще не был открыт, вызывают выброс исключений (более значимых, чем рассылка события ioError), потому что среда исполнения Apollo смогла обнаружить сбойную ситуацию незамедлительно.

Перед вызовом метода FileStream.openAsync() в вашем приложении необходимо определить функции слушатели события, которые будут вызваны по завершению асинхронной операции открытия файла.

Следующий пример иллюстрирует асинхронное открытие файла в режиме чтения. После того как файл будет открыт, будет разослано событие завершения операции (либо, если будет обнаружена ошибка, будет разослано событие ошибочного завершения операции ioError, как только ошибка будет обнаружена). В теле пользовательского обработчика события completeHandler() происходит вызов метода FileStream.readBytes(), который в асинхронном режиме считывает данные из файла в массив байтов. Когда все байты данных файла будут прочитаны, будет разослано событие complete:

Режимы открытия файлов

Оба метода FileStream.open() и FileStream.openAsync() принимают два параметра: параметр file, являющийся указателем на файл, который необходимо открыть, и параметр fileMode, являющийся строкой, определяющей, с какими правами будет произведено открытие файла. Все возможные значения параметра fileMode определены в качестве констант класса FileMode.

Например, следующий код синхронно открывает файл для записи в него данных, но не для чтения:

В таблице перечислены константы класса FileMode и их описание:

Методы чтения и записи

Класс FileStream содержит некоторое число методов чтения и записи, которые приводят данные к определенному формату перед их записью или чтением. Например, вы можете использовать методы readUTFBytes() и writeUTFBytes() для того, чтобы прочитать или записать массив байтов, или же методы readByte() и writeByte() чтобы прочитать или записать одиночный байт данных. Всего в этом классе содержится 26 методов чтения и записи данных. За детальными описаниями этих методов обратитесь к документации по классу FileStream в Справочнике по языку ActionScript, который распространяется вместе с Apollo.

Хотя чтение и запись текстовых данных может показаться вам тривиальной задачей, вы всегда должны учитывать кодировку текстового файла. Методы readUTFBytes() and writeUTFBytes() предоставляют возможность считывать и записывать текст в кодировке UTF-8. Методы readMultiByte() и writeMultiByte() позволяют вам определять распознавать различные кодировки символов файла. Однако все возможные ситуации предугадать нельзя. Например, файл в кодировке UTF-8 может начинаться с маркирующего байта (BOM), указывающего на кодировку UTF-8, но содержать при этом кусок данных в другой кодировке.

За дополнительной информацией обратитесь к разделу «Data formats, and choosing the read and write methods to use» в Apollo Developer’s Guide.

Дополнительная информация

За примерами чтения и записи данных в файл обратитесь к следующим разделам главы 5:

• Запись текстового файла из строки (объекта String);
• Чтение текстового файла в строку (в объект String);
• Конвертация изображений (объектов BitmapData) в форматы PNG или JPEG, а так же их запись в файловой системе;
• Сериализация и десериализация объектов ActionScript для их сохранения в виде файлов.

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