Getting started with Objective-C

This is the getting started page for Objective-C, which covers the basics for all supported platforms.


To use .NET Embedding with Objective-C, you'll need a Mac running:

  • macOS 10.12 (Sierra) or later
  • Xcode 8.3.2 or later
  • Mono 5.0

You can install Visual Studio for Mac to edit and compile your C# code.


  • Earlier versions of macOS, Xcode, and Mono might work, but are untested and unsupported
  • Code generation can be done on Windows, but it is only possible to compile it on a Mac computer where Xcode is installed

Installing .NET Embedding from NuGet

Follow these instructions to install and configure .NET Embedding for your project.

A sample command invocation is listed in the macOS and iOS getting started guides.


Objective-C is a language that is most commonly used to write applications for macOS, iOS, tvOS and watchOS; .NET Embedding supports all of those platforms. Working with each platform implies some key differences and these are explained here.


Creating a macOS application is easiest since it does not involve as many additional steps, like setting up identity, provisining profiles, simulators and devices. You are encouraged to start with the macOS document before the one for iOS.

iOS / tvOS

Please make sure you are already set up to develop iOS applications before trying to create one using .NET Embedding. The following instructions assume that you have already successfully built and deployed an iOS application from your computer.

Support for tvOS is analogous to how iOS works, by just using tvOS projects in the IDEs (both Visual Studio and Xcode) instead of iOS projects.


Support for watchOS will be available in a future release and will be very similar to iOS/tvOS.

Further reading