Sometimes when starting a new project or updating the Lightship ARDK package, you might only encounter issues when your app is deployed to a device. Issues such as no camera feed (a black screen) or crashing immediately when the app is opened can be mind-boggling especially if you aren’t experiencing any issues when running your app in Unity, but don’t fret!
It’s extremely important to install all the required components and configure your AR app properly for each platform you intend to target.
- Ensure you have the required plugins for your targeted platform(s) and your project setup satisfies the requirements outlined by Unity.
- Ensure your player settings match our recommendations for each mobile platform.
- Ensure your player settings match our recommendations.
It’s easy to overlook the tiny “Scenes in Build” section in Build Settings and forget to select the tiny checkbox next to the scene(s) you want included in your build. Make sure you double check your build settings to ensure you’ve selected the scene you’re expecting to see when you run your app and the platform of the device you’re targeting for your test!
Yeti Tip!: Enable “Development Build” in Build Settings and keep your device connected while troubleshooting to see runtime errors as they occur!
Depending on the device and your security settings, your app might be lacking location, microphone, or camera permissions. Take a moment to go to the settings on your target device and make sure your app is allowed to use your location, camera, and microphone (if applicable).
Run your app from your IDE while your device is still connected and check for errors in the output section. Errors are highlighted in red and will more often than not point to the issue in question. We understand a lot of errors aren’t user friendly, so feel free to copy all of the red text and paste it into your favorite search engine to find articles with possible solutions. Please note that warnings – denoted in yellow text – should not impact your ability to build and deploy your app, and should be excluded from logs you submit for assistance.
Please reach out to us at firstname.lastname@example.org and provide us with any error messages you’re facing, the version of Unity and the ARDK, the platform and device, device operating system version, and a short description of the issue you’re encountering.