In this book, we’ll be building iOS, Android, Windows, and Mac applications using one common code base. Everything you need is free unless you want to build for iOS and Mac, in which case you need a Mac computer. I’m going to assume you have a Mac, but if you don’t, very little will change; you’ll just be more limited in the platforms you candeploy to.

An alternative if you don’t have a Mac

James Montemagno of Microsoft has a workaround video if you don’t have a Mac. There are severe limitations, but needs must. My personal recommendation is that if you don’t have a Mac, do your development with Android. Here’s thevideo:https://www.youtube.com/watch?v=snQ1C6Cppr8.

In the coming chapters, you will see a non-trivial .NET MAUI project that we will build incrementally. Along the way, we will examine how to create theUser Interface (UI) withXAML (a markup language)andC#.

MAUI Blazor

An alternative, not covered in this book, is to use MAUI Blazor, which allows you to create a cross-platform application using your Blazor skills. You can learn more about MAUI Blazorathttps://bit.ly/MauiBlazor.

In the first part of the book, we will discuss the principal architecture for .NET MAUI:Model-View-ViewModel (MVVM). We will then dive into the diverse controls available for creating powerful UIs followed by a chapter dedicated to techniques for laying out these controls onthe page.

We will move on to discussing the Shell navigation architecture and how you move from page to page, passing along data as needed. We’ll look at persisting data and then stop to discuss the all-important topic of testingyour code.

While .NET MAUI provides a cornucopia of controls, there are times when you need something that Microsoft did not anticipate, so we’ll dedicate a chapter to creating custom controls. (Once you have a custom control, you can use it in any subsequent .NET MAUI projects youwork on.)

In the final section of the book, we’ll look at consuming a REST API and creating a web frontend to the same REST API we used for the mobile and desktop applications, this timeusingBlazor.

In this chapter, you will learn how to get and install Visual Studio for writing the program and Git for managing and safeguarding your code. Each chapter’s final code will be in a dedicated branch, with the final product in themain branch.

In this chapter, you will findthe following:

• A description of Visual Studio, along withinstallation instructions
• A description of Git, along withinstallation instructions
• A description of how to create your first, out-of-the-box program, and a tour of the files inthat project

App versus application

Since we will be building for iOS and Android (which refer to apps) and also Windows and Mac (which refer to applications), I’ll be using the twoterms interchangeably.

Let’s get the software you need, and then set upVisual Studio.

To follow along with this chapter and book, you will need to obtain and install Visual Studio and Git. To do this, you will need a Windows machine (Windows 10 or later). In addition, if you want to write for iOS and/or the Mac, you will need an Apple computer on the same network as yourWindows computer.

All of the code in this book is available athttps://github.com/PacktPublishing/.NET-MAUI-for-C-Sharp-Developers. The code for each chapter will have its own branch and that will be noted in theTechnical requirements section of the given chapter. Note that there is no code forChapters 1and2.

A word on Visual Studio Mac

It should be possible to follow along with this book using Visual Studio Mac, but some of the menus and certainly many of the keystrokes will be different. In my experience, Visual Studio Mac follows Visual Studio with a short delay in the implementation of new features. If all you have is a Mac, by all means do your development there. If you have both, or just a Windows machine, you’ll find it a bit easier to follow along with Visual Studio (for Windows).

While I’m at it, I’ll mention that I’m using Windows 11 on a desktop computer with 64 GB of memory and a 1 TB disk. None of that is required for this book. You will want at least 16 GB of memory for .NETMAUI programming.

The first and foremost software you’ll need for this book is the latest version of Visual Studio from Microsoft. You can, of course, write .NET and .NET MAUI apps with any number of editors and/orIntegrated Development Environments (IDEs), but Visual Studio is what I’ll be using in this book because it is, I believe, the most powerful IDE for the job. All the examples will use Visual Studio and your job will be much easier if you do so as well, at least while working your way throughthis book.

To get Visual Studio, open a browser and navigate tohttps://visualstudio.microsoft.com/. Microsoft changes the appearance of this page pretty frequently, but you should see the opportunity to downloadVisual Studio,Visual Studio for Mac, andVisualStudio Code.

Installing Visual Studio

On thewebsite, click onDownload Visual Studio. You can download whichever version you prefer. Note that the Community Version is free. If you already have Visual Studio 2022 or later installed, you need not add another copy, though they will run side by side assuming you have enough disk space. For installation, followthese steps:

1. Once Visual Studio has been downloaded, click on the executable to begin the installation process. The installer will update and you will be presented with theWorkloads dialog box as shown inFigure 1.1.

Figure 1.1 – Visual Studio Workloads

2. Visual Studio lets you pick and choose what workloads you’ll need so that it is no bigger than necessary. Be sure to checkAzure development, .NET Multi-platform App UI development, and.NET desktop development as shown inFigure 1.2.

Figure 1.2 – Selecting workloads

3. Next, clickInstall and get yourself a cup of coffee; this may take a few minutes. You should see progress in the Visual Studio installer, as inFigure 1.3.

Figure 1.3 – Visual Studio Installer

When the installation is complete, Visual Studiowill open.

A word on ReSharper

ReSharper is a very powerful tool that greatly enhances productivity for .NET developers. It is not free, however, and while I use it every day in my own work, we’ll not be using it in this book. Since we can do everything in Visual Studio without ReSharper (though it may take a few more keystrokes), noharm done.

