Використання дескрипторів наборів засобів C

Укладач: Жовтень 2013 [Номер версії: V7.4-1]

  • Вступ
  • Набори коштів
  • Набори інструментів, надані спільнотою
  • Зміна дескрипторів наборів коштів
  • Створення користувальницького набору коштів
  • Додаткові відомості про файл набору XML
  • Створення постачальника спеціального компілятора
  • Створення обробника помилок для компілятора користувача

Для роботи з цим навчальним курсом потрібне програмне забезпечення, вказане нижче.

Щоб отримати додаткові відомості про завантаження та встановлення необхідного програмного забезпечення, див. Інструкції з інсталяції IDE NetBeans та Налаштування IDE NetBeans для C/C++/Fortran.

Цей практичний посібник містить інструкції щодо зміни наявних наборів коштів та створення власної версії набору коштів на основі наявного в IDE NetBeans 7.4.

Наведений приклад відноситься до набору засобів GNU для Solaris і Linux, але загальні принципи застосовні також для Windows і Mac. Використовуючи інформацію в цьому посібнику, ви навчитеся робити таке:

  • Змінювати прапори компіляторів, які IDE NetBeans використовує за замовчуванням для компіляції файлів C/C++
  • Додавати компілятори, які не підтримуються серед IDE

Набори коштів

У набір засобів входять набір компіляторів, утиліта make та відладчик. Набір коштів визначається IDE за допомогою дескриптора наборів інструментів. При кожній компіляції, створенні або налагодженні коду IDE NetBeans запускає виконуваний файл, описаний у дескрипторі наборів засобів для набору коштів, заданих у налаштуваннях проекту. Функції 'Допомога прироботи з кодом' використовують шляхи include і макроси з дескриптора наборів засобів.

Дескриптор набору засобів - це XML-файл, розташований у модулі IDE_HOME/cnd/modules/org-netbeans-modules-cnd-toolchain.jar, який знаходиться в папці org/netbeans/modules/cnd/toolchain/resources/toolchaindefinition/. Вносити зміни до вихідних XML-файлів дескриптора засобів IDE не рекомендується.

Набори інструментів, надані спільнотою

Деякі модулі, що підключаються, для наборів коштів розроблені учасниками спільноти NetBeans:

Нагадуємо, що ці модулі, що підключаються, офіційно не підтримуються, але наводяться з довідковою метою, оскільки можуть послужити в якості основи для створення ваших власних модулів, що підключаються.

Зміна дескрипторів наборів коштів

Зміна дескрипторів наборів засобів є непростим завданням, оскільки в IDE NetBeans відсутній графічний інтерфейс користувача для зміни дескрипторів. У цьому розділі описується створення 'тіньових' копій дескрипторів наборів інструментів, які можна змінити, якщо потрібно, щоб у середовищі IDE використовувалися інші засоби.

  1. Завершіть роботу середовища IDE, якщо вона запущена.
  2. Відредагуйте файл IDE-HOME/etc/netbeans.conf, де IDE-HOME – каталог установки NetBeans.
  3. Додайте наступний прапор до запису netbeans_default_options:
  4. Запустіть середовище IDE, оберіть "Сервіс" > "Параметри", потім у верхній панелі вікна параметрів виберіть "C/C++".

IDE створює 'тіньові' версії дескрипторів наборів коштів у каталозі користувача NetBeans:

Розташування каталогу користувача NetBeans залежить від операційної системи. Можливі варіанти розташування каталогу userdir/config/CND/ToolChain:

  • Windows: C:\Documents and Settings\username\Application Data\NetBeans\version\config\CND\ToolChain
  • Mac: /Users/username/Library/Application Support/NetBeans/version/config/CND/ToolChain
  • Linux та Solaris: /home/username/.netbeans/version/config/CND/ToolChain

Список дескрипторів має бути аналогічним наступному:

Ви можете змінити дескриптор для використовуваного набору коштів. Наприклад, якщо ви використовуєте засоби GNU в ОС Solaris, необхідно відредагувати файл GNU_solaris.xml; Якщо ви використовуєте MinGW в Windows, необхідно відредагувати файл MinGW.xml.

