В этой части рассмотрим случай когда необходимо собрать множество изображений в один swc-файл. Для этого будем использовать так же Apache Ant. В качестве примера возьмём библиотеку флагов famfamfam включающую в себя почти 250 png-иконок.

Для этого понадобится:

• Для каждого изображения создать AS-класс на основе шаблона (отличие будет только в названии файла, имени класса и включенном изображении);
• Скомпилировать созданные классы в SWC;
• Удалить все созданные AS-классы.

В скрипте использована библиотека ant-contrib, которая дает нам FOR для обработки файлов. Она включена в архив с исходниками в конце заметки.

buildIconsLib.properties

###  buildIconsLib.properties  ###

FLEX_HOME=D:\\SDKs\\4.6.0

dir.lib = ${basedir}\\lib

# source config
src.dir = ${basedir}\\src
#src.ASTemplate = ${src.dir}\\templates\\BitmapTemplate.tpl
src.ASTemplate = ${src.dir}\\templates\\BitmapDataTemplate.tpl
#src.ASTemplate = ${src.dir}\\templates\\SoundTemplate.tpl

# asset config
 # директория с иконками
assets.dir = ${src.dir}\\com\\assets\\icons
 # путь куда будут генерироваться классы (такой же как и package)
assets.classesDir = app\\icons
assets.package = app.icons
assets.classNamePrefix = Icon_
assets.relativeDir = ../../com/assets/icons
assets.extension = png

# library config
lib.swcPath = ${dir.lib}\\icons.swc

Билд-файл состоит из 4 целей (targets):

1. createTemporaryClasses – генерируем AS классы по шаблону.

<target name="createTemporaryClasses">
	<path id="assetList">
		<fileset dir="${assets.dir}" includes="*.${assets.extension}"/>
	</path>
	<pathconvert targetos="unix" property="assetList2" pathsep="," refid="assetList">
		<mapper>
			<!--http://ant.apache.org/manual/Types/mapper.html-->
			<chainedmapper>
				<flattenmapper/>
				<globmapper from="*.${assets.extension}" to="*"/>
			</chainedmapper>
		</mapper>
	</pathconvert>
	<for param="file" list="${assetList2}">
		<sequential>
			<copy filtering="true" file="${src.ASTemplate}" tofile="${src.dir}\\${assets.classesDir}\\${assets.classNamePrefix}@{file}.as" overwrite="true">
				<filterset>
					<filter token="ASSET_PACKAGE" value="${assets.package}"/>
					<filter token="ASSET_NAME" value="@{file}"/>
					<filter token="ASSET_PATH" value="${assets.relativeDir}"/>
					<filter token="ASSET_EXTENSION" value="${assets.extension}"/>
					<filter token="ASSET_CLASS_PREFIX" value="${assets.classNamePrefix}"/>
				</filterset>
			</copy>
		</sequential>
	</for>
</target>

Создаем список файлов с иконками, а затем, pathconvert’ом убираем расширения файлов.
В цикле для каждого png файла создаем свой класс – копируем файл шаблона и задаем ему новое имя и заменем параметры.

2. build SWC – сборка сгенерированных классов

<!-- build the swc -->
<target name="build SWC">
	<path id="classList">
		<fileset dir="${src.dir}">
			<include name="${assets.classesDir}\*.as"/>
		</fileset>
	</path>

	<pathconvert property="classList2" pathsep=" " dirsep="." refid="classList">
		<mapper>
			<chainedmapper>
				<flattenmapper/>
				<globmapper from="*.as" to="${assets.package}.*"/>
			</chainedmapper>
		</mapper>
	</pathconvert>

	<!-- компилируем классы из списка в swc -->
	<compc output="${lib.swcPath}" include-classes="${classList2}">
		<source-path path-element="${src.dir}"/>
	</compc>
</target>

Создаем список сгенерированных классов. Затем pathconvert’ом конвертируем имена файлов в названия классов (полный путь включая package) для передачи в include-classes компилятора.

3. deleteTemporaryClasses – удаляем созданные временные классы

<target name="deleteTemporaryClasses">
	<delete>
		<fileset dir="${src.dir}">
			<include name="${assets.classesDir}\\*.as"/>
		</fileset>
	</delete>
	<echo>Deleted temporary classes</echo>
</target>

4. buildAssetLibrary - стартовая (deafult) процедура – только запускает остальные в порядке очереди.

