Это руководство представляет собой введение в работу с Android Studio IDE. В нем описываются некоторые основные возможности, в том числе сборка и запуск примеров проектов.

Прежде чем использовать руководство, выполните инструкции из статей Настройка устройств и Настройка ПО для разработки для Android. Примеры для нативной разработки, используемые в руководстве, можно найти в \ovr_sdk_mobile\VrSamples в Mobile SDK.

Начало работы с примерами для нативной разработки: импорт проекта Gradle

Если вы впервые запускаете Android Studio, выберите Open an existing Android Studio project (Открыть существующий проект Android Studio). Если вы уже работали с Android Studio, перейдите в меню File > Open (Файл > Открыть).

Откройте любой файл проекта build.gradle из папки с примерами VrSamples Mobile SDK. Например, VrSamples/VrCubeworld_Framework/Projects/Android/build.gradle.

В диалоговом окне с вопросом, нужно ли использовать оболочку Gradle, нажмите OK.

Устранение проблем при ошибках синхронизации Gradle

Вот несколько возможных решений, если Android Studio сообщает об ошибке синхронизации или конфигурации Gradle:

Наиболее распространенной причиной такой ошибки является неправильное указание расположение Android SDK или NDK. Убедитесь, что расположения SDK и NDK указаны правильно в меню File > Project Structure ("Файл" > "Структура проекта"). Если они указаны неверно или отсутствуют, вы не сможете продолжить работу, пока не укажете правильный путь.

На macOS иногда Android Studio выдает ошибку отсутствия расположения SDK, даже если в диалоговом окне Project Structure (Структура проекта) указаны правильные пути. Чтобы исправить эту проблему, скопируйте файл local.properties из папки проекта в корень папки Oculus Mobile SDK.

Обзор проекта

По умолчанию Android Studio отображает файлы проекта в представлении Android. Мы рекомендуем изменить его на представление Project, чтобы получить наглядный обзор всей структуры каталогов, где импортированные каталоги проекта выделены жирным шрифтом.

Выбор целевой конфигурации, сборка и запуск

Выполните шаги по настройке устройства и ПО для разработки для Android, чтобы ваше устройство и среда разработки были настроены должным образом.

Перед сборкой выберите нужную целевую конфигурацию, нажав Edit Configurations (Изменить конфигурации) в меню проекта на панели инструментов Android Studio.

Сборка и запуск приложения:

Нажмите Run (Запустить) на панели.

Откроется диалог Select Deployment Target (Выбор цели развертывания). Иногда по умолчанию здесь указан эмулятор.

Вместо него выберите устройство из списка Connected Device (Подключенные устройства).

Если устройство запрашивает Allow USB debugging (Разрешить отладку по USB), нажмите OK.

Устранение неполадок. Если отладка по USB не работает:

Перейдите в раздел Для разработчиков на своем телефоне.

Деактивируйте переключатель Отладка по USB и затем активируйте снова.

Устранение неполадок. Если при отладке переход к определенным функциям приводит к недопустимому исключению инструкции (SIGILL) или сбою:

В Android Studio перейдите в раздел Run > Debug > Edit Configurations ("Запуск" > "Отладка" > "Изменить конфигурации").

Выберите панель Debugger (Отладчик).

Выберите панель LLDB Post Attach Commands (Команды LLDB после присоединения).

Нажмите +, чтобы добавить новую команду.

Добавьте команду process handle --pass true --stop false --notify true SIGILL.

Синхронизация проектов

Если вы обновляете файл *.gradle или устанавливаете Oculus Mobile SDK, содержащий обновленные проекты Gradle, нажмите Sync Project with Gradle Files (Синхронизировать проект с файлами Gradle), чтобы обновить файлы проекта Android Studio.