Відомості про теги, які використовуються в XML-файлах дескриптора, див. у розділі Детально про XML-файли набору засобів. Можна змінити значення тегів. У цьому випадку відповідним чином зміниться функціонування засобів IDE.

Дескриптори, що містяться в цьому каталозі, мають більш високий пріоритет у порівнянні з офіційними версіями в каталозі IDE-HOME. Якщо ви не бажаєте, щоб у середовищі IDE використовувалися деякі дескриптори коштів, видаліть їх зі свого каталогу користувача.

  • Видаліть прапорець -J-Dcnd.toolchain.personality.create_shadow=true з файлу IDE-HOME/etc/netbeans.conf, щоб у середовищі IDE більше не створювалися тіньові копії дескрипторів.
  • Перед використанням зміненого дескриптора засобів необхідно перезапустити IDE.

    • Створення користувальницького набору коштів

    Цей розділ містить інструкції щодо створення набору засобів на основі набору засобів GNU. У новому наборі коштів буде змінено прапори компілятора налагодження. У прикладі показано етапи створення нового модуля NetBeans із новим набором коштів. Цей модуль дозволяє спільно використовувати набір коштів, а також використовувати набір коштів в іншихекземплярах IDE.

    Щоб отримати загальні відомості про створення модулів NetBeans, див. Посібник з початку роботи з модулями, що підключаються, в середовищі NetBeans.

    Щоб створити власний набір коштів:

      Переконайтеся, що до складу встановленого екземпляра NetBeans входить модуль NetBeans Plugin Development.

    Цей файл є дескриптором нового набору коштів.

  • Скопіюйте наступний текст у GNU_tuned_flavor.xml:
  • Створіть інший файл. Клацніть правою кнопкою миші підпакет org.myhome.mytoolchain.toolchain і виберіть Створити > Порожній файл. Назвіть файл GNU_tuned_cpp.xml та натисніть кнопку Next ("Далі").
  • Скопіюйте наступний текст у GNU_tuned_cpp.xml:

    • Зверніть увагу на встановлені прапори -g3 та -gdwarf-2, які відрізняються від прапорів, встановлених в описі набору засобів GNU за замовчуванням.

    Дерево проекту має виглядати так:

    використання

    Папки 'Тест модуля' можуть бути відсутніми.

  • У вікні 'Проекти' клацніть правою кнопкою миші вузол проекту mytoolchain та виберіть 'Виконати'. У новому екземплярі середовища IDE буде створено і встановлено модуль, що є цільовою платформою за замовчуванням для модулів. Відкриється цільова платформа для випробування нового модуля.
  • У модулі виберіть "Сервіс" > "Параметри", потім у верхній панелі вікна параметрів виберіть "C/C++" і перейдіть на вкладку "Засоби збирання".
  • Якщо новий набір засобів (GNU_tuned) не відображається, натисніть кнопку "Відновити стандартні параметри". У запиті на повторний пошук у середовищі натисніть кнопку "Так", щоб продовжити роботу.

    • У середовищі IDE з'явиться новий набір коштів:

    наборів
  • Створіть новий приклад проекту C/C++ Welcome шляхом вибору"Файл" > "Створити проект" > "Приклади" > "C/C++" > "Welcome".
  • Клацніть правою кнопкою вузол проекту та виберіть "Властивості". У діалоговому вікні "Властивості проекту" виберіть вузол "Складання", вкажіть набір засобів GNU_tuned, потім натисніть кнопку "OK" .
  • Виконайте складання проекту. Перевірте, чи для компілятора встановлено прапори -g3 -gdwarf-2
  • У діалоговому вікні "Властивості проекту" виберіть набір засобів GNU та натисніть кнопку "ОК".
  • Виконайте повторне складання проекту та порівняйте рядок компіляції з рядком у вікні виводу:

    • Як бачите, набір засобів GNU_tuned містить інші прапори компілятора для налагодження режиму розробки в компіляторі GNU.

    Для використання нового модуля для набору засобів GNU_tuned у стандартному середовищі можна створити двійковий файл (файл .nbm) і додати його як модуля, що підключається:

    Додаткові відомості про файл набору XML

    У цьому розділі описується більшість найважливіших тегів у файлі XML набору коштів.