Импорт проектов
Какой-либо непосредственный исходный файл проекта P
может зависеть от исходных файлов, которые не являются непосредственными исходными файлами проекта P
и не содержатся в предопределенной библиотеке.
Для получения такого эффекта проект P должен импортировать проекты, которые содержат необходимые исходные файлы:
| with "project1", "utilities.gpr"; with "/namings/apex.gpr"; project Main is
... |
В показанном выше примере можно увидеть, что синтаксис, который используется для импортирования проектов, подобен синтаксису Ады, который используется для импортирования компилируемых моделей.
Однако, в файлах проектов вместо имен используются строковые литералы, и в спецификаторе with указываются файлы проектов а не пакеты.
Каждый строковый литерал является именем файла проекта или полным именем файла проекта (абсолютным или относительным). Если строка является простым именем файла, без указания пути к каталогу, то расположение файла определяется с помощью пути к каталогу проекта (project path):
Если используется относительный путь к каталогу проекта
| with "tests/proj"; |
то путь к каталогу проекта определяется относительно каталога в котором расположен импортирующий (текущий) файл проекта.
Полная расшифровка любых символьных ссылок осуществляется в каталоге импортирующего файла проекта перед обнаружением и выборкой импортируемого файла проекта.
Когда имя файла проекта, которое указано в спецификаторе with, не содержит расширения имени файла, по умолчанию, подразумевается расширение имени файла ".gpr".
Если указанное имя файла с таким расширением не обнаружено, то будет использовано имя файла без расширения (как непосредственно указано в спецификаторе with).
Таким образом, согласно показанного выше примера: если обнаружен файл "project1.gpr", то он будет использован; в противном случае, если обнаружен файл "project1", то он будет использован; если не найден ни один из этих файлов, то это будет ошибкой.
При несовпадении имени проекта с именем файла проекта, генерируется предупреждающее сообщение (эта проверка не зависит от регистра символов).
Любой исходный файл, который является непосредственным исходным файлом импортируемого проекта, может быть использован непосредственным исходным файлом импортирующего проекта, и рекурсивно.
Таким образом, если A импортирует B, а B импортирует C, то непосредственные исходные файлы A
могут зависеть от непосредственных исходных файлов C, даже если A не импортирует C явным образом.
Однако, использование такого подхода не рекомендуется, поскольку возможна ситуация, когда B прекратит импортировать C; после чего некоторые исходные файлы в A перестанут компилироваться.
Побочным эффектом такой способности является то, что циклические зависимости - не допустимы: если A импортирует B (прямо или косвенно), то для B не разрешается импортировать A.
