Merge pull request #1838 from pareenaverma/content_review

GitHub Windows Arm runner LP

Author: jasonrandrews

content/learning-paths/laptops-and-desktops/gh-arm-runners-win/_images/actions.png

@@ -0,0 +1,49 @@
+---
+title: Automate Windows on Arm Builds with GitHub Arm-hosted Runners
+
+minutes_to_complete: 20
+
+who_is_this_for: This is an introductory tutorial for software developers interested in automating Windows application builds on Arm architecture using GitHub Actions.
+
+learning_objectives:
+    - Learn about GitHub Arm-hosted Windows runners.
+    - Understand how to configure workflows for Arm-hosted runners.
+    - Automate the build process of Windows applications using GitHub Actions.
+
+prerequisites:
+    - A GitHub account
+    - Basic knowledge of GitHub Actions
+
+author: 
+    - Pareena Verma
+
+### Tags
+skilllevels: Introducory
+subjects: CI-CD
+armips:
+    - Cortex-A
+operatingsystems:
+    - Windows
+tools_software_languages:
+    - GitHub
+    - Visual Studio
+    - MSBuild
+    - Arm Performance Libraries
+
+further_reading:
+    - resource:
+        title: GitHub Actions Partner Images Repository
+        link: https://github.com/actions/partner-runner-images/
+        type: documentation
+    - resource:
+        title: GitHub Actions now supports Windows on Arm runners for all public repos
+        link: https://blogs.windows.com/windowsdeveloper/2025/04/14/github-actions-now-supports-windows-on-arm-runners-for-all-public-repos/
+        type: blog
+
+### FIXED, DO NOT MODIFY
+# ================================================================================
+weight: 1
+layout: "learningpathall"
+learning_path_main_page: "yes"
+---
+

content/learning-paths/laptops-and-desktops/gh-arm-runners-win/_images/capacity.png

@@ -0,0 +1,8 @@
+---
+# ================================================================================
+#       FIXED, DO NOT MODIFY THIS FILE
+# ================================================================================
+weight: 21                  # Set to always be larger than the content in this path to be at the end of the navigation.
+title: "Next Steps"         # Always the same, html page title.
+layout: "learningpathall"   # All files under learning paths have this same wrapper for Hugo processing.
+---

content/learning-paths/laptops-and-desktops/gh-arm-runners-win/_images/cpuinfo.png

@@ -0,0 +1,71 @@
+---
+title: Automate the Build of Windows Applications
+
+weight: 3
+
+### FIXED, DO NOT MODIFY
+layout: learningpathall
+---
+In this section, you will learn how to automate the build process of a Windows application using GitHub Arm-hosted runners. You will use the application in the [Optimize Windows applications using Arm Performance Libraries Learning Path](/learning-paths/laptops-and-desktops/windows_armpl/).
+
+### Overview of the Windows Application
+
+A basic overview of the application is provided here but for details on building the application refer to the [Optimize Windows applications using Arm Performance Libraries Learning Path](/learning-paths/laptops-and-desktops/windows_armpl/2-multithreading/).
+
+The source code for the application that renders a rotating 3D cube to perform the calculations using different programming options is provided in this GitHub repository. 
+
+```console
+https://github.com/odincodeshen/SpinTheCubeInGDI.git
+```
+
+The application implements a spinning cube and consists of four key components:
+- **Shape Generation**: Generates vertices for a sphere using a golden ratio-based algorithm.
+- **Rotation Calculation**: Uses a rotation matrix to rotate the 3D shape around the X, Y, and Z axes.
+- **Drawing**: Draws the transformed vertices of the shapes on the screen using a Windows API.
+- **Performance Measurement**: Measures and displays the number of transforms per second.
+
+The code has two options to calculate the rotation:
+
+1. Multithreading: the application utilizes multithreading to improve performance by distributing the rotation calculations across multiple threads.
+2. Arm Performance Libraries: the application utilizes optimized math library functions for the rotation calculations.
+
+You will learn how to automate the build process for this application by using GitHub Actions that leverages the Arm-hosted Windows runners.
+
+### Automate the Build Process
+
+This GitHub Actions workflow [`msbuild.yml`](https://github.com/odincodeshen/SpinTheCubeInGDI/blob/main/.github/workflows/msbuild.yml) that automates the build process for this project using MSBuild for Windows on Arm is included in this repository.
+
+Below is an explanation of the steps in the workflow:
+
+
+   **Trigger Events**: The workflow runs when there is a push or pull_request event on the main branch.
+
+   **Job Definition**: A single job named build is defined. It runs on the GitHub Arm-hosted Windows runner (`windows-11-arm`) as shown:
+
+```console
+jobs:
+  build:
+    runs-on: windows-11-arm
+```
+   **Checkout Repository**: Uses the `actions/checkout@v4` action to fetch the code.
+
+   **Add MSBuild to PATH**: Adds MSBuild tools for the build process using `microsoft/[email protected]`.
+
+   **Restore Dependencies**: Runs `nuget restore` to restore NuGet packages required by the solution.
+
+   **Create Download Directory**: Creates a directory to store downloaded files and verifies the Python version.
+
+   **Download ARM Performance Libraries**: Downloads the Windows installer for ARM Performance Libraries (APL) and verifies the downloaded files. 
+
+   **Install ARM Performance Libraries**: Installs the downloaded ARM Performance Libraries using `msiexec.exe` with a quiet mode and logs the process.
+
+   **Check Installation Success**: Verifies the success of the APL installation by checking the exit code and logs.
+
+   **Build the Solution**: Runs MSBuild to build the solution with the specified configuration (Debug) and platform (ARM64).
+
+   **Upload Build Artifact**: Uploads the built executable as an artifact using `actions/upload-artifact@v4`.
+
+This workflow automates the process of dependency management, environment setup, building your Windows on Arm project, and storing the final artifact all using GitHub Arm-hosted runner. You can view the `Actions` logs on the repository for each step. 
+![action #center](_images/actions.png)
+
+You have successfully built your Windows application and uploaded the application as an artifact of your workflow using the GitHub Arm-hosted Windows runner.