# Getting started with Xamarin.iOS

# Get Started in Visual Studio

  1. Browse to File > New > Project to bring you up the New Project dialog.
  2. Navigate to Visual C# > iOS > iPhone and select Single View App: enter image description here (opens new window)
  3. Give your app a Name and press OK to create your project.
  4. Select the Mac Agent icon from the toolbar, as illustrated below: enter image description here (opens new window)
  5. Select the Mac that will build your application from the list (make sure you Mac is set up to receive the connection!), and press Connect: enter image description here (opens new window)
  6. To run your application, select the Debug | iPhoneSimulator configuration, and press the Play button:enter image description here (opens new window)
  7. This will launch the iOS Simulator on the Mac, and will display your empty application: enter image description here (opens new window)

# Get Started in Xamarin Studio

  • Browse to **File > New > Solution** to bring you up the new project dialog
  • 1. Select **Single View App** and press **Next** 1. Configure your app by setting your app name and organization ID, and press **Next**: [enter image description here](http://i.stack.imgur.com/fpEWw.png)
    1. Set your Project name and Solution name, or leave as the default name. Click Create to create your project.
    2. To run your application, select the Debug | iPhone 6s iOS 9.x configuration, and press the Play button: enter image description here (opens new window)
    3. This will launch the iOS Simulator, and will display your empty application: enter image description here (opens new window)

    # Hello, World

    1. Double click on the Main.Storyboard file.
    2. Set View As to iPhone 6:enter image description here (opens new window)
    3. Drag a label and a button from the Toolbox to the design surface so that it looks like the image below:enter image description here (opens new window)
    4. In the Properties pad, give the label and button the following properties:
    nothing Name Title
    Label lblClicks [blank]
    Button clickMe Click Me!
    1. Add the following code to the ViewDidLoad method inside the ViewController class:
    clickMe.TouchUpInside += (sender, e) =>
    {
        totalClicks++;
        if (totalClicks == 1)
        {
            lblClicks.Text = totalClicks + " Click";
        }
        
       else {
           lblClicks.Text = totalClicks + " Clicks";
       }
    };
    
    
    1. Run the application

    # Remarks

    Xamarin.iOS allows you to create native iOS applications using the same UI controls you would in Objective-C and Xcode, but with the flexibility and elegance of a modern language (C#), the power of the .NET Base Class Library (BCL), and two first-class IDEs - Xamarin Studio and Visual Studio - at your fingertips.

    For more information on installing Xamarin.iOS on your Mac or Windows machine, refer to the Getting Started (opens new window) guides on the Xamarin developer center