Installing Tools (Mac)

This guide covers all the necessary tools required for RhinoMobile on Mac.

By the end of this guide, you should have all the tools installed necessary for authoring, building, and debugging C# mobile applications using RhinoMobile in Xamarin Studio.

Prerequisites

If you have not done so already, please read the What is RhinoMobile? guide.

This guide presumes you have an:


Install Xcode

Xcode is Apple’s development platform and IDE.

Step-by-Step

  1. Xcode is free in the Mac App Store. Click the View in Mac App Store button.
  2. Click the Get > Install App button underneath the Xcode icon.
  3. You will be prompted for your Apple ID (required to download apps on the App Store).
  4. Xcode is large download - nearly 2.6 GB in size. You can monitor the progress of the download in Launchpad. When Xcode is finished downloading an installing, it will be your /Applications folder.
  5. Launch Xcode. On initial launch, Xcode will install some additional components.
  6. Quit Xcode.

Install Xamarin

Xamarin’s platform is currently required to build RhinoMobile apps. Please check out the What are Mono and Xamarin? guide for more information.

Step-by-Step

  1. Download the Xamarin Platform.
  2. Xamarin uses an Installer app, which downloads and installs the components that you select. Once you have downloaded the XamarinInstaller.dmg, double-click it to mount the disk image. Double-click the big Install Xamarin icon to launch the installer.
  3. You must accept the Xamarin Software License Agreement to use the Xamarin platform.
  4. The Xamarin Platform is comprised of these pieces:
    • Xamarin Studio
    • Xamarin.Android1
    • Xamarin.iOS2
    • Xamarin.Mac3 …verify that Xamarin.Android and Xamarin.iOS are checked and click Continue.
  5. If you do not have Xcode installed, Xamarin will prompt you. See Install Xcode above.
  6. Xamarin installs: Mono Framework, Xamarin Studio, Xamarin.Android, and Xamarin.iOS. Click Continue.
  7. Xamarin is will now download and install. Depending on which products you selected in step 4 above, this can take a while.
  8. When the installer is finished, click the Launch Xamarin Studio button.
  9. Xamarin Studio - along with the Mono Framework, Xamarin.Android, and Xamarin.iOS - are now installed.
  10. Xamarin Studio is installed in your /Applications folder. You will want to drag its icon to your Dock for future use or - if it’s running - right/option-click the icon in the Dock and select Keep in Dock.

Update the Android SDK

Once Xamarin Studio itself has been updated, you need to fetch the updates for the Android SDK.

Step-by-Step

  1. In Xamarin Studio, navigate to Tools > Open Android SDK Manager….
  2. In the Android SDK Manager window, wait until manager has finished fetching the update manifest.
  3. Depending on when you downloaded the Xamarin tools, you will want to install the most recent API (21 at the time of writing) as well as the last couple (20 and 19) for backward compatibility. Select the small check boxes next the names and then click Install N packages… button.
  4. This brings up a (very buggy) window in which you must accept all the licenses of each item before continuing. If you can’t get the Install button to work, exit out of the window, open it again, and individually click the Accept radio button on the left until it works. android sdk
  5. Note: Downloads can take awhile depending on your internet connection.

Install the Intel HAXM

The Intel HAXM is the Intel Hardware Acceleration Execution Manager. HAXM provides a hardware-accelerated engine for the x86 Android emulators. Without HAXM, the emulators are nearly unusable, as their performance lags so much. However, with HAXM, the x86 emulators are responsive and usable. Not as fast as an actual device, but at least passable. It’s available to install via the Android SDK manager, but the version there is ineffective. Instead, get it from the link above. HAXM will not work in a virtualized environment, e.g. a VM, so if you’re doing your Android development in a Windows VM, you will need to use a device.

Step-by-Step

  1. Visit the Intel Hardware Acceleration Execution website.
  2. Find the macOS section of the page.
  3. Download the haxm-macosx_rxx.zip. You may be asked to accept an license agreement before downloading can begin.
  4. Unzip haxm-macosx_rxx.zip.
  5. Mount the IntelHAXM_x.x.x.dmg by double-clicking it.
  6. Install the HAXM by double-clicking the IntelHAXM_x.x.x.mpkg file.

Clone RhinoCommon

RhinoMobile is built around RhinoCommon’s rhino3dmio branch. You can either download RhinoCommon as a zip or clone the repository using git (recommended). (If you are new to GitHub, there is a GitHub Mac Desktop app to get you started).

Step-by-Step

  1. Unzip or clone rhinocommon (rhino3dmio branch) in a convenient folder, such as the /Users/you/Development/Repositories/rhinocommon folder: clone rhinocommon
  2. Download openNURBS. RhinoMobile requires the C++ openNURBS SDK.
  3. Unzip openNURBS and place the contents in the rhinocommon/c/opennurbs/ folder (the folder containing only the readme.md file): opennurbs

Clone RhinoMobile

You will need to download or clone RhinoMobile and the RhinoMobileSamples repositories. (If you are new to GitHub, there is a GitHub Mac Desktop app to get you started).

Step-by-Step

  1. Unzip or clone RhinoMobile into a folder parallel to rhinocommon (cloned above). For example, if rhinocommon is in the /Users/you/Development/Repositories/rhinocommon folder, then RhinoMobile should be in the /Users/you/Development/Repositories/RhinoMobile folder: rhinomobile
  2. Unzip or clone RhinoMobileSamples into a folder parallel to rhinocommon and RhinoMobile: rhinomobilesamples

Next Steps

Congratulations! You have all the tools necessary to build a mobile app that uses RhinoMobile. Now what?

Check out the Your First App (Mac) guide for instructions building - your guessed it - your first app.



Footnotes

  1. Xamarin.Android is used to build C# .NET applications for Android devices. 

  2. Xamarin.iOS is used to build C# .NET applications for Apple iOS devices. 

  3. Xamarin.Mac is Xamarin’s proprietary closed-source toolkit build on the open-source MonoMac (aka Mono for macOS). Xamarin.Mac provides a commercial license of Mono, bindings to additional frameworks, and the ability to create self-contained application bundles that do not require mono. RhinoMobile does not currently use Xamarin.Mac.