With Visual Studio installed, the only remaining issue is storing, safeguarding, and retrieving the source code. For that, we’ll useGit – the industry standard. The final application will be in the main branch, with each chapter’s code being in adedicated branch.

The next software you need is Git. To downloadGit, navigate togit-scm.com/downloadand choose your operating system. I’ll choose Windows. Next, I’ll choose64-bit Git for Windows Setup underStandalone Installer. This will cause an immediate download. Double-click on the downloaded file to install it. If you already have Git installed, this willupdate it.

You do not need any of the Git GUIs, as we’ll be interacting with Git throughVisual Studio.

When the installation is complete, you’ll see the following options:Launch Git Bash andView the release notes. Uncheck both and clickonFinish.

Let’s continue with our exploration ofVisual Studio.

You’ll need to obtain the rest of the software from within Visual Studio, so let’s open that next. If the installation went as expected, the launch dialog will be onthe screen:

1. Click onCreate a new project. (If you’ve been brought directly into Visual Studio, bypassing the launch dialog, just clickFile |New Project.)
2. It is now time to pick the template we want. Templates make getting started easier. In theSearch for Templates box, enterMAUI. A few choices will be presented; you want.NET MAUI App, as shown in thefollowing figure:

Figure 1.4 – Creating a new project

3. ClickNext. Herewe give our project a name. The first project we’re going to create is notForgetMeNotDemo (the project that you will be building as part of this book), but rather a sample project just to take a quick look around. Name it something creative such asSampleApp and place it in a location on your disk where you will be able to easily find it later. Before clickingNext, make sure your dialog looks similar toFigure 1.5.

Figure 1.5 – Naming your project

4. ClickNext and usethe dropdown to choose the latest version of .NET. At the time of writing, that is .NET 7. Finally, clickonCreate.

Note

Because Microsoft is always updating Visual Studio, your screens or steps may vary slightly. Don’t let that worry you. The version I am using is Visual Studio 2022, version 17.4.3. As long as yours is the same or later, you’re all set. But just to be sure, let’s launch the sample app (F5). You should see something that looks likeFigure 1.6.

Figure 1.6 – Running your app

5. On the screen that you see in the preceding figure, click the button a couple times to make sure itis working.

Generally speaking, I will not be walking through how to do simple things on Visual Studio. The assumption is that you are a C# programmer and so you are probably familiar with Visual Studio. On the other hand, on the off chance that you are not, I’ll describe how to do anything that is not immediately intuitive. Next, let’s explore the out-of-the-box app in a bitmore detail.

Quick tour of the app

Let’s take a quick tourto see what comes with an out-of-the-box app. First, stop the app by pressing the red square button in the menu bar. Make sureSolution Explorer is open (if not, go toView |Solution Explorer). Notice that there are three folders and four files, as shown inFigure 1.7:

Figure 1.7 – Three folders and four files

The files with the.xaml extension are XAML files – that is, they use the XAML markup language. I will not assume you know XAML, and in fact, throughout this book, I will provide layout and other code in both XAML and fluent C#, but that is for thenext chapter.

Right now, let’s openthis out of thebox project.

This is the entry point for the program. As you can see, it is a static class with a static method that is responsible for creating the app itself. We’ll come back to this file insubsequent chapters.

When you openMainPage.xaml, you will see a layout with controls for the page we just looked at (with the goofy MAUI guy waving and counting our button clicks). Again, we’re going to come back to layout and controls, but scan this page and see whether you can guess what is going on. You may find that it isn’t as alien as it seemed at first glance. You can, if you are so motivated, learn quite a bit about XAML just by reading thispage carefully.

Click on the triangle next toMainPage.xaml to reveal the code-behind file. Code-behind files are always named<PageName>.xaml.cs – in this case,MainPage.xaml.cs. These files are always in C#. Here, we see the constructor and then an event handler. When the user clicks on the button, this event handler (OnCounterClicked)is called.

By flipping back and forth between the XAML and the code-behind file, you may be able to figure out how the button works and how the count of clicks is displayed. No need to do this, however, as we’ll be covering all these details inupcoming chapters.

At the moment, most of the other files are nearly empty and not worth the timeto examine.

Just for fun, expand theResources folder. You’ll see that there are folders for the application icon, fonts, images, and so forth. All the resources for all of the platforms arekept here.

Then there is aPlatforms folder, which contains whatever is needed on a per-platform basis. For example, iOS applications require aninfo.plist file, which you’ll find inPlatforms |iOS.

There is much more to see in a .NET MAUI application, but we will tackle each part as we build ForgetMe Not™.

In this chapter, you saw how to find, download, and install Visual Studio and Git, the two tools you’ll need throughout the book. You also created your first .NET MAUI app, and we walked through some of its files,albeit quickly.

In the next chapter, we’ll take an extended look at XAML: the markup language for page layout and the creation of controls. We’ll then look at creating layouts and controls in C# and a new library that allows us to use Fluent C# to create layoutsand controls.

Test your understanding of this chapter by answering thefollowing questions:

1. How do you create anew project?
2. How do you findSolution Explorer if it isnot visible?
3. What does the.xamlextension indicate?
4. What do we call the.cs file associated with an.xaml file?
5. Where is the entry point for a .NETMAUI app?

Most chapters will have aYou try it section, in which you will be encouraged to take on a task related to what was covered in the chapter. Alas, this chapter does not have a taskfor you.