Demystifying Unity iOS Crash Logs
Someone who never ported Unity game to mobile (iOS / Android) can tell that it’s pretty easy. If you think so, you are very wrong. When running i.e. WebPlayer version of your game it allows you throwing exceptions that are not caught and sometimes the game runs without any crash, only in the log file you can read note about it. Mobile version is less forgiving. Unhandled exception will crash your app.
Reading iOS crash logs helps a lot while debugging, but if they are still mystery for you, you can read great article about them here: Demystifying iOS Application Crash Logs. The problem is, that sometimes Unity creates crash on your iOS device that will not tell you much:
... 6 mygame 0x002328f4 ___lldb_unnamed_function7016$$mygame + 268 7 mygame 0x0122597c ___lldb_unnamed_function93440$$mygame + 200 8 mygame 0x01964224 ___lldb_unnamed_function136404$$mygame + 2152 9 mygame 0x01a06274 ___lldb_unnamed_function138276$$mygame + 132 10 mygame 0x015a08cc MonoBehaviour::InvokeMethodOrCoroutineChecked(ScriptingMethod*, MonoObject*, MonoException**) (MonoUtility.h:452) 11 mygame 0x015a0918 MonoBehaviour::InvokeMethodOrCoroutineChecked(ScriptingMethod*, MonoObject*) (MonoBehaviour.cpp:975) ...
It will tell you nothing because of ___lldb_unnamed_function (sometimes there is only memory address if automatic symbolication went totally crazy). Instead of this unnamed function you would like to see name of your method in your C# scripts. The problem is wrong calculation of method address by default Xcode symbolication tool (more details about these calculations you can find here). To ease you life I created a script that will symbolicate crash log for you. All you need is the archive from which you created your binary, name of the application and crash log itself.
Usage is as follows:
symbolicate_crash.sh <archive> <app_name> <crash_log> [<output_file>]
<output_file> is optional, if you will not specify it, script will symbolicate crash log in file with the name same as the crash log, but with additional postfix. Instead of <crash_log> you can put directory that contains crashes and all of them will be symbolicated one after another.
Here is the usage example:
symbolicate_crash.sh "Unity-iPhone 3-20-14 4.17 PM.xcarchive/" mygame "mygame 3-20-14 5-11 PM.crash"
Now the crash log will look more user friendly:
... 6 mygame 0x002328f4 m_Facebook_IOSFacebook_OnRequestComplete_string (in mygame) + 268 7 mygame 0x0122597c m_wrapper_runtime_invoke_object_runtime_invoke_dynamic_intptr_intptr_intptr_intptr (in mygame) + 200 8 mygame 0x01964224 mono_jit_runtime_invoke (in mygame) + 2152 9 mygame 0x01a06274 mono_runtime_invoke (in mygame) + 132 10 mygame 0x015a08cc MonoBehaviour::InvokeMethodOrCoroutineChecked(ScriptingMethod*, MonoObject*, MonoException**) (in mygame) (MonoUtility.h:452) 11 mygame 0x015a0918 MonoBehaviour::InvokeMethodOrCoroutineChecked(ScriptingMethod*, MonoObject*) (in mygame) (MonoBehaviour.cpp:975) ...
I have a dream that one day I rewrite this script in some more readable form switching to python maybe, but for now it should solve at least some of your Unity iOS crash log problems.
Happy bugs hunting!