<target name="buildAssetLibrary">
	<tstamp><format property="StartInstTime" pattern="dd-MMM-yyyy  hh:mm:ss" locale="en,UK"/></tstamp>
	<echo>[${StartInstTime}] Starting build..</echo>
	<antcall target="createTemporaryClasses" />
	<antcall target="build SWC" />
	<antcall target="deleteTemporaryClasses" />
	<tstamp><format property="EndInstTime" pattern="dd-MMM-yyyy  hh:mm:ss" locale="en,UK"/></tstamp>
	<echo>[${EndInstTime}] Build finished.</echo>
	<echo>Asset library built to ${lib.swcPath}</echo>
</target>

В результате у нас будет готовая для использования библиотека всех флагов.

Исходные коды со скриптами: zip-архив (220Kb)
Пояснения:
buildIconsLib.xml – билд-файл собирающий swc из иконок.
buildSWCs.xml – билд-файл создающий swc со стилями, swc с переводами и обращается к buildIconsLib.xml для создания swc с иконками.

Полезные ссылки:
Часть 1: Сборка SWC библиотек при помощи Apache Ant
Using Flex Ant Tasks
Auto-generate SWC asset libraries with Apache Ant and the Flex SDK

Азы и простые примеры.

SWC – скомпилированая библиотека. Часто используемые классы или сотня-другая картинок/звуков, собранных в один swc файл, можно повторно использовать в других проектах, или, например, раздать тестерам =) При этом исходные коды останутся в одном месте. В SWC можно скомпилировать файлы переводов для добавления в приложение многоязычности, или таблицу стилей – тогда полученный swc можно будет использовать как основную или дополнительную тему в приложении.

SWC создается при помощи компилятора compc. Для автоматизации сборки SWC и приложений будем использовать Apache Ant.

Сборка SWC:

<target name="buildSWC">
	<compc output="${basedir}/swc/MyLib.swc" keep-generated-actionscript="false" incremental="false">
		<source-path path-element="${dir.src}" />
		<!-- Включить все .as файлы из данной директории -->
		<include-sources dir="${dir.src}/app/utils/" includes="*.as" />
		<!-- Включить все файлы из данной директории и поддиректорий -->
		<include-sources dir="${dir.src}/app/comps/" includes="*" />
		<!-- Включение класса -->
		<include-classes />
		<!-- Включить из конфиг-файла. По сути тоже самое, но в отдельном файле -->
		<load-config filename="${basedir}/build/classes-list.xml"/>
	</compc>
</target>

classes-list.xml

<?xml version="1.0" encoding="utf-8" ?>
<flex-config>
	<include-classes>
		<class>app.events.MyEvent</class>
		<class>app.comps.Button</class>
	</include-classes>
</flex-config>

SWC с файлами локализации:

<target name="buildSWC-locale">
	<compc output="${basedir}/swc/locale.swc">
		<locale>ru_RU</locale>
		<!-- Путь к директории с локалями -->
		<source-path path-element="${dir.src}/locale"/>
		<!-- Имя подключаемой локали (одной или более) -->
		<include-resource-bundles>Resources</include-resource-bundles>
	</compc>
</target>

Файл Resources.properties:

AppTitle = Заголовок
HelloMsg = Превед!

В случае если надо надо несколько языков иметь в одном файле:

<target name="buildSWC-locale">
	<compc output="${dir.lib}/locale.swc" allow-source-path-overlap="true">
		<locale>en_US</locale>
		<locale>ru_RU</locale>
		<source-path path-element="${dir.src}/locale/{locale}"/>
		<include-resource-bundles>Resources</include-resource-bundles>
	</compc>
</target>

Компилятор будет поочередно перебирать локали и подставлять их вместо {locale}.
И в данном случае надо будет добавить опцию allow-source-path-overlap=”true”.

SWC файл со стилями:

<target name="buildSWC-styles">
	<compc output="${basedir}/swc/style.swc">
		<include-file name="MyStyles.css" path="${dir.src}\css\MyStyles.css" />
	</compc>
</target>

Полезные ссылки:
Adobe: About SWC files
Adobe: Understanding SWC files
Adobe: Using the compc task
Adobe: Creating resources
Adobe: Using resource modules
Adobe: Easily compile resource bundles using Ant
Adobe: Compiling a theme SWC file
Делаем правильные swc библиотеки

Функция загрузки будет выглядеть так:

Здесь можно скачать пример проекта (flashdevelop, клиентская часть), который архивирует текстовые данные используя FZip и отправляет файл на сервер.

1. Необходимые файлы.

