summaryrefslogtreecommitdiff
path: root/chromium/third_party/gvr-android-sdk/README.chromium
blob: 2c16b1308f8ac648b4fa49a423e95e1c6dcb181c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
Name: Google VR SDK
Short Name: gvr
URL: https://github.com/googlevr/gvr-android-sdk
Version: 1.101.0
Date: 13 November 2017
Revision: 6aef4ab34276aac81ee38f1cb1d034de7fc4a4eb
License: Apache 2.0
License File: LICENSE
Security Critical: yes

Description:
The Google VR SDK for Android supports both Daydream and Cardboard, including a
simple API used for creating apps inserted into Cardboard viewers, and the more
complex API for supporting Daydream-ready phones and the Daydream controller.

Local Modifications:
Due to binary size concern, we have decided to use a static shim library instead
of the shared library that comes with this checkout. The static libraries are
downloaded from a public storage through gclient sync.
For Version 1.10.0, we have two date: 6 Dec 2016 and 10 Feb 2017. The latter
version cherrypick a CL that fix a crash on K and L.
All JNI calls in the static library also needs to be manually registered. So
we have 3 jni related files. These files were generated by
base/android/jni_generator/jni_generator.py from Java files. Modifications to
these generated files are documented in the files.
In order to run automated end-to-end tests on VR features, VR Services
(com.google.vr.vrcore) and in some cases Daydream Home
(com.google.android.vr.home) need to be installed before running tests. These
are downloaded into test-apks/vr_services and test-apks/daydream_home,
respectively. The downloaded APKs are the release APKs that are or were
publicly available via the Play Store.
In order to run automated end-to-end tests that involve a Daydream controller,
controller_test_api.aar needs to be present. This allows us to send controller
events using broadcasts like a real controller sends them over Bluetooth. The
library is open-sourced similar to the other .aars, but since it's only useful
for Chromium at the moment, it is uploaded to storage instead of to GitHub like
the GVR SDK.