Android Studio Basics
在此專頁上
Important
All Oculus Quest developers MUST PASS the concept review prior to gaining publishing access to the Quest Store and additional resources. Submit a concept document for review as early in your Quest application development cycle as possible. For additional information and context, please see Submitting Your App to the Oculus Quest Store.
We're no longer accepting submission of 32-bit Oculus Quest apps. Any new or updated Oculus Quest application needs to be 64-bit. Please contact Oculus if you are unable to comply with this policy. Oculus Go and Gear VR apps will not be affected by this change.
This guide introduces the Android Studio IDE and reviews some basic features.
Before using this guide, follow the instructions in Device Setup - Oculus Quest and Android Development Software Setup. The native samples referenced in this topic can be found at \ovr_sdk_mobile\VrSamples in the Mobile SDK.
Getting Started with Oculus Native Samples: Import Gradle Project
- If this is the first time you are launching Android Studio, select Open an existing Android Studio project. If you have launched Android Studio before, click File > Open instead.
- Open any
build.gradleproject file from the SDKVrSamplesfolders, such asVrSamples/VrCubeworld_NativeActivity/Projects/Android/build.gradle.
- When asked if you would like the project to use the Gradle wrapper, click OK.
Troubleshooting Gradle Sync Errors
Here are some possible solutions if Android Studio reports a Gradle sync or configuration error:
- The most common cause of such an error is that the Android SDK or NDK locations are wrong. Verify that the SDK and NDK locations are specified correctly in File > Project Structure. If either are wrong or missing, you cannot continue until you fill in the correct path.
- On macOS, sometimes Android Studio reports a missing SDK location error even when the correct paths are listed in the Project Structure dialog box. To correct this problem, copy the
local.propertiesfile from your project folder up to the root of your SDK folder.
Project Overview
Android Studio displays project files in the Android view by default. We recommend changing it to the Project view, which provides a good overview of the entire directory structure and highlights imported project directories in bold.
Select Target Configuration, Build, and Run
You can build and run your application on your device directly from Android Studio. This will compile your project, build the APK, copy it to the phone over USB or Wi-Fi, and prepare it for launching.
Make sure you have followed the configuration steps in Device Setup - Oculus Quest and Android Development Software Setup to ensure your device and development environment are configured appropriately.
Select the target configuration you wish to build before building by selecting Edit Configurations in the project menu in the Android Studio toolbar.
To build and run your app:
Click Run in the toolbar.
- The Select Deployment Target dialog box appears. This is sometimes set to an emulator by default.
Select a device listed under Connected Device instead.
- If your device asks you to Allow USB debugging, click OK.
Troubleshooting: If USB debugging does not seem to be working:
- Go to Developer Options on your phone.
- Toggle USB Debugging off and then back on.
Troubleshooting: If stepping into certain functions results in an illegal instruction exception (SIGILL) / crash while debugging:
- In Android Studio, go to Run > Debug > Edit Configurations.
- Select the Debugger pane.
- Select the LLDB Post Attach Commands pane.
- Click + to add a new command.
- Add the following command:
process handle --pass true --stop false --notify true SIGILL
Syncing Projects
If you edit a gradle file or install an update to the SDK which includes updated Gradle projects, click Sync Project with Gradle Files to update your Android Studio project files.
