Создание ассетов сборки
Можно создавать и определять сборки, используя два специальных типа ассетов:
- Ассеты определения сборки (
.asmdef) размещаются в корне папки, содержащей скрипты для определения новой сборки. - Ассеты Справочник по определению сборки (
.asmref) помещаются в корневую папку, содержащую скрипты, чтобы включить эти скрипты в уже существующую сборку.
Создание определения сборки
Чтобы создать определение сборки:
- В окне Project найдите папку, содержащую скрипты, которые нужно включить в сборку.
- Создайте Определение сборки в папке (меню: Ассеты > Создать > Скриптирование > Assembly Definition).
- Назначьте имя ресурсу. По умолчанию в файле сборки используется имя, назначенное ресурсу, но вы можете изменить имя в окне Inspector.
Unity перекомпилирует скрипты в проекте для создания новой сборки. Затем вы можете изменить свойства нового определения ассамблеи.
Новая сборка включает все скрипты в той же папке, что и определение сборки, а также скрипты в любых подпапках, которые не имеют собственного файла определения сборки или справочного файла. Unity удаляет скрипты из их предыдущей сборки, если это применимо.
Создание справочного ресурса определения сборки
Чтобы создать справочную информацию об определении сборки:
В окне Project найдите папку, содержащую скрипты, которые необходимо включить в сборку, на которую сделана ссылка.
Создайте в папке ссылку на сборку (меню: Ассеты > Создать > Скриптирование > Assembly Definition Reference).
-
Назначьте имя ресурсу.
Unity перекомпилирует скрипты в проекте для создания новой сборки. Когда это будет сделано, вы сможете редактировать свойства новых определений сборки.
Выберите новый ресурс Справочник по определению сборки, чтобы просмотреть его свойства в Inspector.
Установите свойство Определение сборки для ссылки на целевой ассет Определение сборки.
Нажмите Применить.
Ссылка на сборку теперь включает все скрипты в той же папке, что и Справочник по определению сборки, плюс скрипты в любых подпапках, которые не имеют собственного файла определения сборки или справочного файла. Unity удаляет скрипты из их предыдущей сборки, если это применимо.
Создание сборки для платформы
Чтобы создать сборку для конкретной платформы:
- Создание определения сборки.
- Выберите новое Определение сборки, чтобы просмотреть его свойства в Inspector.
- В разделе Платформы установите флажок Любая платформа и выберите конкретные платформы для исключения или снимите флажок Любая платформа и выберите конкретные платформы для включения.
- Нажмите Применить.
Сборка включается или исключается в соответствии с этой конфигурацией при создании проекта для целевой платформы.
Создание сборки для кода редактора
Сборки редактора позволяют размещать скрипты редактора в любом месте проекта, а не только в папках верхнего уровня с именем Editor.
Чтобы создать сборку, содержащую код Редактора в вашем проекте:
- Создайте сборку для конкретной платформы в папке, содержащей скрипты редактора.
- Включите только платформу Редактор.
- Если у вас есть дополнительные папки, содержащие скрипты Редактора, создает в этих папках ресурсы Справочного Определения Сборки и настраивает их на ссылку на это Определение Сборки.
Создание тестового сборки
Тестовые сборки — это сборки, которые Unity ожидает содержать тесты. Помещение тестов в тестовые сборки имеет следующие преимущества:
- Они отделяют тестовый код от кода приложения, который вы отправляете пользователям, так что тестовый код можно компилировать только при необходимости.
- Любые тесты в тестовой сборке автоматически видны пакету Рамки тестирования, что делает их доступными для запуска из окна Test Runner.
Unity автоматически идентифицирует любую сборку как тестовую сборку, если она имеет ссылка сборки до nunit.framework.dll и определения сборки до UnityEngine.TestRunner и UnityEditor.TestRunner.
Инструкции по установке пакета Test Framework и созданию тестовых сборок см. в документации Unity Рамки тестирования. Вы можете использовать Редактор UI для создания файла определения сборки с предопределенными соответствующими ссылками, или вы можете настроить ссылки вручную через окно Inspector или путем редактирования файла JSON непосредственно.
Примечание: Тестовые сборки не компилируются как часть обычного конвейера сборки, поэтому любой код, помещенный в тестовую сборку, исключается из стандарта проект построить. Ваш тестовый код сборки включается в сборку Player только тогда, когда вы запустить тесты режима воспроизведения в проигрывателе через Испытательный бегун window. Если у вас есть производственный код, который неожиданно не компилируется в сборку проекта, проверьте, не находится ли он в тестовой сборке.
Дополнительные ресурсы