Giter VIP home page Giter VIP logo

arcore-for-all's Introduction

ARCore for All

Google ARCore (dev preview 1) for "unsupported" Android devices

Summary

Google's ARCore developer preview for Android is awesome. Unfortunately, my Android phone (Samsung GS8+) was not on the supported list, and apps built with ARCore exit at start on my device. However, its hardware actually can run ARCore!

I modified the Android library to strip the ARCore device check, and ARCore started working on the device.

Developer Preview 2

ARCore has been updated to Preview 2 by Google. More devices are now supported. Another project on GitHub, ARCore Patch, aims to extend unofficial device support for the new version.

Developer Preview 1

Please see below for research on the first preview build.

See Experimental Branch

This branch is unlikely to work on most devices.
Please check out the service mod branch of this repo to help us develop the latest experiment to bring ARCore to more devices. Thanks!

Android Installation

In your Android project, simply replace the Google-provided arcore_client.aar with the one in this repo, and voilà! ARCore on any Android device.

Make sure to first install ARCore Service - "Preparing your Device" section of Google's instructions  

Unity Installation

In your Unity project, simply replace the Google-provided unitygar.aar (located in GoogleARCore/SDK/Plugins/) with the one in this repo, and voilà! ARCore on any Android device, within Unity.

Make sure to first install ARCore Service - "Preparing your Device" section of Google's instructions  

Requirements

  1. Capable Android Hardware - Since Google does not yet officially support more than a few devices, it's unknown which devices will actually work. My estimate is that devices from the past year should work, but it's currently unclear. Feel free to try and see if it works on your device, then let us know! There is a research document so we can identify necessary modifications.
  2. 64-bit Architecture - The library does not contain a build for 32-bit processors, as pointed out by @szugyi.

Disclaimer

Please keep in mind that (at the time of this writing) only 3 Android devices are officially supported by ARCore, so this hack might not work. I also take no responsibility for damage to your software. It's worth a try, though! ;)

Android Build Instructions

To modify the original ARCore AAR library, follow the below instructions. You will need a java class decompiler, such as CFR.

  1. Open a command line interface
  2. Unzip the AAR to a temporary directory: unzip arcore_client-original.aar -d aar-tmp
  3. Enter the temporary aar directory: cd aar-tmp
  4. Unzip classes.jar to a temporary directory: unzip classes.jar -d classes-tmp
  5. Enter the temporary classes directory: cd classes-tmp
  6. Enter the directory containing the SupportedDevices class: cd com/google/atap/tangoservice
  7. Decompile the SupportedDevices class: java -jar /path/to/cfr.jar SupportedDevices.class > SupportedDevices.java
  8. Open a text editor and delete return false from the end of isSupported()
  9. Compile the modified SupportedDevice class: javac -cp /path/to/sdk/platform/android.jar -source 1.7 -target 1.7 SupportedDevices.java
  10. Delete the Java source: rm SupportedDevices.java
  11. Change directory back to aar-tmp: cd ../../../../../
  12. Create a JAR from the modified classes directory: jar cvf classes.jar -C classes-tmp .
  13. Change directory back to repo root: cd ..
  14. Create an AAR from the modified aar directory: jar cvf arcore_client.aar -C aar-tmp .

After the above steps, you will have a modified arcore_client.aar with device verification stripped. Now you can replace the AAR in your project and build to any hardware-capable Android device!

Android (pre-Nougat) Build Instructions

The official library has a minimum SDK version of Android 7.0 (Nougat). See @kenfast's research for installing on pre-7.0.

Unity Build Instructions

these instructions contributed by GitHub user Ila Maheshwari. Thank you!

  1. Connect your Android device to your computer using a USB cable. You may see a prompt asking you to confirm that you wish to enable USB debugging on the device. If so, click OK.
  2. In Unity, open the Build Settings from the top menu (File > Build Settings).
  3. Click "Add Open Scenes" to add the Main scene to the list of scenes that will be built. Click Build And Run.
  4. You will be prompted to choose where to build your apk. A good place to do this is in a dedicated builds directory in the root of your project.
  5. Create a directory called "Builds" in the root of your project (not within your Assets directory, but at the same level as it). Select that directory as the location to which to build.
  6. In the text input field marked Save As, enter "Android" and click Save.
  7. Unity will now create an apk file called "Android" in the "Builds" folder. Run adb install [filename].apk to install it to your device.

Credit

Original library by Google
Modification by Thomas Suarez ("tomthecarrot") and Contributors to this project on GitHub.

arcore-for-all's People

Contributors

anstarc avatar bachhuberdesign avatar coderobe avatar ilamaheshwari avatar marcant01 avatar nestoralonso avatar paramsen avatar tomthecarrot avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.