Функції програми Flash Builder включають в себе створення, додавання, оптимізацію і налагодження модулів. Докладні відомості про створення коду модуля см. В розділі Модульні програми.
У наступних кроках описується процес створення модуля в програмі Flash Builder. Після створення модуля можна виконати його компіляцію.
У Flash Builder виберіть пункти «Файл»> Створити »>« MXML-модуль ». При цьому відкриється діалогове вікно «Новий MXML-модуль».
Виберіть вищестоящий каталог для модуля. Як правило, модулі зберігаються в тому ж каталозі, що і основне додаток, тому відносні шляхи до загальнодоступних ресурсів будуть збігатися.
Модулі є виконуваними об'єктами і, отже, повинні перебувати у вихідній папці проекту.
Введіть ім'я файлу для модуля, наприклад MyModule.
Введіть значення властивостей «Ширина», «Висота» і «Макет» для модуля.
Вкажіть, чи слід оптимізувати модуль.
При оптимізації модуля для додатка класи, використовувані в додатку, виключаються з модуля. Це може привести до зменшення обсягу даних при завантаженні файлів SWF. Для отримання докладної інформації див. Розділ Оптимізація модулів в програмі Flash Builder.
Оптимізувати для додатка
При виборі цього параметра вкажіть додаток, для якого слід оптимізувати модуль.
При виборі цього параметра всі класи включаються в модуль незалежно від того, чи визначено вони в головному додатку. Це може підвищити швидкість виконання инкрементной компіляції. Крім того, модуль можна завантажувати в будь-який додаток, оскільки всі його залежності скомпільовані в цей модуль.
Натисніть кнопку «Готово».
Програма Flash Builder забезпечить додавання нового файлу модуля MXML в проект.
компіляція модулів
У програмі Flash Builder можна запустити модуль, як якщо б він був додатком, або сформувати проект модуля. Якщо модулі знаходяться в тому ж проекті, що і додаток, то при запуску програми файли SWF для всіх модулів будуть скомпільовані Flash Builder. Потім під час виконання файли SWF завантажуються в додаток.
Файл SWF на основі модуля неможливо запустити як автономний файл SWF або завантажити у вікно браузера. Файл повинен бути завантажений додатком в якості модуля. При запуску в програмі Flash Builder для компіляції модуля необхідно закрити програвач Adobe Flash Player або вікно браузера і ігнорувати всі помилки. Модулі не повинні запитуватися безпосередньо програвачем або браузером.
Як правило, SWF-файли модуля і основного додатки знаходяться в одному каталозі, хоча компіляція модулів в Flash Builder виконується одночасно з додатком незалежно від їх розташування. Модулі можуть перебувати в тому ж каталозі, що і додаток, або в підкаталогах.
Також можна створити окремий проект Flex або ActionScript для кожного модуля або для груп модулів. Це призведе до збільшення можливостей управління процесом компіляції модулів, оскільки для кожного проекту можуть встановлюватися параметри компілятора, відмінні від параметрів програми або інших модулів. Це також дозволить виконувати компіляцію проекту або проектів модулів без компіляції програми. Однак для цього способу потрібно ручна компіляція кожного модуля перед виконанням компіляції програми. Для цього можна, наприклад, одночасно скомпілювати всі відкриті проекти в Flash Builder.
Якщо модулі компілюються окремо від головного додатки, необхідно переконатися у включенні або виключенні інформації про налагодження в залежності від того, чи потрібно налагодження програми та модулів. Для отримання докладної інформації див. Розділ Налагодження модулів в програмі Flash Builder.
Робочий процес Flash Builder розроблений для використання пов'язаних модулів в одному додатку. Якщо модулі повинні застосовуватися в декількох додатках, розгляньте можливість інкапсулювання коду в компонент бібліотеки або клас і його включення до простого модуль для кожної програми. Модулі не призначені для багаторазового використання коду в різних додатках, для цього існують бібліотеки.
Використання декількох проектів для модулів
Під час налаштування архітектури проекту можна включити модулі в проект програми, створити окремий проект для кожного модуля або окремий проект для всіх модулів.
Використання одного проекту для кожного модуля
Використання одного проекту для кожного модуля має такі переваги:
Проекти модулів можуть розміщуватися в будь-якій точці робочої області.
Проектам модулів можуть відповідати власні параметри налаштування компілятора, наприклад користувальницький шлях до бібліотеки.
Для видалення суміщених залежностей в проектах модуля може використовуватися параметр компілятора load-externs.
Використання одного проекту для кожного модуля має такі недоліки:
Наявність великої кількості проектів призводить до збільшення обсягу використовуваної пам'яті.
Наявність великої кількості проектів в одній робочій області може призвести до переповнення робочої області.
За замовчуванням при компіляції додатка компіляція виконується не для всіх проектів модулів навіть у тому випадку, якщо вони були змінені.
Для оптимізації розміру файлу модуля необхідно вручну застосувати параметри компілятора load-externs і link-report.
Використання одного проекту для всіх модулів
Пов'язаний підхід передбачає використання одного проекту для всіх модулів при збереженні додатки в його власному окремому проекті. Він має деякі недоліки, характерними для використання одного проекту для програми та модулів, але також має і безліч переваг, оскільки для кожного модуля застосовується окремий проект.
Використання одного проекту для всіх модулів має такі переваги:
Проект модуля може розташовуватися в будь-якій точці робочої області.
Можлива компіляція тільки модулів або тільки додатки без необхідності одночасної повторної компіляції і того, і іншого.
Для видалення суміщених залежностей в проекті модуля може використовуватися параметр компілятора load-externs.
Використання одного проекту модуля для всіх модулів має такі недоліки:
У всіх модулях модульного проекту повинні використовуватися одні й ті ж параметри налаштування компілятора, такі як шлях до бібліотеки.
За замовчуванням при компіляції додатка проект модуля не компілюється навіть в тому випадку, якщо він був змінений.
Для оптимізації розміру файлу модуля необхідно вручну застосувати параметри компілятора load-externs і link-report.
Створення проектів для модулів
При створенні окремого проекту для модулів папка виведення проекту модуля змінюється на каталог, який використовується додатком. Також пригнічується створення файлів-оболонок.
Створення окремого проекту модулів в програмі Flash Builder
Створіть основний проект.
Створіть проект для модуля або модулів.
Виберіть пункт «Властивості» в контекстному меню проекту модуля. Відкриється діалогове вікно «Властивості».
Виберіть варіант «Шлях збірки Flex».
Змініть папку виведення, яка повинна вказувати на каталог модулів MainProject. Наприклад, змініть її на наступне:
Таким чином, вихідні дані компіляції модуля будуть перенаправлені в каталог ресурсів проекту програми (MainProject). У головному додатку можна визначити властивість url ModuleLoader для файлів SWF в каталозі ресурсів. Значення цієї властивості є відносним для папки виведення.
Натисніть кнопку «OK» для збереження змін.
Знову відкрийте властивості проекту та виберіть параметр «Компілятор Flex».
Вимкніть «Створити файл-оболонку HTML». Це запобіжить створення файлів-оболонок HTML в проекті модуля. Зазвичай ці файли використовуються виключно в додатку. Вони не є необхідними для модулів.
Натисніть кнопку «OK» для застосування внесених змін.
Компіляція проектів для модулів
Компіляція декількох проектів в Flash Builder є поширеною операцією. Спочатку визначається порядок компіляції проектів, після чого всі проекти компілюються одночасно.
Одночасна компіляція всіх проектів в програмі Flash Builder
У головному меню виберіть пункти «Проект»> «Виконати компоновку всього».
Програма Flex забезпечує збірку всіх проектів в робочій області. Файли додатки додаються в папку виведення кожного з проектів. Якщо була обрана можливість автоматичного збереження файлів до початку збирання, буде запропоновано збереження файлів.
Якщо буде потрібно зміна порядку складання, слід використовувати діалогове вікно «Порядок компонування». Зміна порядку складання не завжди потрібно. Проекти, що використовують методи, повинні бути скомпільовані тільки під час запуску програми головного проекту, а не при його компіляції. У більшості випадків достатньо порядку складання, заданого за замовчуванням.
Однак при необхідності усунути накласти залежності може знадобитися зміна порядку складання для першочергової компіляції головного додатки. У такому випадку для створення звіту компоновщика використовується параметр компілятора link-report. При компіляції модулів параметр компілятора load-externs забезпечує використання звіту компоновщика, створеного за допомогою програми оболонки. Для отримання докладної інформації див. Розділ Оптимізація модулів в програмі Flash Builder.
Зміна порядку складання проектів
Відкрийте діалогове вікно «Параметри» і виберіть пункти «Загальні»> «Робоче середовище»> «Порядок компонування».
Відкриється діалогове вікно «Порядок компонування».
Зніміть прапорець «Використовувати порядок компонування за замовчуванням».
Використовуйте кнопки «Вгору» і «Вниз» для зміни порядку проектів в списку «Порядок компонування проекту». Також можна використовувати кнопку «Видалити проект» для видалення проектів, які не є частиною головного додатки або модулями, використовуваними додатком. Віддалений проект підлягає збірці, проте ця операція буде проведена після складання всіх проектів зі списку порядку складання.
Натисніть кнопку «OK».
Змініть потрібним чином параметри або натисніть кнопку «OK».
Якщо розробник створює залежності між окремими проектами в робочій області, компілятор автоматично визначає порядок складання проектів і залежності встановлюються належним чином.
При використанні окремого проекту для кожного модуля в окремий момент часу можна компілювати один модуль. Це дозволить заощадити час в порівнянні з компіляція всіх проектів відразу або компіляція окремого проекту, що містить всі файли модулів і додатки.
Компіляція окремого проекту модуля
Клацанням правої кнопки миші виберіть файл модуля MXML в проекті модуля.
Виберіть «Запустити програму». Після компіляції модуля здійсниться спроба його запуску у вікні програвача або браузера. Вікно програвача або браузера можна закрити. Також можна ігнорувати всі повідомлення про помилки, які виводяться під час виконання. Запуск модулів безпосередньо в програвачі або браузері не передбачений.
Додавання модулів в проект
У деяких випадках використовуються модулі, не включені в проект головного додатки. Наявність модуля в окремому проекті може знадобитися для використання призначених для користувача параметрів конфігурації або спільного застосування модуля кількома додатками. Перед тим як використання модуля в проекті стане можливим, необхідно додати вихідний код модуля в вихідний шлях додатки, а потім додати модуль в список модулів програми.
Додавання скомпільованої модуля в проект
Виберіть головне додаток в провіднику пакетів Flex.
Щоб додати вихідний код модуля в вихідний шлях проекту програми, виберіть пункти «Проект»> «Властивості»> «Шлях збірки Flex».
Натисніть кнопку «Додати папку» і виберіть вихідний шлях до модуля. Натисніть кнопку «OK» для вибору модуля. Ці дії необхідно виконувати для кожного модуля, який додається до проекту програми.
Знову натисніть кнопку «OK» для збереження змін.
Щоб додати модуль в список модулів програми, виберіть пункти «Проект»> «Властивості»> «Модулі Flex». У діалоговому вікні «Модулі Flex» перераховуються всі модулі, додані в поточний проект або знаходяться в поточному проекті. Спочатку при створенні проекту це діалогове вікно є порожнім.
Натисніть кнопку «Додати». Відкриється діалогове вікно «Додати модуль».
Використовуйте кнопку «Огляд» або введіть розташування файлу MXML модуля в поле «Вихідний код». При застосуванні цього діалогового вікна для додавання доступні всі модулі, що знаходяться в початковому шляху проекту.
Виберіть один з параметрів в області «Розмір модуля SWF» для включення або виключення оптимізації модуля. При виборі параметра «Оптимізувати для додатка» в середовищі Flash Builder виконується компіляція модулів для обраної програми і виключення всіх класів, визначених в головному додатку. До них можуть ставитися класи інфраструктури або призначені для користувача класи. Після вибору цього параметра використання того ж самого модуля в іншому додатку неможливо, оскільки список виключених класів може відрізнятися. Для отримання докладної інформації див. Розділ Оптимізація модулів в програмі Flash Builder.
Натисніть кнопку «OK» для збереження змін. Flash Builder забезпечує додавання модуля в список доступних модулів проекту програми.
Оптимізація модулів в програмі Flash Builder
Для оптимізації модуля в програмі Flash Builder, як правило, вибирається один додаток при первинному створенні модуля або його додаванні в проект. Якщо пізніше буде прийнято рішення змінити додаток, модуль якого буде оптимізований, або оптимізація модуля не потрібно, властивості модуля можуть бути відредаговані в рамках проекту. Для отримання додаткової інформації див. Розділ Зменшення розміру модулів.
Для виконання цієї процедури необхідно, щоб модуль і додаток знаходилися в одному проекті Flash Builder. Якщо модулі знаходяться в різних проектах вручну додайте параметри компілятора load-externs і link-report.
Клацніть правою кнопкою миші по проекту програми в провіднику пакетів Flex і виберіть «Властивості». Відкриється діалогове вікно «Властивості».
У лівій панелі виберіть «Модулі Flex».
У списку модулів виберіть модуль, а потім натисніть кнопку «Редагувати». Відкриється діалогове вікно «Редагувати модуль».
Для видалення результатів оптимізації в області «Розмір модуля SWF» виберіть пункт «Не оптимізувати».
Для оптимізації модуля для іншої програми виберіть новий додаток з спливаючого меню «Оптимізувати для додатка».
Натисніть кнопку «OK».
Для подальшої оптимізації розміру файлу модуля можна видалити інформацію про налагодження. При формуванні модуля в програмі Flash Builder інформація про налагодження включається в модуль за замовчуванням. Шляхом видалення інформації про налагодження можна ще більше скоротити розмір модуля. Інструкції з видалення інформації про налагодження з модулів см. В розділі Налагодження модулів в програмі Flash Builder.
Налагодження модулів в програмі Flash Builder
Для налагодження модулів і додатків необхідно включити інформацію про налагодження в файли SWF при їх компіляції. Для цього в програмі Flash Builder досить запустити додаток, оскільки інформація про налагодження включена в нього за замовчуванням. У командному рядку необхідно встановити значення true параметра компіляції debug. За замовчуванням задається значення true. але якщо воно було деактивовано у файлі конфігурації, необхідно переконатися в тому, що деактивація була скасована.
За замовчуванням у програмі Flash Builder здійснюється складання одного файлу SWF, тому при застосуванні програми, що використовує модулі в Flash Builder, виконуються як запуск, так і налагодження. Однак включення символів налагодження в файл модуля SWF призведе до збільшення розміру файлу SWF. Щоб виключити символи налагодження перед розгортанням, вимкніть налагодження для модулів програми. Для цього експортуйте версію випуску модулів, вибравши пункти «Проект»> «Експорт збірки випуску».
Для виключення інформації про налагодження з файлів SWF в програмі Flash Builder можна встановити для параметра debug значення false в текстовому полі «Додаткові аргументи компілятора» або забезпечити виведення файлів SWF за допомогою функції «Експорт збірки випуску», що створює файли SWF без налагодження. Таким чином забезпечується включення модулів, якщо ці модулі знаходяться в поточному проекті.
При створенні окремого проекту для модулів можна включити або відключити налагодження для всього проекту без зміни параметрів настройки головного додатки.
Якщо буде потрібно налагодження модуля, буде необхідна налагодження програми, що забезпечує завантаження модуля. Отладчик Flex не зможе з'єднатися з додатком, яке не містить інформацію про налагодження, навіть якщо модулі, що завантажуються цим додатком, містять дану інформацію. Іншими словами, якщо буде потрібно налагодження модуля, що завантажується додатком, виняток інформації про налагодження з програми буде неможливо.
При використанні модулів в додатку AIR модуль SWF повинен бути розташований в тому ж самому каталозі, що і головне додаток SWF, або в одному з його підкаталогів.