Testing PR Builds

The below instructions are also available in video format.

🚨 Testing pull request (PR) builds is not without risk. These builds may contain untested features, unreviewed fixes, and code which has not been validated. It is important to understand these risks before pulling a package from the feed. You should never use these in production.

That said, testing pull request builds is a great way to help other developers test and review their features before they are added to .NET MAUI, or if you just need the fix from the PR before it's released by the team.

To find the packages for the latest successful build of a PR you are interested in, at the bottom of the PR listing there will be a Checks block as shown in the screenshot below.

Note

If a PR is already merged you will have to click the View Details button next to the merge commit to see the list of checks.

You can expand the checks by clicking on the little down arrow on the right side. This will show you all the completed checks that were done using the code from this PR. For .NET MAUI there are quite a few checks, you are looking for the one called MAUI-public (any other ones prefixed MAUI-public will probably also get you to the right place). See the screenshot below.

Click on the MAUI-public name, or the three dots on the right and then View details.

This will first take you to a GitHub summaries page for this check. All the way at the bottom you will find a View more details on Azure Pipelines link. You will want to click on that. See the screenshot below.

On the page that now opens, in the top section find the Related heading. There it says 9 published, 1 consumed (the numbers many vary), which refers to the artifacts that have been published and consumed by this build. The description (n published, n consumed) is clickable, click that link. Please refer to the screenshot below.

Now you will see a list of artifacts from this build. The testable binaries for this PR build will be in nuget. Find that one in the list, click the three dots on the right side and then choose Download artifacts.

To install the package, first you have to unzip the downloaded file to a location on your filesystem.

After that, you can setup that local folder as a NuGet source on your machine through Visual Studio.

Then open the NuGet Package Manager, make sure that you have selected your local NuGet feed, and check the Include prerelease box and install .NET MAUI as usual. Make sure that the installed version matches the version in the filenames of the local *.nupkg files.

Now you can rebuild your project and test if it's working as intended. Please don't forget to leave your feedback on the issues/PR as that will help us speed up reviews and be more confident that the fix in that pull request is indeed the right one. Thank you!