Testing On Devices
macOS only

RhinoMobile: Deprecated
RhinoMobile is no longer supported. Rhino 3dm file I/O is still available on iOS and Android via the rhino3dm library.

Android Devices

In order to debug your code on an Android device, you must enable USB debugging on the device. This mode makes your device somewhat more vulnerable to damage - from you and from others - so it should be used with caution. You can enable and disable it between development sessions if you like.

Android 4.0 (JellyBean - API 14) or higher devices

Enable the USB Debugging option under Settings > Developer options.

For Android 4.2 and newer, Developer options is hidden by default; use the following steps:

  1. On the device, go to Settings > About .
  2. Tap the Build number seven times to make Settings > Developer options available.
  3. Then enable the USB Debugging option.

On Windows, it is sometimes necessary to switch your device to Camera (PTP) mode, rather than Media device (MTP) mode. To change this mode, use the following steps:

  1. On the device, go to Settings > Storage > More options (…) > USB computer connection
  2. Switch from Media device (MTP) to Camera (PTP).

Kindle Fire Devices

On the device, select Settings > Security and set Enable ADB to On.

For more information, see the Amazon developer documentation.

You might also want to enable the Stay awake option, to prevent your Android device from sleeping while plugged into the USB port.

iOS Devices

iOS devices must be registered with Apple before you can use them for development or testing. This process is known as Device Provisioning. Follow these directions from Xamarin to get your iOS device ready to go.

Once you have your device provisioned and connected via USB, you can run and debug your app from Xamarin Studio or Visual Studio (via the Mac Build host).

Devices are the best place to test your app. The four areas where devices differ most from the simulator are:

  1. Networking and connectivity
  2. Location services
  3. Memory
  4. OpenGL ES

The last two are the most critical to RhinoMobile apps. Large meshes in .3dm files can consume lots of memory; the simulator will try to invoke OutOfMemory warnings, but there will not be as consistent (or realistic) as running and debugging on the device. Finally, OpenGL ES calls will be interpreted differently on the simulator than on the device…it is possible that code working on the simulator will not work on all devices.