Remote Deploy: запуск на устройстве

Remote Deploy экспортирует отладочную сборку и запускает её на выбранном устройстве или через тестовый Web-сервер. Это не публикация релиза. Возможность запуска зависит от экспортного пресета, шаблонов сборки, инструментов платформы и доступной цели.

Общая подготовка

1. Сохраните проект и назначьте главный уровень или стартовый префаб для запуска.
2. Откройте Project → Export и создайте пресет нужной платформы. Установите подходящие шаблоны экспорта версии 1.0.0 и устраните ошибки конфигурации пресета.
3. Включите Runnable у этого пресета. Это флаг пресета, а не шаблона сборки. Для одной платформы выбирается один Runnable-пресет: выбор другого заменяет предыдущий.
4. Подготовьте устройство или сервер по разделам ниже. Откройте меню Remote Deploy на панели запуска и выберите цель. Текущий интерфейс группирует цели по платформам в одном меню, а не обязательно показывает отдельную кнопку каждой платформы.
5. Проверьте окно Project Run, Output и Debugger. Если появился запрос несовпадения архитектуры CPU, сначала включите нужную архитектуру в пресете.

Меню скрыто, когда нет целей платформ с Runnable-пресетом. Наличие пресета не гарантирует исправность SDK, подписи или установку приложения: ошибки могут возникнуть уже после выбора цели.

Для C# текущий экспортный плагин реализует Windows, Linux, macOS, Android и iOS. Web-экспорт .NET не реализован; пункт Web сам по себе не делает C#-проект экспортируемым.

Android

Настройте export/android/android_sdk_path и export/android/java_sdk_path в Editor Settings, затем Android-пресет по руководству экспорта.

Включите USB debugging, подключите устройство и подтвердите разрешение отладки на нём. Из SDK Platform Tools выполните adb devices: нужное устройство должно иметь статус device. Для Wi-Fi включите Wireless debugging, выполните adb pair IP:PORT с адресом и портом из диалога сопряжения, затем снова проверьте список. Требования и диагностика соединения: официальная инструкция ADB.

Выберите именно устройство в Remote Deploy. В текущей реализации Android экспортируется временный debug APK, затем устанавливается и запускается. Опция export/android/one_click_deploy_clear_previous_install может удалить прежнюю установку; не включайте её, если нужны сохранённые данные тестовой версии.

iOS

Удалённый запуск на Apple-устройство реализован на хосте macOS. Подготовьте Xcode, подпись, bundle identifier и сопряжение устройства по руководству iOS. Нужны подходящие provisioning-настройки; простого наличия устройства в списке недостаточно. Текущая реализация содержит пути запуска через devicectl и ios-deploy. Не устанавливайте произвольную утилиту вместо настройки требуемого текущей конфигурацией инструмента. Этот сценарий не выполнялся в Windows-проверке.

Удалённый настольный компьютер

В пресете целевой ОС включите ssh_remote_deploy/enabled, задайте ssh_remote_deploy/host и ssh_remote_deploy/port. На цели должны работать SSH и необходимые для запуска проекта библиотеки. Проверьте run/cleanup scripts пресета, особенно после их изменения. Remote Deploy экспортирует проект, передаёт файлы через SSH/SCP и запускает команду на целевом компьютере; это не обычный локальный запуск редактора.

Отладка и сетевой файловый доступ

Debug → Deploy with Remote Debug добавляет подключение запущенного проекта к отладчику редактора. Выключение этой опции не запрещает сам deploy и не превращает его в release-сборку.

• network/debug/remote_host — адрес, используемый для удалённой отладки; при прямом сетевом соединении устройство должно достигать компьютера редактора по этому адресу. Loopback другого устройства не указывает на ваш компьютер.
• network/debug/remote_port — порт отладчика, в исходниках по умолчанию 6007. Это не Web HTTP-порт.
• В Android при выключенном export/android/use_wifi_for_remote_debug используется ADB reverse и localhost. Это отдельная настройка маршрута отладки, а не переключатель способа обнаружения устройства.
• Small Deploy with Network Filesystem не упаковывает обычный полный набор данных: проект получает файлы от редактора. Для самостоятельной проверки приложения отключите эту опцию. Файловый сервер использует filesystem/file_server/port, а не порт отладчика.

Web: локальный сервер и проверка с другого устройства

В Remote Deploy доступны Run in Browser и Start HTTP Server. Во время работы сервера появляются Re-export Project и Stop HTTP Server. Простой reload браузера не заменяет повторный экспорт изменённого проекта.

Для проверки в LAN можно привязать сервер к 0.0.0.0, но на другом устройстве открывайте IP компьютера редактора, а не 0.0.0.0 или localhost. Разрешите нужное соединение в локальном firewall. Для SharedArrayBuffer и общей памяти WebAssembly необходимы secure context и cross-origin isolation; одного TLS недостаточно. Это требование соответствующей функциональности, а не безусловное правило для любой Web-сборки. См. условия SharedArrayBuffer.

Встроенный сервер добавляет COOP/COEP-заголовки. При тестовом сертификате отдельно проверьте доверие браузера к нему; настройка Use TLS сама не создаёт публично доверенный сертификат. Для ограничений сборки, потоков и service worker см. Web-экспорт.

Быстрая диагностика

В установленном редакторе проверены типы настроек и формирование debug-аргументов. Поведение меню и платформ сверено с исходниками. Реальные экспорт, установка, ADB/SSH, Apple-устройство, Web-сервер и удалённая отладочная сессия этим прогоном не проверены.