Skip to content

Wake device before launching Android apps #12322

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jonathanpeppers wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Wake device before launching Android apps #12322

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8f9a426
Wake device before launching Android apps
jonathanpeppers Aug 7, 2026
9054ae8
Keep app launch independent of device prep
jonathanpeppers Aug 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 7 additions & 1 deletion src/Microsoft.Android.Run/Program.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@
string? deviceUserId = null;
string? instrumentation = null;
bool verbose = false;
bool wakeDevice = true;
int? logcatPid = null;
Process? logcatProcess = null;
CancellationTokenSource cts = new ();
Expand Down Expand Up @@ -72,6 +73,9 @@ async Task<int> RunAsync (string[] args)
{ "v|verbose",
"Enable verbose output for debugging.",
v => verbose = v != null },
{ "no-wake-device",
"Do not wake the device or dismiss its keyguard before launching the application.",
v => wakeDevice = v == null },
{ "logcat-args=",
"Extra {ARGUMENTS} to pass to 'adb logcat' (e.g., 'monodroid-assembly:S' to silence a tag).",
v => logcatArgs = v },
Expand Down Expand Up @@ -515,7 +519,9 @@ async Task<int> RunAppAsync ()
async Task<bool> StartAppAsync ()
{
var userArg = string.IsNullOrEmpty (deviceUserId) ? "" : $" --user {deviceUserId}";
var cmdArgs = $"shell am start -S -W{userArg} -n \"{package}/{activity}\"";
// Device preparation is best effort; am start must run and determine the shell exit code.
var wakeDeviceCommand = wakeDevice ? "input keyevent KEYCODE_WAKEUP; wm dismiss-keyguard; " : "";
var cmdArgs = $"shell {wakeDeviceCommand}am start -S -W{userArg} -n \"{package}/{activity}\"";
Comment thread
jonathanpeppers marked this conversation as resolved.
var (exitCode, output, error) = await AdbHelper.RunAsync (adbPath, adbTarget, cmdArgs, cts.Token, verbose);
if (exitCode != 0) {
Console.Error.WriteLine ($"Error: Failed to start app: {error}");
Expand Down
20 changes: 16 additions & 4 deletions tests/MSBuildDeviceIntegration/Tests/InstallAndRunTests.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -341,14 +341,15 @@ static int InvokeIntMethod (Java.Lang.Object instance, string methodName)
Assert.True (builder.Uninstall (proj), "Project should have uninstalled.");
}

[Test]
public void DotNetRunWaitForExit ()
[TestCase ("", true)]
[TestCase ("--no-wake-device", false)]
public void DotNetRunWaitForExit (string extraArgs, bool shouldWakeDevice)
{
const string logcatMessage = "DOTNET_RUN_TEST_MESSAGE_12345";
var proj = new XamarinAndroidApplicationProject ();

// Enable verbose output from Microsoft.Android.Run for debugging
proj.SetProperty ("_AndroidRunExtraArgs", "--verbose");
proj.SetProperty ("_AndroidRunExtraArgs", $"--verbose {extraArgs}");

// Add a Console.WriteLine that will appear in logcat
proj.MainActivity = proj.DefaultMainActivity.Replace (
Expand Down Expand Up @@ -401,10 +402,21 @@ public void DotNetRunWaitForExit ()
}

// Write the output to a log file for debugging
string logPath = Path.Combine (Root, builder.ProjectDirectory, "dotnet-run-output.log");
string logPath = Path.Combine (Root, builder.ProjectDirectory, $"dotnet-run-output-wake-{shouldWakeDevice}.log");
File.WriteAllText (logPath, output.ToString ());
TestContext.AddTestAttachment (logPath);

if (shouldWakeDevice) {
StringAssert.Contains ("shell input keyevent KEYCODE_WAKEUP; wm dismiss-keyguard; am start", output.ToString (),
$"`dotnet run` should wake the device and dismiss its keyguard in the same adb shell command used to start the app. See {logPath} for details.");
} else {
StringAssert.Contains ("shell am start", output.ToString (),
$"`dotnet run` should start the app without waking the device or dismissing its keyguard when --no-wake-device is specified. See {logPath} for details.");
StringAssert.DoesNotContain ("KEYCODE_WAKEUP", output.ToString (),
$"`dotnet run` should not wake the device when --no-wake-device is specified. See {logPath} for details.");
StringAssert.DoesNotContain ("dismiss-keyguard", output.ToString (),
$"`dotnet run` should not dismiss the keyguard when --no-wake-device is specified. See {logPath} for details.");
}
Assert.IsTrue (foundMessage, $"Expected message '{logcatMessage}' was not found in output. See {logPath} for details.");
}

Expand Down