Add a target to run application with logging

[grendello]

We are frequently faced with the need to look at some detailed
information optionally logged by our runtime (as well as by the MonoVM
runtime in dotnet) and in order to obtain the necessary data, we ask our
users to perform a series of steps on command line.

This is a task we can easily wrap in a nice target, so that instead of
having to type 5 lines of commands the user invokes a single command
which will do the rest for them:

dotnet build -t:RunWithLogging

The above command will set the debug.mono.log property to the desired
value, increase logcat buffer, clear the buffer, start the application
waiting for it to be fully started, then pause for 1s and dump the
logcat buffer to a file.

Optionally, the $(_RunLogVerbose) property can be set to true in
order to log verbose MonoVM data and the $(_RunLogFilePath) can be set
to a logcat output file path (defaults to
$(IntermediateOutputPath)/logcat.txt)

[jonathanpeppers]

Overall the code changes look good to me if CI is green. 👍

For a new public target, I think we usually document in here how to use it:

https://github.com/xamarin/xamarin-android/blob/main/Documentation/guides/building-apps/build-targets.md

[jonathanpeppers]

Should we make this a public-facing MSBuild property? So, customers could pass -p:Duration=10000? I could see that an app might take a few seconds before it crashes, and this would be helpful to grab the log.

[grendello]

Good idea, however I think Duration is too generic a name. Will think of something.

[grendello]

Overall the code changes look good to me if CI is green. 👍

For a new public target, I think we usually document in here how to use it:

https://github.com/xamarin/xamarin-android/blob/main/Documentation/guides/building-apps/build-targets.md

I added the docs to https://github.com/xamarin/xamarin-android/blob/main/Documentation/workflow/DevelopmentTips.md as it seemed to be more contextually relevant there.

[jonathanpeppers]

You might put it in both docs, but build-targets.md occasionally is synced to:

https://learn.microsoft.com/en-us/xamarin/android/deploy-test/building-apps/build-targets

[jpobst]

RunLogDelayMS or RunLogDelayInMS might be a nicer UX.

[dellis1972]

Looks great.

I do wonder if we should add a unit test to the On Device Tests to check that this target runs and produces a log file... just in case something breaks it in the future.
It might not be needed though.

[grendello]

Looks great.

I do wonder if we should add a unit test to the On Device Tests to check that this target runs and produces a log file... just in case something breaks it in the future. It might not be needed though.

The commands it executes are pretty basic, if they break then we're probably going to notice similar issues in all the on-device tests, since they also execute a set of similar adb shell commands on app deployment.

[grendello]

I think the MAUI integration test failures can be ignored, they are workload installation issues, not related to this PR.