Issues related to iOS projects

Developing on older Mac hardware

The latest macOS release and Xcode version are required to develop with Uno Platform for iOS. However, if you have an older Mac that does not support the latest macOS release, you can use a third-party tool to upgrade it, such as OpenCore Legacy Patcher. While not ideal, this can extend the use of older hardware by installing the latest macOS release on it. Please note that this method is not required when developing for other targets such as Android, Skia, WebAssembly, or Windows.

Don't know how to marshal a return value of type 'System.IntPtr'

This issue may happen for Uno.UI 4.4.20 and later, when deploying an application using the iOS Simulator, when the application contains a TextBox.

In order to fix this, add the following to your .csproj:

<PropertyGroup>
  <MtouchExtraArgs>$(MtouchExtraArgs) --registrar=static</MtouchExtraArgs>
</PropertyGroup>

Error while retrieving iOS device in VS code

When switching to an iOS debugging target in VS Code, you might encounter an error stating that the iOS device could not be retrieved. The error message may appear as follows:

[Info]: Project reload forced to switch to net8.0-ios | Debug
[Error] Could not retrieve ios devices within 10 seconds. Aborting...

To resolve this issue, download Xcodes. Inside Xcodes.app, select the correct version of Xcode and click the Make Active button to make it the default Xcode for your Mac. After completing this step, you can speed up the process and use the new default Xcode for simulators. On VS Code, open the Command Palette and select Developer: Reload Window. This should resolve the error when switching to an iOS debugging target in VS Code.

Build stops with Verification of iOS environment is running. Please try again in a moment

When building for an iOS physical device, the following error may happen in your build Verification of iOS environment is running. Please try again in a moment.. If this happens and your Visual Studio is connected to your Mac, you may need to ensure that you have selected a provisioning profile.

Make sure to configure your Apple account, or in some cases, selecting the development team and provisioning profile is required.

Debugging takes a long time when connecting from a Windows machine

In case your debugging experience is slow when connecting from a Windows VS environment to a Mac machine, make sure that you're not connected through Wifi on either end. Try pinging your Mac from your Windows machine and ensure it's lower than 5ms.

Additional troubleshooting

You can get additional build troubleshooting information here.