Build a high-level application

Build and deploy the application in Visual Studio with debugging

1. Ensure that your device is connected to your PC by USB. In the Set startup item menu, select Azure Sphere App (HLCore) where Azure Sphere App is the name of your current high-level application or press F5.

   

2. If you are prompted to build the project, select Yes. Visual Studio compiles the application, creates an image package, sideloads it onto the board, and starts it in debug mode. Sideloading means that the application is delivered directly from the PC over a wired connection, rather than delivered through the cloud.

   Note the image ID of the image package in the View > Output > Show output from: Build output. You'll use the image ID later in Tutorial: Create a cloud deployment.

3. By default, the Output window shows output from Device Output. To see messages from the debugger, select Debug from the Show output from: dropdown menu. You can also inspect the program disassembly, registers, or memory through the Debug > Windows menu.

Build and deploy the application in Visual Studio without debugging

1. Ensure that your device is connected to your PC by USB. In the Debug menu, select Start without Debugging or press Ctrl+F5.

2. If you are prompted to build the project, select Yes. Visual Studio compiles the application, creates an image package, sideloads it onto the board, and starts it. Sideloading means that the application is delivered directly from the PC over a wired connection, rather than delivered through the cloud.

3. By default, the Output window shows output from Device Output.

Build and deploy the application in Visual Studio Code with debugging

1. Press F5 to build and debug the project. If the project has not previously been built, or if files have changed and rebuilding is required, Visual Studio Code will build the project before debugging starts.

2. Wait several seconds for Visual Studio Code to build the application, create an image package, deploy it to the board, and start it in debug mode. You'll see status updates in the Output pane along the way.

   First, CMake determines whether the application needs to be built. If so, focus shifts to the output window, which displays the output from CMake/Build.

   Next, the Output pane shows the result as the image package is deployed to the device. Finally, the Debug Console receives focus and shows debugger output.

Build and deploy the application in Visual Studio Code without debugging

1. Ensure that your device is connected to your PC by USB. In the Run menu, select Start without Debugging or press Ctrl+F5 to build and run the project. If the project has not previously been built, or if files have changed and rebuilding is required, Visual Studio Code will build the project.

2. Wait several seconds for Visual Studio Code to build the application, create an image package, deploy it to the board, and start it. You'll see status updates in the Output pane along the way.

   First, CMake determines whether the application needs to be built. If so, focus shifts to the output window, which displays the output from CMake/Build.

   Next, the output window shows the output from azsphere as it deploys the image package to the device. The app starts automatically after it is deployed to the device.

Build the application

To build your application you will need to find the correct compilation tools, headers, and libraries—collectively called the sysroot—on your computer. The Azure Sphere SDK ships with multiple sysroots so applications can target different API sets, as described in Application runtime version, sysroots, and Beta APIs. The sysroots are installed in the Azure Sphere SDK installation folder under Sysroots.

1. Create or navigate to the directory that will contain the files to be generated during the build process.

2. If your application depends on another application, mark the applications as partners in their app_manifest.md files.

3. Add or update the CMakeLists.txt file for your application to call the Azure Sphere CMake functions as necessary.

4. From your project build directory, at the command prompt, run CMake with the following parameters:

   cmake --preset <preset-name> <source-path>
   

   • --preset <preset-name>

     The build configuration preset name as defined in CMakePresets.json.

   • --build <cmake-path>

     The binary directory that contains the CMake cache. For example, if you run CMake on an Azure Sphere sample, the build command would be cmake --build out/ARM-Debug.

   • <source-path>

     The path of the directory that contains the source files for the sample application. In the example, the Azure Sphere samples repository was downloaded to a directory called AzSphere.

     CMake parameters are separated by spaces. The line continuation character (^ for Windows command line, \ for Linux command line, or ` for PowerShell) can be used for readability, but is not required.

   The following examples show the CMake commands for the Hello World high-level app.

   • Windows
   • Linux

   Windows Command Prompt

   cmake ^
    --preset "ARM-Debug" ^
    "C:\AzSphere\azure-sphere-samples\Samples\HelloWorld\HelloWorld_HighLevelApp"
   

   Windows PowerShell

   cmake `
    --preset "ARM-Debug" `
    "C:\AzSphere\azure-sphere-samples\Samples\HelloWorld\HelloWorld_HighLevelApp"
   

5. Run Ninja to build the application and create the image package file:

   ninja -C out/ARM-Debug
   

   Ninja places the resulting application and .imagepackage files in the specified directory.

   You can also invoke Ninja through CMake with the following command:

   cmake --build out/<binary-dir>
   

   Set <binary-dir> to the binary directory that contains the CMake cache. For example, if you run CMake on an Azure Sphere sample, the build command would be cmake --build out/ARM-Debug.

Deploy the application

Make sure your device has the appDevelopment capability so you can sideload the application and ensure that the debugging server is present. Use the azsphere device enable-development command if necessary.

1. If your device is already running one or more applications, delete them.

   azsphere device sideload delete
   

   Note that this command deletes all the applications on the device. If you've already deployed an RTApp that is a partner to the high-level app, use the --component-id parameter to specify which application to delete. You can find the component ID of the application in its app_manifest.json file.

2. Load the image package onto your device by running the azsphere device sideload deploy command and specifying the image package. For example:

   • Azure Sphere CLI
   • Azure Sphere classic CLI

   azsphere device sideload deploy --image-package C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage
   

Your application should start running.

You can later stop and restart the application by using the azsphere device app stop --component-id <component-ID> and azsphere device app start --component-id <component ID> commands.