Azure DevOps for .NET MAUI using YML

#dotnetmaui #dotnet #azure #multienvironment

NET Multi-platform App UI (.NET MAUI) is a cross-platform framework for creating native mobile and desktop apps with C# and XAML. Using .NET MAUI, you can develop apps that can run on Android, iOS, macOS, and Windows from a single shared code-base. In these post series, I will show you how to implement Continuous Integration in your .NET MAUI app using the Microsoft Azure DevOps with YML in a multi-environment.

Disclaimer

The steps below represent an approach I follow for my projects due to they accommodate for my requirements. You are free to update the logic and YML files to fit your needs on each project. Also, in an effort to demo the multi-environment, I am using Firebase Analytics services.

Getting Started

Shared

In the Azure Pipelines -> Library upload the Android KeyStore file, the Apple .p12 certificate & provisioning profile files and the Google firebase config files if you are using this service.

Make sure the Google firebase files are renamed using the following sample:

Then create a variable group called: "App Configuration" within the Library, this variable group will contain the configuration keys for the Android and iOS build and we use them because it is the securest way to store the sensitive data.

Variable	Value
app-build-configuration	Release
app-check-dependencies	true
app-id-android	com.company.appname
app-id-ios	com.company.appname
app-path-contents	PROJECT_PATH/bin
app-path-project	PROJECT_PATH/project.csproj
app-path-root	PROJECT_PATH
app-target-framework-android	.net7.0-android
app-target-framework-ios	.net7.0-ios
apple-certificate-name	CERTIFICATE_NAME.p12
apple-certificate-password	******
apple-provisioning-profile-name	PROFILE_NAME.mobileprovision
dotnet-version	7.0.x
android-signing-key-password	******
android-keystore-alias	ALIAS
android-keystore-name	FILE.keystore
android-keystore-password	******

iOS

Create a new file azure-pipelines-ios.yml in your code repository at any path you prefer.

Android

Create a new file azure-pipelines-android.yml in your code repository at any path you prefer.

Basically, the pipelines will always trigger automatically pointing to the staging environment when a versioning tag is added to a branch, however, you can run the pipeline manually and set the environment pointing to production, so it generates a new version of the app. Just, don't forget to set the version tag before trigger the pipeline manually.

What About Distribution?

I'm working in a post to share how to distribute the application through different channels. I hope to have it ready soon.

Conclusion

There are tons of combinations and customizations for the YML and each project may have its own set of rules for CI. Take this just as an example or base and improve it, please!

I hope this helps others to create their own pipelines for .NET MAUI.