During installation, ensure the Android + Xamarin.Forms and iOS + Xamarin.Forms platforms are selected.
Video walkthrough
Create your app
Create a new Xamarin app:
Open Visual Studio 2019.
Select Create a new project.
Select Mobile from the Project type drop-down.
Select the Mobile App (Xamarin.Forms) template and click Next.
Enter AwesomeApp as the project name and click Create.
Select the Blank template. Ensure Android and iOS are both selected, and click OK.
Android SDK Install
Specific versions of the Android SDK are required to build projects. If your machine is missing the required SDK, you'll see the following prompt while the new project is loading. Click Accept to have the automatic installation begin.
Restore NuGet packages
NuGet is a package manager that will bring in the dependencies of your new app.
The package restore process will start automatically. Wait until the Restore completed message appears in the status bar at the bottom of the screen.
Create a new Xamarin app:
Open Visual Studio 2019 for Mac
Select New Project
Select Multiplatform > App > Blank Forms App and click Next
Enter AwesomeApp as the app name, and click Next
Click Create
Restore NuGet packages
NuGet is a package manager that will bring in the dependencies of your new app.
After your application loads, right click on the AwesomeApp solution and select Restore NuGet Packages
Configure device
To develop with your Android device, USB debugging needs to be enabled. Follow these steps on the device to connect it to Visual Studio. If you do not have an Android device, skip below to emulator setup instructions.
Enable developer mode
Go to the Settings screen
Find Build number by using search at the top of the settings screen, or locate it in About phone
Tap Build number 7-10 times until "You are now a developer!" pops up
Click Create
Check USB debugging status
Go to the Settings screen.
Find USB debugging by using search at the top of the settings screen, or locate it in Developer options.
Enable USB debugging if it isn't enabled already.
Trust device
Plug your device into your computer
You will be prompted to Allow USB debugging
Check Always allow from this computer
Click Allow
Your device is now configured and will show up in Visual Studio as a deployment target.
If you don't have a device to deploy to, you'll need to setup an Android emulator or use a device. If you've already done this, you can skip this step.
If this if your first time building a Xamarin application, you'll need to create a new Android Emulator. You'll see "Android Emulator" in the debug menu. Click it to start the creation process.
This brings up a UAC prompt to be accepted and then the emulator creation process. The options are automatically populated for a base emulator. If required, change any options and then select Create.
At this point, you may be prompted to agree to the license agreement for the Android emulator. Read through and select Accept to continue the process. This will download the emulator images and finalize the creation of the emulator for use in Visual Studio.
Once the emulator has been created, you'll see a button that says Start. Click it.
You may receive prompt to enable Windows Hypervisor Platform. Follow the documentation to enable this feature for optimal performance.
The Android emulator will launch. Wait for it to fully finish starting and you'll see it displayed in the Visual Studio debug menu.
Your Android emulator has now been created and is ready to use. Next time you run Visual Studio, the emulator will appear directly in the debug target window and will start when you select it. If you ran into any issues or have performance issues with the emulator, read through the full setup documentation.
For this tutorial, we'll focus on setting up and deploying to Android. To deploy to the application to iOS, you'll need to configure the Remoted iOS Simulator for Windows or configure a device for deployment with Hot Restart.
If you don't have a device to deploy to, you'll need to setup an Android emulator or device. If you've already done this or only wish to deploy to iOS, you can skip this step.
If this if your first time building a Xamarin application, you'll need to create a new Android Emulator. You'll see "Select Device" in the debug menu. Click the run button to start the creation process.
You are now prompted to verify you'd like to create an emulator. Click Add a Virtual Device:
This opens the Android Device Manager. Click + New Device to start the creation process.
The options are automatically populated for a base emulator. If required, change any options and then select Create.
At this point, you may be prompted to agree to the license agreement for the Android emulator. Read through and select Accept to continue the process. This will download the emulator images and finalize the creation of the emulator for use in Visual Studio.
Once the emulator has been created, you'll see a button that says Play. Click it and the Android emulator will launch. Wait for it to fully finish starting and you'll see it displayed in the Visual Studio debug menu.
Your Android emulator has now been created and is ready to use. Next time you run Visual Studio, the emulator will appear directly in the debug target window and will start when you select it. If you ran into any issues or have performance issues with the emulator, read through the full setup documentation.
Your emulator or device should now be configured for deployment!
Run your app
From the menu, select Debug > Start Debugging.
Your application will build then deploy to the Android emulator and run.
Select your startup project
Right-click on the AwesomeApp.iOS project and select Set As Startup Project.
Start your app
From the menu, select Debug > Start Debugging.
Your application will build then deploy to the iOS emulator and run.
Optional: Run on Android
Right-click on the AwesomeApp.Android project and select Set As Startup Project.
From the menu, select Debug > Start Debugging.
Your application will build then deploy to the Android device/emulator and run.
Congratulations, you've built and run your first .NET mobile app!
Video walkthrough
Edit your code
Now you'll add a button to the user interface, along with a click event that will increase and display a count.
Stop debugging
From the menu, select Debug > Stop Debugging.
From the menu, select Run > Stop Debugging.
Add a button
Open MainPage.xaml and add the following code under the <Label ... />:
MainPage.xaml
<Button Text="Click Me" Clicked="Handle_Clicked" />
The code inside of the ContentPage in MainPage.xaml should look like:
MainPage.xaml
<StackLayout> <Label Text="Welcome to Xamarin.Forms!" HorizontalOptions="Center" VerticalOptions="CenterAndExpand" /> <Button Text="Click Me" Clicked="Handle_Clicked" /></StackLayout>
Add an event handler
Open MainPage.xaml.cs and add the following code inside of the class:
