Unity Troubleshooting Tips

[JeffDUnity3D]

Here are some tips when you receive an error either in the Unity Editor or in Visual Studio or other code editor.

1. Copy the error message exactly. Often you can highlight the error text, then right click and copy the text to the clipboard

2. Generally the first step in troubleshooting is to use Google search. Our documentation and forums are indexed by Google. Here are a few tips:

• Remove the line number in the error text before doing a Search. Chances are that your line number in your own code is unique, so would not be expected to turn up in a Google search
• Precede the error text with the words "Unity error " followed by the exact error text, this will help to focus the search results.
• Often, the answer will be in the first few top results. Take a few minutes to review the top 3 links for example, and see if the links are relevant
• Don’t spend more than 10-15 minutes going down a Google search rabbit hole however.

3. One technique to use in your troubleshooting is runtime debugging. There is more information here:

Tips for new Unity users

And it would be good to learn basic debugging skills! At a minimum, place numerous Debug.Log statements before and after the location of the code in concern which will show in the device logs. Write out all your variable values at run time when running on your Android device, don't guess. So you don't know how to capture device logs for Unity games? Google it! (search tip "capture device logs for unity"). Even better https://docs.unity3d.com/Manual/ManagedCodeDebugging.html This might help too …

4. If you are using online services like Advertising, Charles Proxy can be very helpful in diagnosing issues. There is more information here:

Using Charles Proxy with Unity

5. If the error occurs on a device but not in the Editor, then the device logs are very helpful

How To - Capturing Device Logs on iOS

For troubleshooting and debugging, it is often very helpful to capture the device logs. The device logs contain information about the status of a running application on the device and any errors encountered. The IAP Engineering team requires logs for open issues. It is assumed here that you have an iOS device attached via USB to your Mac development system. Only Development Builds can be debugged this way, it's not possible to easily view the logs of a released iOS app. You can view the system l…

How To - Capturing Device Logs on Android

For troubleshooting and debugging, it is often very helpful to capture the device logs. The device logs contain information about the status of a running application on the device and any errors encountered. The IAP Engineering team requires logs for open issues. It is assumed here that you have an Android device configured with Developer options and attached to a PC with a USB cable. These steps show the process on a Windows system and works similarly on a Mac In Unity, find the location of …

6. At this point if you continue to have issues, it’s best to post on the relevant Unity forum. In your forum post, post your error and mention what you’ve tried already, and perhaps share the Google search link(s) that you tried. This will help others to assist you better, knowing what you’ve already tried. Also provide sufficient steps so someone else can easily reproduce your issue in an empty project (ideally). Post your code, using Code Tags, and mention the Unity version that you are using.