[Microsoft.Android.Run] Add simple console app for dotnet run

Fixes: #10645

For alignment with other platforms, including `dotnet new console`,
`dotnet run` for Android should:

* Show console output for the launched process
* Exit if the app closes
* Close the app on Ctrl+C

A one-liner like this is *close*:

    adb shell 'am start -S -W -n "PACKAGE/ACTIVITY"; pid=$(pidof PACKAGE); logcat --pid=$pid'

But then Ctrl+C does not close the app, so to wire this all together,
add a simple console app to be invoked by `dotnet run`.

We do not initially intend for this app to be run directly by users,
so it is placed in the `tools` folder of the SDK pack and not a .NET
global tool.

New MSBuild properties:

`$(WaitForExit)`

* Default: (empty)
* When `false`, allow users to disable waiting for the app to exit,
which is useful for our existing tests.

`$(_AndroidRunPath)`

* Default: `$(MSBuildThisFileDirectory)..\tools\Microsoft.Android.Run.dll`
* Allows overriding the path to the `Microsoft.Android.Run` assembly.

`$(_AndroidRunExtraArgs)`
* Default: (empty)
* Allows extra args like `--verbose` passed in

Author: jonathanpeppers

Directory.Build.targets

@@ -2,6 +2,7 @@
 
   <!-- NuGet Package Versions -->
   <ItemGroup>
+    <PackageReference Update="Microsoft.SourceLink.GitHub"                  Version="8.0.0" />
     <PackageReference Update="Microsoft.Win32.Registry"                     Version="5.0.0" />
     <PackageReference Update="System.CodeDom"                               Version="9.0.8" />
     <PackageReference Update="Irony"                                        Version="1.1.0" />

Documentation/docs-mobile/building-apps/build-properties.md

@@ -1819,3 +1819,21 @@ This MSBuild property replaces the
 Xamarin.Android. This is the same property used for [Blazor WASM][blazor].
 
 [blazor]: /aspnet/core/blazor/host-and-deploy/webassembly/#ahead-of-time-aot-compilation
+
+## WaitForExit
+
+A boolean property that controls the behavior of `dotnet run` when launching
+Android applications.
+
+When `$(WaitForExit)` not `false` (the default), `dotnet run` will:
+
+* Launch the Android application
+* Stream `logcat` output filtered to the application's process
+* Wait for the application to exit or for the user to press Ctrl+C
+* Force-stop the application when Ctrl+C is pressed
+
+When `$(WaitForExit)` is `false`, `dotnet run` will simply launch the
+application using `adb shell am start` and return immediately without
+waiting for the application to exit or streaming any output.
+
+Introduced in .NET 11.

Xamarin.Android.sln

@@ -25,6 +25,8 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Xamarin.Android.Tools.Aidl"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Xamarin.Android.Build.Tasks", "src\Xamarin.Android.Build.Tasks\Xamarin.Android.Build.Tasks.csproj", "{3F1F2F50-AF1A-4A5A-BEDB-193372F068D7}"
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.Android.Run", "src\Microsoft.Android.Run\Microsoft.Android.Run.csproj", "{A1B2C3D4-E5F6-4A5B-8C9D-0E1F2A3B4C5D}"
+EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.Android.Sdk.ILLink", "src\Microsoft.Android.Sdk.ILLink\Microsoft.Android.Sdk.ILLink.csproj", "{71FE54FA-0BF5-48EF-ACAA-17557B28C9F4}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Xamarin.Android.Tools.Bytecode", "external\Java.Interop\src\Xamarin.Android.Tools.Bytecode\Xamarin.Android.Tools.Bytecode.csproj", "{B17475BC-45A2-47A3-B8FC-62F3A0959EE0}"
@@ -169,6 +171,10 @@ Global
 		{3F1F2F50-AF1A-4A5A-BEDB-193372F068D7}.Debug|AnyCPU.Build.0 = Debug|Any CPU
 		{3F1F2F50-AF1A-4A5A-BEDB-193372F068D7}.Release|AnyCPU.ActiveCfg = Release|Any CPU
 		{3F1F2F50-AF1A-4A5A-BEDB-193372F068D7}.Release|AnyCPU.Build.0 = Release|Any CPU
