Quickstart for Paperscope demo app

This guide shows you how to build and run the Paperscope demo app for Android. Paperscope demonstrates the core features of the Cardboard SDK on Android.

Note: Make sure to review the Cardboard branding guidelines before distributing your app to a wider audience.

Set up your development environment

Software requirements:

• Android Studio
• Git must be installed and the git executable must be on the PATH environment variable.

Download and build the demo app

Follow these steps to download the codebase and open the sample project in Android Studio.

1. Clone the Google Cardboard repository:

   git clone https://github.com/googlevr/cardboard.git
   

2. Launch Android Studio and select Open an existing project.

3. Navigate to the directory where you cloned the Google Cardboard repository and select it.

4. Wait for Android Studio to sync the project with Gradle files.

Run the demo app

1. From the run configurations drop-down in the toolbar, select the paperscope configuration.

2. Connect a physical Android device or select a virtual device (emulator) as the target.

   Note: For the best VR rendering experience and head tracking capabilities, we recommend running the app on a physical device.

3. Click Run or press Shift+F10 to build and launch the app.

Next steps

• Review the Cardboard branding guidelines.