Adobe AIR SDK 2.5: (depositfiles.com)
Android SDK: Свежие весии на android.com (depositfiles: sdk r09, sdk r10)
AIR Runtime Android: (один из них нужен, если будете устанавлиавать приложение на реальное устройство)
com.adobe.air.v2.5.0.1660.apk.zip
com.adobe.air.v2.5.1.1774.apk.zip
com.adobe.air.v2.6.apk.zip
AIR Runtime Android Emulator Froyo (для эмулятора):
Runtime_Emulator_Froyo_20100930.zip
Исходники приложения (FlashDevelop проект, примеры .bat-скриптов упаковки и устновки apk и скрипты apache ant): AF4droid.sources

2. Установка.

. Распаковываем Adobe AIR SDK 2.5 прямо в папку с flex sdk (я использовал версии 3.4 и 4.1 – обе успешно:) )

. Запускаем installer_r10-windows.exe.
. Если вас встречает такой скрин,

то вам нужко скачать Java JDK (depositfiles: JDK 6.24, win32 jdk-6u24-windows-i586.exe.zip).
. Next, Next.. Start SDK Manager:

. На следющем скрине выбираем пункты которые надо установить. Я добавил USB driver и выбрал sdk 2.2. Позже всегда можно доустановить необходимое. (все будет выкачиваться с сети)

. Ждем установки, потом появится “Done. 5 Packages Installed.” и жмем Close.
. Теперь слева выбираем Virtual Devices и жмем New.

. Выбираем необходимый API и другие настройки и жмём Create AVD:

. После успешного создания выбираем эмулятор в списке и кликаем Start. Откроется окно эмулятора. Процесс запуска очень не спешен и занимает некоторое время.

. Пока эмулятор запускается, компилируем наше приложение. Собирается оно аналогично простому air-приложению за исключением:

• application.xml:
  <?xml version="1.0" encoding="utf-8" ?>
  <application xmlns="http://ns.adobe.com/air/application/2.5">
    <id>AF4droid</id>
    <name>AF4_droid</name>
    <versionNumber>1.0</versionNumber>
    <supportedProfiles>mobileDevice</supportedProfiles>
    <filename>AF4droid</filename>
    <description></description>
    <copyright></copyright>
    <initialWindow>
      <title>AF4_droid</title>
      <content>AF4droid.swf</content>
      <visible>true</visible>
    </initialWindow>
    <!--<icon>
      <image72x72>icons/icon_72.png</image72x72>
    </icon>-->
  </application>

  1. versionNumber вместо version;
  2. иконка имеер размер 72х72 пикселя;
  3. добавлен тэг supportedProfiles.

• При сборке APK-файла добавляется директива -target apk сразу вслед за -package
  Внимание: для приложений для эмулятора использовать надо -target apk-debug

. Создаем простое приложение и билд-скрипт для apache ant. Перепроверьте flexSDK, androidSDK и другие пути.

Main.mxml:

build.properties:

buildAPK.xml:

Результатом выполнения скрипта будет файл AF4droid.apk, который и будет устанавливаться на устройства.

. Вернемсяя к нашему эмулятору. Успешно запущенный эмулятор выглядит так:

.Теперь нам надо установить на эмулятор AIR Runtime.
Общий вид команды установки APK-файлов:

adb нахдится в android-sdk\platform-tools. Можете добавить путь к этой папке в системные переменные операционно системы.
ключ -e указывает что комманда должна выполняться на эмуляторе;
ключ -r указывает что приложение должно быть переустановленно в случае, если оно уже было установленно ранее.

. Копируем файл Runtime_Emulator_Froyo_20100930.apk в корень D:/ и устанавливаем его на виртуальное устройство:

Если установка успешна, то в Settings/Applications/Manage Applications/ появится Adobe AIR.

. Теперь надо установить наш APK-файл. Копируем его в корень D:/ (либо укажите полный путь к нему)

. В меню появится наше приложение:

. И, собственно, само приложение

Пояснения:
Исходный код приложения:
Т.к. сертификат уже сгенерирован (со стандартным паролем fd), то для создания APK достаточно запустить ant-скрипт, который скомпилирует приложение и упакует APK.
Файлы InstallAPK.bat и PackageAPK.bat приведены для ознакомления.

Простой пример DES шифрования (исходный код с исправленным AESKey.as)

Оказывается две главы из него уже есть на русском языке в блоге racer242:
Именование
Использование языка программирования

UPD: 29.05.2008
Три главы: Структура файла