Mobile Development Troubleshooting Guide

This page is currently under construction, more errors and solutions will be added over time.

Contents

Mobile Development Troubleshooting Guide

Here is your one stop shop to find solutions to the most common mobile development and packaging . Take a look to see if the problems you are experiencing are listed and if so what steps you can take to fix the bug. If these fixes do not work, there will be a list of information needed when you make a post on the Answerhub detailing your specific error.

Additional Resources

Here are a few extra pages that may help determine if the error you are seeing is a bug in engine or a compatibility error with the specific device you are using.

This page is currently under development and will be populated as we find more common mobile development bugs/crashes. Thank you for your understanding.

Windows

Android

Build Failing


4.11 or earlier:

  1. Make sure you have AndroidWorks installed instead of CodeWorks.
  2. Be sure that you are using Visual Studio 2013.
  3. Did you follow the SDK Documentation? (Found here)
    • If not, Re-installation of SDK may be necessary.
  4. Did you download the correct Drivers for your device?
  5. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)


4.12 or higher:

  1. Make sure that you have CodeWorks installed instead of AndroidWorks.
  2. Be sure that Visual Studio 2015 is installed.
  3. Did you follow the SDK Documentation? (Found here)
    • If not, Re-installation of SDK may be necessary.
  4. Did you download the correct Drivers for your device?
  5. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Build Failure Solutions:

  1. Failure due to both old and new .jar files included in build library
  2. Warning: Major Version 51 is newer than 50.
  3. SDK/NDK version mismatch.
  4. Build failure due to NDK API Level of Android-23.
  5. Error GameActivity.java:277: error: cannot find symbol.
  6. Build failure due to Android Keystore not being found.
  7. 'wchar.h' file not found.

Not Deploying to the Device

  1. Is your Device Supported?
  2. Is the phone on Developer Mode?
  3. Do you have the correct Drivers installed? (Located in the Epic Games Device List graph)
  4. Search the Answerhub for similar issues.
  5. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

How to fix Advertisements and Googleplay Leaderboards

    Solution: AnswerHub
  1. Search the Answerhub for similar issues.
  2. Review Unreal Match 3 Advertisement Documentation
  3. Review Google Developer Documentation
  4. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Crashing Once Deployed on the Device

  1. Search the Answerhub for similar issues.
  2. Obtain Monitor.bat logs from device.
    • These logs will be vital when writing a Bug Report
  3. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Game Freezing Once Deployed

  1. Search the Answerhub for similar issues.
  2. Did you recently change the API level?
  3. If not, obtain Monitor.bat logs from device.
    • These logs will be vital when writing a Bug Report
  4. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Game crashing due to a Static Mesh

  1. Search the Answerhub for similar issues.
  2. Does deleting your Intermediate, Saved and Config folders from your project resolve the issue?
  3. Are you able to launch onto your device?
  4. Does it only crash in the engine? If so, save your Output Logs as a .txt file.
  5. Does the application crash once it's on your device?
  6. If so, obtain Monitor.bat logs from device.
    • Either of these logs will be vital when writing a Bug Report
  7. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Screen is Black, but Analogs are Showing

  1. Is your Device Supported?
  2. Have you built your lighting/lightmass?
  3. Make sure your Default/Startup Map is set correctly in ‘Project Settings’
  4. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Dynamic Shadows are not Rendering Properly

  1. Is the Directional Light in the project set to Movable?
  2. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Failed to find Shader Map for default material WorldGridMaterial!

  1. Did you change your r.MobileHDR option in DefaultDeviceProfile.ini?
  2. If so, does it differ from your settings in ProjectSettings? Make sure they both match one another.
  3. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Unable to load level on Android project

    Solution: AnswerHub
  1. Search the Answerhub for similar issues.
  2. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Using FPaths::ConvertRelativePathToFull on Android

    Solution: AnswerHub
  1. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Materials not Showing Correctly

  1. Materials for Mobile Platforms
  2. Search the Answerhub for similar issues.
  3. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Android Missing .so File

