Включаемые файлы и навигация между файлами
PRO отслеживает связи inc между проиндексированными файлами .gpp. Эти связи задают контекст для автодополнения, подсказок при наведении, переходов к определениям, поиска ссылок, переименования и диагностики между файлами.
Пример из двух файлов
Заголовок раздела «Пример из двух файлов»Поместите эти файлы в один локальный проект PRO:
C:\Postprocessors\MyMachine\ gppl.project.json MyMachine.gpp helpers.gppВ MyMachine.gpp:
inc "helpers"
@init_postendp
@start_of_file call @usr_messageendpВ helpers.gpp:
@init_incendp
@usr_message ; Helper procedure used by the main file.endpРасширение .gpp в директиве включения можно опустить. Поддерживаются одинарные и двойные кавычки. После индексации нажмите F12 на @usr_message в основном файле для перехода к определению в helpers.gpp; Shift+F12 покажет ссылки.
Эти файлы демонстрируют поведение редактора и не являются полным постпроцессором станка.
Пути включаемых файлов
Заголовок раздела «Пути включаемых файлов»Используйте локальные относительные пути. PRO разрешает включение относительно каталога файла, содержащего директиву, и целевой файл должен оставаться внутри дерева этого каталога. PRO может анализировать пути в дочерние каталоги; абсолютные пути, UNC-пути и пути за пределы каталога включающего файла отклоняются.
Корень проекта не делает допустимыми ссылки через .. на соседние каталоги. Размещайте общие файлы в подкаталогах каталога включающего файла и внутри индексируемого проекта. Ссылки также должны оставаться в пределах разрешённого локального пути.
Кликабельная ссылка включения в Community поддерживает только имена соседних файлов. Открытие целевого файла по ссылке и анализ символов между файлами — отдельные возможности.
Основной файл и VMID
Заголовок раздела «Основной файл и VMID»Обычно компонент содержит один основной файл с @init_post, а вспомогательные файлы используют @init_inc. Если @init_post объявлен в нескольких кандидатах, PRO сообщает GPPL2013. Проверьте, не должен ли вспомогательный файл использовать @init_inc, или укажите нужный основной файл через entryPoints в манифесте проекта.
Выбор основного файла также определяет, какой VMID предоставляет включаемым файлам параметры конкретного станка.
Распространённые проблемы
Заголовок раздела «Распространённые проблемы»- Целевой файл не найден (
GPPL2012): проверьте относительное имя, расположение на диске, исключения сканера и ограничение числа файлов. - Цикл (
GPPL2010): уберите связь, из-за которой цепочка возвращается к одному из предыдущих файлов. - Превышена глубина (
GPPL2011): сократите вложенность до поддерживаемых 16 уровней. - Путь отклонён (
GPPL2014): переместите включаемый файл внутрь разрешённого дерева локальных каталогов. - Повторное объявление глобальной переменной (
GPPL2015): оставьте одно объявление этой глобальной переменной в компоненте.
Дерево GPPL Project показывает корневые файлы и вложенные связи включения. Для более широкого поиска символов используйте команду VS Code Go to Symbol in Workspace. Перед применением переименования между файлами просмотрите изменения во всех затронутых файлах.