EditorBuildSettings
класс в UnityEditor
Наследуется от:Object
Описание
Этот класс позволяет изменять из скрипта Настройки сборки через скрипт.
EditorBuildSettings хранится в ProjectSettings/EditorBuildSettings.asset. Как правило, этот файл должен быть включен в управление источниками.
Scene ПереченьProjectSettings/EditorBuildSettings.asset файл содержит глобальный список сцен, который определяет сцены, которые будут включены в сборку проигрывателя. Этот список может быть переопределен активным BuildProfileДополнительную информацию см. Переопределение параметров с помощью профилей сборки.
Объекты конфигурации
EditorBuildSettings может быть использован для сохранения ссылок на объекты конфигурации.
В этом контексте конфигурационным объектом является ассет, обычно ScriptableObjectОбъекты, перечисленные в EditorBuildSettings, не включаются автоматически в сборку, что делает их идеальными для настройки только редактора. Эти ассеты могут быть доступны с помощью пользовательских скриптов сборки, обратных вызовов сборки или любого другого скрипта, запущенного в редакторе.
API для работы с конфигурационными объектами:
- EditorBuildSettings.AddConfigObject
- EditorBuildSettings.RemoveConfigObject
- EditorBuildSettings.TryGetConfigObject
- EditorBuildSettings.GetConfigObjectNames
Пример конфигурационного объекта
Представьте пакет с классом настроек качества, производным от ScriptableObject. Вы можете настраивать эти параметры и создавать несколько ассетов с разными значениями для разных ситуаций. Используйте EditorBuildSettings.AddConfigObject для отслеживания того, какой asset должен считаться "активным" параметром, обозначенным отличительным именем. Затем обратный вызов сборки читает параметры для активных параметров качества, вызов EditorBuildSettings.TryGetConfigObject с указанным названием.
Примечание: Аналогичная функция доступна для конфигурационных объектов, которые должны быть включены в сборку Проигрывателя, что делает их доступными для скриптов, запущенных в Проигрывателе. См. PlayerSettings.SetPreloadedAssets и PlayerSettings.GetPreloadedAssets.
Дополнительные ресурсы: EditorBuildSettingsScene, EditorUserBuildSettings, BuildPlayerOptions, SceneManager, IPreprocessBuildWithContext.
Статические свойства
| Свойство | Описание |
|---|---|
| globalScenes | Список сцен, используемый всеми профилями платформ и профилями сборки, которые не переопределяют глобальные сцены. |
| scenes | Список сцен в активном профиле платформы или профиле сборки, которые будут включены в сборку. |
Статические методы
| Метод | Описание |
|---|---|
| AddConfigObject | Хранить ссылку на конфигурационный объект по имени. |
| GetConfigObjectNames | Возвращает строковый массив, содержащий имена всех сохраненных ссылок на объекты конфигурации. |
| RemoveConfigObject | Удаление ссылки на конфигурационный объект по имени. |
| TryGetConfigObject | Получить ссылку на объект конфигурации по имени. |
Мероприятия
| Мероприятие | Описание |
|---|---|
| sceneListChanged | Делегат, вызываемый при установке EditorBuildSettings.scenes. |
Унаследованные члены 4
Свойства
| Свойство | Описание |
|---|---|
| hideFlags | Должен ли объект быть скрытым, сохраняться с Scene или изменяться пользователем? |
| name | Имя объекта. |
Открытые методы
| Метод | Описание |
|---|---|
| GetInstanceID | Получает экземпляр ID объекта. |
| ToString | Возвращает имя объекта. |
Статические методы
| Метод | Описание |
|---|---|
| Destroy | Удаляет GameObject, компонент или ресурс. |
| DestroyImmediate | Немедленно уничтожает указанный объект. Используйте с осторожностью и только в режиме редактирования. |
| DontDestroyOnLoad | Не уничтожать целевой Объект при загрузке нового Scene. |
| FindAnyObjectByType | Получает любой активный загруженный объект типа Type. |
| FindFirstObjectByType | Получает первый активный загруженный объект типа Type. |
| FindObjectsByType | Получает список всех загруженных объектов типа Type. |
| Instantiate | Клонирует исходный объект и возвращает клон. |
| InstantiateAsync | Захватывает моментальный снимок первоначального объекта (который должен быть связан с каким-либо GameObject) и возвращает AsyncInstantiateOperation. |
Операторы
| Оператор | Описание |
|---|---|
| bool | Существует ли объект? |
| оператор!= | Сравнивает, если два объекта ссылаются на разные объекты. |
| оператор == | Сравнение двух ссылок на объекты для определения того, относятся ли они к одному и тому же объекту. |