Android missing .so file to launch or package (ERROR: Can't make an APK without the compiled .so [C:\Program Files\Epic Games\4.6\Engine\Binaries\Android\UE4Game-x86-es2.so])

    Solution: Open Project Setting and in Platforms/Android/Build uncheck "Support x86"
  1. Search the Answerhub for similar issues.
  2. Post your issue on the Answerhub
    • We will need the following information:
    • Crash logs
    • DxDiag
    • Engine version
    • The exact type of mobile device (Example: Samsung Galaxy S3)
    • The exact version of the Operating System being used on the device
    • Can it be reproduced in a clean project?
    • If it can be reproduced, we will need a detailed list of steps to reproduce the issue on our end

AndroidWorks SDK Installation Error

    Solution: Contact NVIDIA® for support.

Unimplemented OpenGL ES API

Galaxy S3 mini: called unimplemented OpenGL ES API

    Solution: Galaxy S3 mini is not supported
  1. Search the Answerhub for similar issues.
  2. Post your issue on the Answerhub
    • We will need the following information:
    • Crash logs
    • DxDiag
    • Engine version
    • The exact type of mobile device (Example: Samsung Galaxy S3)
    • The exact version of the Operating System being used on the device
    • Can it be reproduced in a clean project?
    • If it can be reproduced, we will need a detailed list of steps to reproduce the issue on our end

AutomationTool Unable to Run

Packaging (Android (All)): BUILD FAILED AutomationTool was unable to run successfully.

    Solution: Video: Setting up Android Development Environment | UE4
  1. Search the Answerhub for similar issues.
  2. Post your issue on the Answerhub
    • We will need the following information:
    • Crash logs
    • DxDiag
    • Engine version
    • The exact type of mobile device (Example: Samsung Galaxy S3)
    • The exact version of the Operating System being used on the device
    • Can it be reproduced in a clean project?
    • If it can be reproduced, we will need a detailed list of steps to reproduce the issue on our end

Error Exporting to Android

Error Exporting to Android Platform (Software Development Kit (SDK) not found. Please install the SDK for the Android target platform)

    Solution: Make sure NVPACK is properly installed
  1. Search the Answerhub for similar issues.
  2. Post your issue on the Answerhub
    • We will need the following information:
    • Crash logs
    • DxDiag
    • Engine version
    • The exact type of mobile device (Example: Samsung Galaxy S3)
    • The exact version of the Operating System being used on the device
    • Can it be reproduced in a clean project?
    • If it can be reproduced, we will need a detailed list of steps to reproduce the issue on our end

Orientation Trouble

Incorrect Orientation for Download Background

    Solution: Replace the image with a 1280x720 image. Copy the downloader_progress.xml in Engine/Build/Java/res/layout to your project's Build/Android/res/layout (make the directories as needed). Edit downloader_progress.xml and change the orientation="vertical" to "horizontal".
  1. Similar Answerhub issue.
  2. Post your issue on the Answerhub
    • We will need the following information:
    • Crash logs
    • DxDiag
    • Engine version
    • The exact type of mobile device (Example: Samsung Galaxy S3)
    • The exact version of the Operating System being used on the device
    • Can it be reproduced in a clean project?
    • If it can be reproduced, we will need a detailed list of steps to reproduce the issue on our end

Launch Failure

Andriod Launch Failure (The system cannot find the path specified.)

    Solution: Try to reinstall the Android SDK. If you have not previously done so, you can find documentation here on how to set it up: Documentation: Getting Started on Android
  1. Search the Answerhub for similar issues.
  2. Post your issue on the Answerhub
    • We will need the following information:
    • Crash logs
    • DxDiag
    • Engine version
    • The exact type of mobile device (Example: Samsung Galaxy S3)
    • The exact version of the Operating System being used on the device
    • Can it be reproduced in a clean project?
    • If it can be reproduced, we will need a detailed list of steps to reproduce the issue on our end

Asus Transformer TF700T: Screen Garbled on Deploy

Asus Transformer TF700T is recognized by the engine, but when pushing to deploy the screen on the tablet looks garbled.

    Solution: Disabled Mobile HDR and Use Android DXT
  1. Search the Answerhub for similar issues.
  2. Post your issue on the Answerhub
    • We will need the following information:
    • Crash logs
    • DxDiag
    • Engine version
    • The exact type of mobile device (Example: Samsung Galaxy S3)
    • The exact version of the Operating System being used on the device
    • Can it be reproduced in a clean project?
    • If it can be reproduced, we will need a detailed list of steps to reproduce the issue on our end

APKBlacklist is not working? (4.13)

    Solution: AnswerHub: ApkBlacklist-Shipping.txt not working
  1. Search the Answerhub for similar issues.
  2. Post your issue on the Answerhub
    • We will need the following information:
    • Engine version
    • Log or screenshot from Blacklist

How to correctly package a prebuilt shared library (.so)?

    Solution: AnswerHub: Prebuilt Shared Library (.so)

iOS

**When building on a Windows machine, you are going to need to have iTunes available as well as a Mac available for Remote Building**

Build Failing

  1. Did you set up SSH Remote Building?
  2. Did you ‘Trust’ your PC on the iOS device?
  3. Did you ‘Trust’ the device on your PC via iTunes?
  4. Have you entered your Provisions and/or Certificate in the Project Settings>iOS section?
  5. Are the Provisions and/or Certificate sections highlighted red or green?
  6. Are you able to recreate this issue on a Blank Template Project?
  7. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Not Deploying to the Device

  1. Did you set up SSH Remote Building?
  2. Did you ‘Trust’ your PC on your iOS device?
  3. Did you Trust the device on your PC, via iTunes?
  4. Have you entered your Provisions and/or Certificate in the Project Settings>iOS section?
  5. Are the Provisions and/or Certificate sections highlighted red or green?
  6. Are you able to recreate this issue on a Blank Template Project?
  7. If it is still occurring:

Crashing Once Deployed to the Device

  1. Would you be able to replicate this issue on a blank template project?
    • If so, could you provide steps to reproduce the issue?
  2. Would you be able to provide the logs from the device? (See below for how to acquire the logs needed)
  3. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Screen is Black, but Analogs are Showing

  1. Have you built your lighting/lightmass?
  2. Make sure your Default/Startup Map is set correctly in ‘Project Settings’
  3. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Dynamic Shadows not Rendering Properly

  1. Change Directional light from ‘Stationary’ to ‘Movable’
  2. Character has ‘Cast Dynamic Shadow’ checked
  3. Have you built lighting?
  4. Lighting for Mobile Platforms
  5. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Materials or Textures rendering Black or Splotchy

  1. What is the normal intensity of your material?
  2. Are the texture samples formatted correctly for mobile?
  3. Uncheck the ‘Allow Static Lighting for Normal Maps’ within the ‘Project Settings’
  4. Texture Guidelines for Mobile Platforms
  5. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

How do you disable packaging a second chunk for IPA?

    Solution: AnswerHub: Disabling Second Chunk for IPA
  1. Search the Answerhub for similar issues.
  2. Post your issue on the Answerhub
    • We will need the following information:
    • Engine version
    • Can it be reproduced in a clean project?
    • Step by step reproduction

Mac

Android

**Android is now available for developing on Mac as of 4.12.**

iOS

Build Failing

  1. Have you entered your Provisions and/or Certificate in the Project Settings>iOS section?
  2. Are the Provisions and/or Certificate sections highlighted red or green?
  3. Are you able to recreate this issue on a Blank Template Project?
  4. Obtain the iOS logs from device.
  5. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Not Deploying to the Device

  1. Have you entered your Provisions and/or Certificate in the Project Settings>iOS section?
  2. Are the Provisions and/or Certificate sections highlighted red or green?
  3. Are you able to recreate this issue on a Blank Template Project?
  4. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Screen is Black, but Analogs are Showing

  1. Have you built your lighting/lightmass?
  2. Make sure your Default/Startup Map is set correctly in ‘Project Settings’.
  3. Obtain the iOS logs from device.
  4. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Dynamic Shadows not Rendering Properly

  1. Change Directional light from ‘Stationary’ to ‘Movable’
  2. Character has ‘Cast Dynamic Shadow’ checked
  3. Have you built lighting?
  4. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Materials or Textures rendering Black or Splotchy

  1. What is the normal intensity of your material?
  2. Are the texture samples formatted correctly for mobile?
  3. Uncheck the ‘Allow Static Lighting for Normal Maps’ within the ‘Project Settings’

Setting up iOS Device Compatibility for the Apple Store

    Solution: Answerhub
  1. Documentation: Device Compatibility
  2. Create a Bug Report on the Answerhub. (See ‘Creating a Bug Report’ below)

Setting up Flurry Analytics for iOS

    Solution: Answerhub
  1. Documentation: In-Game Analytics


Additional Information

Creating a Bug Report

  • Is the mobile device Android or iOS?
  • What is the exact device they are using and what version is that device on?
  • Would you be able to reproduce this issue on a Blank Template Project?
  • What version of the Engine are you using and is that version a binary or source build?
  • What engine version did you first see this error occurring?
  • Would you be able to reproduce this issue on a blank template project?
  • If there is a crash, would it be occurring when opening the application on the device of while packaging the project?
  • Be sure to include any build failed logs or any logs that may help to understand what may be occurring.
  • If the application is crashing on an Android device, include the Monitor Logs. (Need to add a link for how to obtain the monitor logs)

How to get logs off of an iOS device

Windows

  • Open iPhonePackager (Engine/Binaries/DotNET/IOS)
  • Select a uproject file (Optional)
  • Select the Advance Tools tab
  • Select Other Deployment Tools…
  • Select Backup Documents…
  • Select the IPA for the game you wish to get a log for
  • The documents directory data will then be copied to Engine/Binaries/DotNET/IOS/IOS_Backups or GameDir/IOS_Backups if a uproject was selected
  • The log can then be found at IOS_Backups/Game/Saved/Logs

Mac

  • Connect device to a Mac
  • Open XCode > Window > Devices
  • Select your device
  • Select 'View Device Logs'
  • Select the process which matches your Game and Crash date/time
  • Right-click on the process and select 'Export Log'

How to get logs off of an Android device

  • Attach your phone to the computer
  • Go here: C:\NVPACK\android-sdk-windows\tools
  • Open up Monitor.bat
  • Launch the program and save the logs

If you cannot get Monitor.bat to open, please go to:

  • C:\NVPACK\android-sdk-windows\tools\lib\monitor-x86
  • Open up Monitor.exe
  • Follow the instructions above

How to Remove Obsolete Mobile Provision Profiles (iOS)

Windows

  • C:\Users\<you>\AppData\Local\Apple Computer\MobileDevice\Provisioning Profiles
  • Profiles will show up and can be deleted as necessary.

Mac

  • ~/Library/MobileDevice/Provisioning Profiles
  • Profiles will show up and can be deleted as necessary.

Useful Mobile Documentation