+		{A1B2C3D4-E5F6-4A5B-8C9D-0E1F2A3B4C5D}.Debug|AnyCPU.ActiveCfg = Debug|Any CPU
+		{A1B2C3D4-E5F6-4A5B-8C9D-0E1F2A3B4C5D}.Debug|AnyCPU.Build.0 = Debug|Any CPU
+		{A1B2C3D4-E5F6-4A5B-8C9D-0E1F2A3B4C5D}.Release|AnyCPU.ActiveCfg = Release|Any CPU
+		{A1B2C3D4-E5F6-4A5B-8C9D-0E1F2A3B4C5D}.Release|AnyCPU.Build.0 = Release|Any CPU
 		{71FE54FA-0BF5-48EF-ACAA-17557B28C9F4}.Debug|AnyCPU.ActiveCfg = Debug|Any CPU
 		{71FE54FA-0BF5-48EF-ACAA-17557B28C9F4}.Debug|AnyCPU.Build.0 = Debug|Any CPU
 		{71FE54FA-0BF5-48EF-ACAA-17557B28C9F4}.Release|AnyCPU.ActiveCfg = Release|Any CPU

build-tools/create-packs/Microsoft.Android.Sdk.proj

@@ -65,6 +65,9 @@ core workload SDK packs imported by WorkloadManifest.targets.
       <FilesToPackage Include="$(MicrosoftAndroidSdkOutDir)generator.dll" TargetPath="tools" />
       <FilesToPackage Include="$(MicrosoftAndroidSdkOutDir)generator.pdb" TargetPath="..\tools" IsSymbolFile="true" />
       <FilesToPackage Include="$(MicrosoftAndroidSdkOutDir)generator.runtimeconfig.json" TargetPath="tools" />
+      <FilesToPackage Include="$(MicrosoftAndroidSdkOutDir)Microsoft.Android.Run.dll" TargetPath="tools" />
+      <FilesToPackage Include="$(MicrosoftAndroidSdkOutDir)Microsoft.Android.Run.pdb" TargetPath="..\tools" IsSymbolFile="true" />
+      <FilesToPackage Include="$(MicrosoftAndroidSdkOutDir)Microsoft.Android.Run.runtimeconfig.json" TargetPath="tools" />
       <FilesToPackage Include="@(VersionFiles)" TargetPath="tools" />
       <FilesToPackage Include="$(XamarinAndroidSourcePath)src\Xamarin.Android.Build.Tasks\Microsoft.Android.Sdk\Sdk\**" TargetPath="Sdk" />
       <FilesToPackage Include="$(XamarinAndroidSourcePath)src\Microsoft.Android.Sdk.ILLink\PreserveLists\**" TargetPath="PreserveLists" />

src/Microsoft.Android.Run/Microsoft.Android.Run.csproj

@@ -0,0 +1,24 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <Import Project="..\..\Configuration.props" />
+
+  <PropertyGroup>
+    <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
+    <OutputPath>$(MicrosoftAndroidSdkOutDir)</OutputPath>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>$(DotNetTargetFramework)</TargetFramework>
+    <RootNamespace>Microsoft.Android.Run</RootNamespace>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <DebugType>portable</DebugType>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.SourceLink.GitHub" PrivateAssets="All" />
+    <PackageReference Include="Mono.Options" Version="$(MonoOptionsVersion)" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\external\xamarin-android-tools\src\Xamarin.Android.Tools.AndroidSdk\Xamarin.Android.Tools.AndroidSdk.csproj" />
+  </ItemGroup>
+
+</Project>