feat: add Stop-DeviceApp command

app-runner/Private/DeviceProviders/DeviceProvider.ps1

@@ -421,6 +421,20 @@ class DeviceProvider {
         }
     }
 
+    # Stops the application currently running on the device.
+    # Platforms that support this configure a 'stop-app' command; the rest log a warning.
+    [void] StopApplication() {
+        Write-Debug "$($this.Platform): Stopping application"
+
+        if (-not $this.Commands.ContainsKey('stop-app')) {
+            $this.LogNotImplemented('StopApplication')
+            return
+        }
+
+        # Not giving an argument stops whatever is in the foreground.
+        $this.InvokeCommand('stop-app', @(''))
+    }
+
     [void] TakeScreenshot([string]$OutputPath) {
         # If the output path includes a directory, split it up, otherwise use current directory
         $directory = Split-Path $OutputPath -Parent

app-runner/Private/DeviceProviders/MockDeviceProvider.ps1

@@ -29,6 +29,7 @@ class MockDeviceProvider : DeviceProvider {
             "reset"              = @("echo", "'Mock reset'")
             "getstatus"          = @("echo", "'Mock get status'")
             "launch"             = @("echo", "'Mock launch {0} {1}'")
+            "stop-app"           = @("echo", "'Mock stop app {0}'")
             "screenshot"         = @("echo", "'Mock screenshot'")
             # Target management commands for testing DetectAndSetDefaultTarget()
             "get-default-target" = @("echo", "'Mock get-default-target'")

app-runner/Private/DeviceProviders/SwitchProvider.ps1

@@ -49,6 +49,7 @@ class SwitchProvider : DeviceProvider {
             'detect-target'      = @($this.TargetControlTool, 'detect-target --json', { $input | ConvertFrom-Json })
             'register-target'    = @($this.TargetControlTool, 'register --target "{0}"')
             'launch'             = @($this.ApplicationRunnerTool, '"{0}" -- {1}')
+            'stop-app'           = @($this.TargetControlTool, 'terminate{0}')
             'screenshot'         = @($this.TargetControlTool, 'take-screenshot --directory "{0}" --file-name "{1}"')
             'test-internet'      = @($this.TargetControlTool, 'devmenu -- network confirm-internet-connection')
         }
@@ -142,6 +143,19 @@ class SwitchProvider : DeviceProvider {
         Start-Sleep -Seconds 3
     }
 
+    # Override StopApplication to pass --target when a target is specified.
+    #
+    # This is needed after a crash on Switch 2 (Ounce): the crashed process stays held in
+    # debug mode and keeps the network use request, which stops the devkit from uploading
+    # the crash report. Terminating it releases the request so Nintendo forwards the report.
+    [void] StopApplication() {
+        $targetArg = if (-not [string]::IsNullOrEmpty($this.Target)) { " --target $($this.Target)" } else { '' }
+
+        Write-Debug "$($this.Platform): Terminating application$targetArg"
+
+        $this.InvokeCommand('stop-app', @($targetArg))
+    }
+
     # Override TakeScreenshot to pass --target when a target is specified
     [void] TakeScreenshot([string]$OutputPath) {
         $directory = Split-Path $OutputPath -Parent

app-runner/Public/Stop-DeviceApp.ps1

@@ -0,0 +1,28 @@
+function Stop-DeviceApp {
+    <#
+    .SYNOPSIS
+    Stops the application running on the connected device.
+
+    .DESCRIPTION
+    Terminates the application currently running on the connected device, using the
+    current device session. Platforms that don't support this write a warning and return.
+
+    .EXAMPLE
+    Connect-Device -Platform Switch
+    Invoke-DeviceApp -ExecutablePath "Game.nsp" -Arguments "crash-capture"
+    Stop-DeviceApp
+
+    .EXAMPLE
+    # Terminating may fail if nothing is running - don't let that abort the caller.
+    try { Stop-DeviceApp } catch { Write-Warning "Failed to stop app: $_" }
+    #>
+    [CmdletBinding()]
+    param()
+
+    Assert-DeviceSession
+
+    Write-Debug "Stopping application on platform: $($script:CurrentSession.Platform)"
+
+    $provider = $script:CurrentSession.Provider
+    $provider.StopApplication()
+}

app-runner/README.md

@@ -136,6 +136,7 @@ Disconnect-Device
 
 ### App Execution
 - `Invoke-DeviceApp` - Install and run application (unified command)
+- `Stop-DeviceApp` - Terminate the application running on the device
 
 ### Device Lifecycle
 - `Start-Device` - Power on device

app-runner/SentryAppRunner.psd1

@@ -44,6 +44,7 @@
         'Restart-Device',
         'Start-Device',
         'Stop-Device',
+        'Stop-DeviceApp',
         'Test-DeviceConnection',
         'Test-DeviceInternetConnection'
     )

app-runner/SentryAppRunner.psm1

@@ -64,6 +64,7 @@ Export-ModuleMember -Function @(
     # Application Management
     'Install-DeviceApp',
     'Invoke-DeviceApp',
+    'Stop-DeviceApp',
 
     # Device Lifecycle
     'Start-Device',

app-runner/Tests/DeviceLifecycle.Tests.ps1

@@ -42,6 +42,18 @@ Context 'Stop-Device' {
     }
 }
 
+Context 'Stop-DeviceApp' {
+    It 'Should require device session' {
+        Disconnect-Device
+        { Stop-DeviceApp } | Should -Throw '*No active device session*'
+    }
+
+    It 'Should work with active session' {
+        Connect-Device -Platform 'Mock'
+        { Stop-DeviceApp } | Should -Not -Throw
+    }
+}
+
 Context 'Get-DeviceStatus' {
     It 'Should require device session' {
         Disconnect-Device

app-runner/Tests/ModuleImport.Tests.ps1

@@ -33,6 +33,7 @@ Context 'Module Loading' {
             'Test-DeviceConnection',
             'Test-DeviceInternetConnection',
             'Invoke-DeviceApp',
+            'Stop-DeviceApp',
 
             # Device Lifecycle
             'Start-Device',