Sceneform SDK for Android v1.0.0

Known issues

Runtime

• The ArSceneView must be setup with an Sceneform Session that is configured to use the LATEST_CAMERA_IMAGE update mode. See ArSceneView.setupSession().
• Sceneform requires GLES 3.1+ to run. Currently, this means that Sceneform applications will not run in the Android Emulator on macOS.
• Sceneform only supports ARGB8 image formats.
• ViewRenderables don’t currently cast shadows.
• View doesn’t start rendering until resources requested in onCreate() have finished loading. This may be an issue when loading assets over the network. As a workaround, delay lengthy resource loads until onResume() or update(). See Scene.setOnUpdateListener().

Google Sceneform Tools Android Studio plugin

• Within *.sfa Sceneform asset files, the center and size attributes in suggested_collision are currently unused. Instead, the collision shape is currently always a bounding box matching the geometry inflated by the skin_width (defaults to zero).
• On macOS, stretching the viewer so that it is wider than your monitor can cause performance issues.
• Opening an *.sfb Sceneform bundle file that was built outside of the current project build will result in the *.sfb binary file being loaded in the text editor, rather than the corresponding *.sfa text file. We recommend re-importing source models into the project rather than copying over *.sfb's.
• If you import and your gradle project build does not reference the google() maven repository, your build will fail, and not be reverted. You may fix this build failure by adding the google() repository to your root build.gradle dependencies.
• Lighting environment reflections appear different when previewed in the Android Studio plugin compared to how they appear at runtime.

3D model formats

• Sceneform currently does not support glTF extensions.
• When glTF file dependencies are missing, the plugin prints a generic error saying "No suitable reader found for the file format". This indicates that not all dependent files are present.
• Transform hierarchies in glTF models are ignored on import. Consequently, importing a glTF model with a transform hierarchy will result in all submeshes being drawn with an identity transform (i.e. at the model origin with no rotation)

Gradle plugin

• When a change in the source asset requires a new *.sfa file, e.g. if the model has updated material parameters, the plugin will print a warning saying "run with --in_place". We recommend that in this case, you delete the *.sfa file and rebuild, causing the *.sfa to be regenerated by the gradle plugin.