Проекти бібліотек дозволяють формувати бібліотеки для користувача код, які можуть спільно використовуватися додатками або поширюватися серед інших розробників. Проект бібліотеки створює файл SWC, що представляє собою архівний файл компонентів Flex та інших ресурсів. Наприклад, інфраструктура Flex міститься в файлах SWC. При створенні проекту Flex файли SWC інфраструктури Flex додаються в шлях до бібліотеці проекту. Шлях бібліотеки можна переглядати і редагувати на сторінці властивостей шляху збірки проекту (для проектів Flex виберіть «Проект»> «Властивості»> «Шлях збірки Flex»).
Файл SWF архівується в файл SWC, що містить компоненти, ресурси і файл catalog.xml. Останній являє собою файл маніфесту, який містить інформацію про включені в файл SWF елементах. Як правило, файл SWF містить один або більше компонентів і будь-які інші необхідні ресурси. Додавання бібліотеки до проекту дозволяє використовувати ці компоненти в додатку, а також включає підказки коду для даних компонентів.
Крім забезпечення зручного способу упаковки і розподілу компонентів, бібліотеки SWC використовуються в якості тем (зовнішнього вигляду додатків Flex). Файл теми SWC містить файл CSS і всі пов'язані графічні ресурси. Для отримання додаткової інформації про створення та використання тим см. About themes.
Бібліотеки рекомендується використовувати при створенні компонентів виключно за допомогою ActionScript з подальшим використанням їх в режимі «Дизайн» в Flash Builder. Компоненти ActionScript візуально не відображаються в режимі «Дизайн» до тих пір, поки не будуть скомпільовані в файл SWF. При додаванні компонентів ActionScript до проекту бібліотеки створюється файл SWF, що міститься у файлі SWC. Можна додати бібліотеку в шлях до бібліотеці проекту. Після додавання в додаток компоненти ActionScript візуально відображаються в режимі «Дизайн».
Налаштування бібліотек для додатків
Бібліотеки SWC використовуються в проектах в наступному вигляді:
Об'єднані в додаток При додаванні файлу SWC в шлях до бібліотеці проекту компоненти, що містяться в бібліотеці, стають доступні для використання в додатку. При створенні програми в файл SWF додатки компілюються тільки фактично використовуються компоненти бібліотеки. Іншими словами, весь код програми об'єднується в один файл SWF. Це найбільш типовий і простий спосіб використання компонентів бібліотек.
Зовнішні по відношенню до додатка Зберігати компоненти бібліотеки можна окремо від скомпільованої файлу SWF, при цьому вони не об'єднуються в файл. Компілятор виконує дозвіл всього коду, що міститься в використовуваної додатком бібліотеці, але не об'єднує код в файл SWF додатки. Перевага такого підходу полягає в зменшенні обсягу файлу SWF додатки. Якщо необхідно, компоненти, що містяться в файлі SWC, витягуються і завантажуються в пам'ять під час виконання.
Загальна бібліотека часу виконання Тільки в проектах Flex можна також використовувати файли SWC в якості загальної бібліотеки часу виконання (RSL), схожою з динамічно пов'язаної бібліотекою на інших платформах. Файли SWC застосовуються в якості RSL, якщо є набір компонентів, що використовуються більш ніж одним додатком.
Існує кілька переваг спільного використання компонентів додатками шляхом застосування RSL. По-перше, бібліотека завантажується в пам'ять один раз, кешируєтся і потім стає доступна всім додаткам, що використовують дані компоненти. По-друге, компоненти, що містяться в бібліотеці, завантажуються тільки при необхідності, що скорочує час запуску програми за рахунок зменшення розміру кожного з додатків. Потенційна проблема даного методу полягає в тому, що в пам'ять завантажується вся бібліотека RSL, а не окремі використовувані додатком компоненти. Для отримання додаткової інформації про використання файлів SWC в якості RSL см. Using Runtime Shared Libraries.
Створення проектів бібліотеки Flex
При створенні проекту бібліотеки за допомогою процедур майстра створення проекту бібліотеки Flex користувачеві пропонується вказати ім'я проекту, місце розташування і інформацію про шляхи збірки. Після створення проекту бібліотеки додаються компоненти, вказуються елементи проекту бібліотеки для використання в файлі SWC і потім формується проект для створення файлу SWC. Першим кроком у створенні файлу SWC в Flash Builder є створення проекту бібліотеки Flex.
Виберіть пункти меню «Файл»> «Створити»> «Проект бібліотеки Flex».
Введіть ім'я проекту, потім вкажіть наступне:
Місцезнаходження проекту Місцем розташування за замовчуванням є поточна робоча область. Для платформ Windows місцем розташування робочої області за замовчуванням є C: \ Documents and Settings \ Розробник Flex \ Adobe Flash Builder \. В системі Macintosh місцем розташування робочої області за замовчуванням є / Users / Розробник Flex / Adobe Flash Builder /. Вибір іншого місця розташування проекту здійснюється шляхом зняття прапорця «Використовувати розташування за замовчуванням».
Версія Flex SDK Виберіть значення за замовчуванням або певне значення. Натисканням на посилання «Налаштувати SDK» здійснюється перехід на головну сторінку параметрів, де доступні операції додавання, редагування або видалення SDK.
Включити бібліотеки Adobe AIR Встановіть цей прапорець, якщо потрібно використання бібліотекою функцій AIR, наприклад, доступу до інтерфейсів AIR API. Далі Flash Builder змінює шлях до бібліотеки даного нового проекту бібліотеки Flex для включення в нього файлів airglobal.swc і airframework.swc. Використання даної бібліотеки web-проектами Flex неможливо.
Не встановлюйте цей прапорець, якщо записується загальна бібліотека, призначена для використання тільки в web-додатку Flex, а також або в web-додатку, або в AIR-додатку.
Натисніть кнопку "Далі".
(Додатково) Задайте дані шляху збірки. Наприклад, можна додати папки до вихідного шляху проекту, який містить компоненти для використання в файлі SWC. Можна також додати інші проекти, папку або файли SWC бібліотеки для включення в проект бібліотеки. Див. Використання файлів SWC в проектах.
Після закінчення введення параметрів проекту натисніть «Готово».
Додавання компонентів до проекту бібліотеки
Компоненти додаються до проекту бібліотеки наступними способами:
Додайте до проекту нові або існуючі користувальницькі компоненти, класи ActionScript і інші ресурси.
Створіть посилання на існуючі компоненти в інших проектах робочої області. (Див. Зв'язування з ресурсами поза робочої області проекту.)
Додайте до вихідного шляху проекту бібліотеки пов'язану папку, яка містить компоненти. (Див. Розділ Додавання папок з ресурсами до вихідного шляху проекту.)
Примітка. Всі включені в проект бібліотеки компоненти повинні бути пов'язані з проектом бібліотеки (безпосередньо або як пов'язані ресурси).
Вибір елементів проекту бібліотеки для використання в файлі SWC
Наступним кроком у створенні файлу бібліотеки SWC є вибір елементів (компонентів і ресурсів) для використання в файлі SWC при його складанні компілятором.
Виберіть пункти меню «Проект»> «Властивості»> «Шлях збірки бібліотеки Flex».
На вкладці «Класи» з'являться додані в проект компоненти (як безпосередньо, так і шляхом зв'язування з ними).
Виберіть класи компонента для використання в файлі SWC.
(Додатково) Виберіть вкладку «Ресурси» і виберіть ресурси для використання в файлі SWC.
Завершивши вибір, натисніть «OK».
Створення проектів бібліотеки
Після вибору елементів для використання в файлі SWC при установці прапорця «Виконати компоновку автоматично» файл SWC негайно компілюється і створюється в папці виведення проекту. При складанні проектів вручну можна при необхідності сформувати проект бібліотеки, вибравши пункти «Проект»> «Виконати компоновку проекту» або «Виконати компоновку всього».
При компонуванні проекту бібліотеки створюється файл SWC, який можна використовувати спільно з іншими додатками або користувачами.
Файл SWC є архівним. Файл SWC відкривається будь-яким архіватором, наприклад, WinZip. Всередині файлу SWC знаходяться файли library.swf і catalog.xml. Також є файли властивостей і інші вбудовані ресурси.
Можна експортувати бібліотеку як відкритий каталог, а не як файл SWC. Зазвичай експорт бібліотеки у вигляді відкритого каталогу здійснюється при плануванні використання файлу library.swf всередині файлу SWC в якості бібліотеки RSL.
Для цього необхідно налаштувати параметри компілятора directory і output. Параметру output присвоюється ім'я створюваного каталогу, параметру directory присвоюється значення true. вказує на використання при формуванні бібліотеки відкритого каталогу, а не файлу SWC. Для редагування параметрів компілятора виберіть «Проект»> «Властивості»> «Компілятор бібліотеки Flex» і додайте параметри в поле «Додаткові аргументи компілятора», наприклад:
Flash Builder створює каталог в проекті під ім'ям myOpenDir і зберігає в ньому вміст файлу SWC.
Використання файлів SWC в проектах
Для використання файлів SWC в проектах Flex необхідно додати їх у шлях до бібліотеці проекту. Файли SWC можуть перебувати в проекті, в проекті бібліотеки Flex, в загальнодоступній папці всередині робочої області або будь-якому іншому пов'язаному з проектом місці (наприклад, в загальнодоступній папці, доданої до вихідного шляху проекту).
При використанні файлів SWC в додатках доступні параметри конфігурації, що визначають, статично або динамічно пов'язані файли з додатком, об'єднані вони в файл SWF додатки або ж є зовнішніми по відношенню до додатка файлами, доступ до яких здійснюється окремо під час виконання.
Додавання файлу SWC в шлях до бібліотеки
В обраному проекті провідника пакетів виберіть пункти меню «Проект»> «Властивості»> «Шлях збірки Flex».
Перейдіть на вкладку «Шлях до бібліотеки».
Виберіть будь-який з цих параметрів для додавання файлів SWC:
Додати проект Додає проект бібліотеки Flex.
Додати папку SWC Додає папку, яка містить файли SWC.
Додати SWC Додає скомпільований файл SWC.
Додати Flex SDK Дозволяє додавати інші SDK Flex. Якщо в дорозі до бібліотеки проекту вже є Flex SDK, ця кнопка відключена. Якщо з шляху до бібліотеки видаляється існуючий Flex SDK, ця кнопка включена. При натисканні цієї кнопки додається вузол Flex SDK, але інформація про те, який з них доданий, не виводиться. Для управління інформацією про використаний Flex SDK виберіть «Проект»> «Властивості»> «Компілятор Flex».
Введіть або виберіть розташування файлу SWC, проекту або папки. Натисніть кнопку «OK».
Файл SWC, проект бібліотеки або папка додані в шлях до бібліотеки.
Об'єднання файлу SWC з файлом SWF додатки при компіляції
В обраному проекті провідника пакетів виберіть пункти меню «Проект»> «Властивості»> «Шлях збірки Flex».
Перейдіть на вкладку «Шлях до бібліотеки», а потім оберіть і розгорніть запис файлу SWC для відображення параметрів SWC.
Двічі клацніть параметр «Тип посилання». З'являється діалогове вікно «Параметри елемента шляху до бібліотеки».
Виберіть параметр «Об'єднане з кодом» і натисніть «OK».
Ця процедура еквівалентна використанню параметра компілятора library-path.
Установка файлу SWC в якості зовнішнього файлу бібліотеки
В обраному проекті провідника пакетів виберіть пункти меню «Проект»> «Властивості»> «Шлях збірки Flex».
Перейдіть на вкладку «Шлях до бібліотеки», а потім оберіть і розгорніть запис файлу SWC для відображення параметрів SWC.
Двічі клацніть параметр «Тип посилання». При цьому з'явиться діалогове вікно «Параметри елемента шляху до бібліотеки».
Виберіть параметр «Зовнішній» і натисніть «OK».
Ця процедура рівнозначна використання параметра компілятора external-library-path.
Використання файлу SWC в якості RSL
В обраному проекті провідника пакетів виберіть пункти меню «Проект»> «Властивості»> «Шлях збірки Flex».
Перейдіть на вкладку «Шлях до бібліотеки», а потім оберіть і розгорніть запис файлу SWC для відображення параметрів SWC.
Двічі клацніть параметр «Тип посилання». З'являється діалогове вікно «Параметри елемента шляху до бібліотеки».
Виберіть параметр «Загальна бібліотека часу виконання (RSL)».
(Додатково) Для вилучення файлу SWF з файлу SWC при його розміщенні в місці розгортання виберіть параметр «Автоматично отримувати SWF в шлях розгортання».
Натисніть кнопку «OK».
Використання файлів SWC в якості бібліотеки RSL спрощує процес застосування RSL вручну. Для цього вийміть файл SWF з файлу SWC і налаштуйте значення параметра компілятора runtime-shared-library-path.
Для отримання додаткової інформації про використання файлів SWC в якості RSL см. Using Runtime Shared Libraries в документі Використання Adobe Flex 4