Documenting the dark corners of the Unity Engine.

User Tools

Site Tools



The EditionConnection class controls the editor-side of the Player/Editor network bridge used for letting the player talk to the editor1).

Connects fail when using Patch + Run on Android

The port used to connect the player to the editor is stored within the Android data files. These are placed in the .obb file, when Android is in “Split Package” mode.

When using Patch and Run, only the code changes are installed to the device. However, this can mean the player uses an old port for trying to connect to the editor. The connection won't succeed.

You must either deploy the full obb file to the device, or connect to the player manually using an IP Address.

Android Connections

Normally calling EditorConnection.instance.Initialize() is enough to connect to the player, but on Android, there seems to be an additional step needed2).

When the player is listening for a connection, you must use an internal method to connect through the localhost proxy connection. For example:

        private void ConnectEditorToAndroidPlayer()
            var connectionResult = -1;
            var maxTryCount = 10;
            var tryCount = maxTryCount;
            while (tryCount-- > 0 && connectionResult == -1)
                Debug.Log("Searching for player connection...");
                var method = Type.GetType("UnityEditor.EditorConnectionInternal,UnityEditor")
                                 .GetMethod("ConnectPlayerProxy", BindingFlags.Static | BindingFlags.Public);
                connectionResult = (int) method.Invoke(null, new object[]
                    IPAddress.Loopback.ToString(), 34999
                // connectionResult = EditorConnectionInternal.ConnectPlayerProxy(IPAddress.Loopback.ToString(), 34999);
                // connectionResult = EditorConnectionInternal.ConnectPlayerProxy(IPAddress.Loopback.ToString(), 34999);
                if (EditorUtility.DisplayCancelableProgressBar("Editor Connection", "Connecting to the player",
                    1 - ((float) tryCount / maxTryCount)))
                    throw new Exception("Cancelled.");
            if (connectionResult == -1)
                throw new Exception(
                    "Timed out trying to connect to the player. Player failed to launch or crashed soon after launching");
running tests, reporting back logs, etc
this is sourced from the com.unity.test-framework package, in AndroidPlatformSetup.cs
editorconnection.txt · Last modified: 2021/09/09 22:50 by