How to Build Cross-Platform .NET Core Apps

One of the main reasons for using .NET Core is that you can run it on multiple platforms and architectures. So you can build an app that will run on Windows, but also on Linux, macOS and on different architectures like x86 and ARM. This is perfect for lots of scenarios, including desktop applications.

You can learn about other reasons for using .NET Core in this article about the .NET ecosystem on Stackify’s blog and in my Pluralsight course: The .NET Ecosystem: The Big Picture.

In this article, I’m going to show you how to create a simple .NET Core console application that can run on multiple operating systems.

To work through the demos in this article, make sure that you have the following installed on a computer running Windows 10:

• Visual Studio 2017 any edition (update 2 or higher)
• .NET Core 2 SDK

Additionally, in order to run the app on a Mac, you will need access to a Mac that is running macOS 10.12 “Sierra” or a later version. If you don’t have one, you can get access to a Mac environment using https://www.macincloud.com

.NET Core application deployment options

You can deploy .NET Core applications as framework-dependent applications and as self-contained applications.

There are a couple of differences between the two deployment models:

• Framework-dependent applications require the .NET Core framework to be installed on the machine that the app will run on.
  • Self-contained applications don’t, because they contain everything the app needs to run
• Framework-dependent applications can run on any operating system that you install .NET Core on, without modification
  • In contrast, for every OS that you want a self-contained app to run on, you need to publish an OS-specific version

How to create an app for multiple operating systems

Now that we know there are two different deployment options for .NET Core, let’s explore how to use those to run a .NET Core app in multiple operating systems.

To explore this, we’ll create two simple .NET Core console applications and run those on Windows and on macOS. I’ve already created this sample in a GitHub repository that you can find here.

We’ll create the applications using Visual Studio 2017. This is technically not needed, as you can create .NET Core applications with many different IDEs and even with the command line. Choose the IDE or tool that you are most comfortable with.

Framework-dependent app

First, we’ll create a framework-dependent app. We do this in Visual Studio 2017 with all the latest updates (at the moment, I’m on 15.5.2).

1. In Visual Studio, click File > New Project and select .NET Core
   1. Now select the Console App (.NET Core) project type and create it
2. Navigate to Program.cs. Out of the box, it will write Hello World! to the console
   1. Add Console.ReadLine(); below the Hello World line, to keep the console window open when the app runs

That’s it! This app will run on every operating system that .NET Core supports.

Self-contained app

Next, we’ll create a self-contained app. This is very similar to creating a framework-dependent app, but contains one extra step:

1. In Visual Studio, click File > New Project and select .NET Core
   1. Now select the Console App (.NET Core) project type and create it
2. Navigate to Program.cs. Out of the box, it will write Hello World! to the console
   1. Add Console.ReadLine(); below the Hello World line, to keep the console window open when the app runs
3. Now for the extra step to make this into a self-contained application. Right-click the project file and click Edit Project like in the image below:

1. Now, in the project file, add the highlighted line:

• 1. This tells .NET Core which runtimes it can be built and published for and tells it to create a self-contained app. Currently, the app can only be published for Windows 10.

Running the app on Windows and macOS

So now, we have two .NET Core console applications; one framework-dependent and one self-contained. Let’s run them on Windows and on macOS.

Publishing the applications to run on Windows

Before we run the apps, we need to publish them, as you would do in production, to get a release build. For Windows, we can follow the same steps for both applications:

1. In Visual Studio, right-click the project file and click Publish, like in the image below

1. Then, you can pick a folder and click publish. That’s it!
2. Do the same for the self-contained app

Publishing for running on macOS

If we want the framework-dependent app to run on macOS, we don’t have to do anything special, we can just use the publish results of the previous steps.

However, if we want the self-contained app to run on anything other than Windows, we need to take additional steps:

1. In Visual Studio, right-click the project file of the self-contained app and click Edit Project to edit the project file
2. Now add a new Runtime Identifier to the file and save it, just as highlighted here: