Symptoms
- You need to profile the memory allocated on an iOS device.
- Your app crashes after running out of memory.
- You are getting memory warnings.
Resolution
You must attempt to identify any memory leaks.
The code below analyzes the memory of the Player for iOS or OSX with Xcode and the Instruments allocation tool.
For the purpose of this example, some AssetBundles are being loaded but the WWW object is not unloaded.
for (int i = 0; i < 100; i++)
{
WWW www = new WWW (bundleURL);
yield return www;
AssetBundle bundle = www.assetBundle;
bundle.LoadAllAssets ();
bundle.Unload (true);
}
To try and identify the issue:
1. Build and run the Project.
2. Open the Debug Navigator in the Navigators area and then click on Memory to display the memory graphs.
The graph in blue above shows that there are two memory peaks, but it doesn't show which functions are using this memory. Instruments can be used to see the methods that allocated the memory.
2. In Xcode, select Product/Profile (Cmd+I).
3. Select the allocation tool (Allocations), which will provide you with detailed information on all created objects and the memory they are using.
4. Click the record button to start the the application on the device and record the session.
5. On the Detail Panel, select Call Trees.
6. Pause the game and in the Track panel select part of the graph and check the hierarchy of the call tree. This will show you how much memory was allocated for the selected piece of the graph, and if you go down in the hierarchy you will find the memory allocation.
Finding a possible memory leak
A memory leak happens when you allocate memory but it is not returned to the operating system or reused.
Common reasons for memory leaks include:
- WWW objects that have not been unloaded
- Static references
- Problems with between Scenes
- Objects not being unloaded correctly
- Render Textures not being unloaded correctly
- AssetBundles not being unloaded correctly
1. Tick the Discard events for freed memory checkbox so you can analyze only the memory that is not de-allocated.
2. Run the game for an extended period of time and check if there is a peak on the graph that doesn't get deleted after some time or recurs after several runs of the game.
Below is an example of a memory leak caused by the WWW object not being unloaded:
In this example, some of the memory peaks that represent the allocations are released but some persist.
3. Pause and select the peak on the graph to open the calls tree, and check to see if the memory is allocated from the same function each time.
Mark generation
The second test to find a memory leak is to use the mark generation tool.
1. In the Inspector panel, click the Display Settings button and then the button labelled Mark Generation.
2. Create some mark generations using this button. When a mark is generated, you will see a red flag appear in the track.
3. Check that the memory does not continue to grow while repeatedly performing the same set of operations, and note that each generation includes a list of allocations that has occurred since the previous generation.
4. Take samples when you load a new Scene or destroy objects to check if you have objects that remain in memory.
You need you do several runs and let the game run for some time as the memory allocated can be released or reused later.
You also need to build in development mode and enable the generation of dSYM in Xcode to read the call stack properly.
Another useful tool for inspecting memory usage is the Unity Memory Profiler. After you game have been running for some time, you can load an empty Scene and use the Memory Profiler take a memory snapshot and check what objects are still in memory.
More Information
For more information, consult the following:
Apple Instruments Documentation
Apple documentation on tracking memory usage
Unity blog on profiling with Instruments
Unity Memory Profiler on Bitbucket
Comments
3 comments
Unity Memory Profiler tool did the trick in finding the texture problems.
The Unity Memory Profiler on Bitbucket is no longer supported. The Memory Profiler Package replaces it for versions from 2018.3 onwards. There is also documentation there on how to hunt for memory leaks.
I'm using Xcode 14.2 and the UI for the allocation tool is a bit different. Any change this guide could be updated?
Please sign in to leave a comment.