Version: 2020.3
Mobile Developer Checklist
Profiling
How do you use documentation throughout your workflow? Share your experience with us by taking this survey.

Crashes

Checklist for crashes

  • Disable code stripping (and set “slow with exceptions” for iOS)
  • Follow the instructions in Optimizing the size of the built iOS Player to make sure your game does not crash with stripping on iOSApple’s mobile operating system. More info
    See in Glossary
    .
  • Verify it is not because of out of memory (restart your device, use the device with maximum RAM for the platform, be sure to watch the logs).

Editor.log - on the editor

The Debug messages, warnings and errors all go to the console. Unity also prints status reports to the console - loading assets, initializing mono, graphics driver info.

If you are trying to understand what is going on, look at the editor.log file, which provides more detailed information than the console. You can try to understand what’s happening, and watch the full log of your coding session. This will help you track down what has caused Unity crash to crash or find out what’s wrong with your assets.

Unity prints some things on the devices as well; Logcat console for Android and Xcode gdb console on iOS devices

Debugging on Android

  1. Use the DDMS or ADBAn Android Debug Bridge (ADB). You can use an ADB to deploy an Android package (APK) manually after building. More info
    See in Glossary
    tool
  2. Watch the stacktrace. Use c++filt (part of the ndk) or other methods to decode the mangled function calls
  3. Look at the .so file that the crash occurs on:
    1. libunity.so - the crash is in the Unity code or the user code
    2. libdvm.so - the crash is in the Java world, somewhere with Dalvik. So find Dalvik’s stacktrace, look at your JNI code or anything Java-related (including your possible changes to the AndroidManifest.xml).
    3. libmono.so - either a Mono bug or you’re doing something Mono strongly dislikes

If the crashlog does not help you can disassemble it to get a rough understanding of what has happened: 1. Use ARM EABI tools from the Android NDK like this: objdump.exe -S libmono.so >> out.txt. 1. Look at the code around pc from the stacktrace.. 1. Try to match that code within the fresh out.txt file. 1. Scroll up to understand what is happening in the method it occurs in.

Debugging on iOS

  1. Xcode has built in tools to enable you to debug your app.
  2. Full gdb stack - thread backtrace all
  3. Enable soft-null-check: Enable development buildA development build includes debug symbols and enables the Profiler. More info
    See in Glossary
    and script debugging. Now uncaught null ref exceptions will be printed to the Xcode console with the appropriate managed call stack
  4. Try turning the “fast script call” and code stripping off. It may stop some random crashes, like those caused by using some rare .NET methods or reflection.

Strategy

  1. Try to figure out which script the crash happens in and debug it using mono develop on the device.
  2. If the crash seems to not be in your code, take a closer look at the stacktrace, there should be a hint of something happening. If you believe the crash happens because of a problem with Unity, see the Known issues tracker or submit a bug.
Mobile Developer Checklist
Profiling