<# .SYNOPSIS AndroidStation 设备端真机调试脚手架:构建 / 装机 / 启动 / 抓日志。 .DESCRIPTION 约定:薄入口 + 厚实现。所有逻辑都在本脚本里,.vscode/tasks.json 与命令行只做转发。 已内置处理(都是本机 / 本设备实际踩过的坑): - JAVA_HOME 自动探测(本机 java 不在 PATH) - adb 自动探测(不在 PATH) - 多设备自动记住上次选择(.dev-adb.local.json,不入库) - adb install 失败自动降级为 push + pm install(老盒子报 fork failed) - 启动依次尝试 am start / am start(LEANBACK) / monkey,全失败时明确提示手动启动 - logcat 只跟随本应用 tag,并附带 AndroidRuntime:E 以便看到崩溃 - 设备端只建 UDP/TCP socket,普通装 /data 即可,不需要系统应用权限 .EXAMPLE powershell -NoProfile -ExecutionPolicy Bypass -File tools\android.ps1 dev .EXAMPLE powershell -NoProfile -ExecutionPolicy Bypass -File tools\android.ps1 install -Serial 4235737 #> [CmdletBinding()] param( [Parameter(Position = 0)] [ValidateSet('build', 'install', 'run', 'dev', 'logs', 'clean', 'devices', 'help')] [string]$Task = 'help', [ValidateSet('debug', 'release')] [string]$Variant = 'debug', [string]$Serial = '', [switch]$CleanFirst, [switch]$NoLaunch, [switch]$NoLogcat ) $ErrorActionPreference = 'Stop' # ============================ 常量 ============================ $ProjectRoot = Split-Path -Parent $PSScriptRoot $PackageName = 'com.gztbyc.scancenter' $ActivityName = "$PackageName/.MainActivity" $LogTag = 'AndroidStation' $StateFile = Join-Path $ProjectRoot '.dev-adb.local.json' $LocalProps = Join-Path $ProjectRoot 'local.properties' # ============================ 输出 ============================ function Write-Step([string]$Message) { Write-Host "[android] $Message" -ForegroundColor Cyan } function Write-Ok([string]$Message) { Write-Host "[android] OK $Message" -ForegroundColor Green } function Write-Warn([string]$Message) { Write-Host "[android] !! $Message" -ForegroundColor Yellow } # ============================ 外部命令封装 ============================ # 统一调用外部程序:不因 stderr 输出而抛异常,并返回退出码与合并后的文本 function Invoke-Native { param( [Parameter(Mandatory = $true)][string]$FilePath, [string[]]$Arguments = @(), [switch]$Quiet ) $previous = $ErrorActionPreference $ErrorActionPreference = 'Continue' try { if ($Quiet) { $output = & $FilePath @Arguments 2>&1 $text = ($output | Out-String) return [pscustomobject]@{ ExitCode = $LASTEXITCODE; Output = $text } } & $FilePath @Arguments return [pscustomobject]@{ ExitCode = $LASTEXITCODE; Output = '' } } finally { $ErrorActionPreference = $previous } } # ============================ 环境探测 ============================ function Resolve-JavaHome { if ($env:JAVA_HOME) { if (Test-Path (Join-Path $env:JAVA_HOME 'bin\java.exe')) { return $env:JAVA_HOME } } $roots = @() if ($env:LOCALAPPDATA) { $roots += (Join-Path $env:LOCALAPPDATA 'Programs\EclipseAdoptium') } $roots += 'C:\Program Files\Eclipse Adoptium' $roots += 'C:\Program Files\Java' foreach ($root in $roots) { if (-not (Test-Path $root)) { continue } $jdk = Get-ChildItem -Path $root -Directory -ErrorAction SilentlyContinue | Where-Object { Test-Path (Join-Path $_.FullName 'bin\java.exe') } | Sort-Object Name -Descending | Select-Object -First 1 if ($jdk) { return $jdk.FullName } } return '' } function Resolve-SdkDir { if (Test-Path $LocalProps) { $match = Select-String -Path $LocalProps -Pattern '^\s*sdk\.dir\s*=' -ErrorAction SilentlyContinue | Select-Object -First 1 if ($match) { # local.properties 里的 Windows 路径是转义写法(C\:\\Users\\...),需要还原 return ($match.Line -split '=', 2)[1].Trim().Replace('\:', ':').Replace('\\', '\') } } if ($env:ANDROID_HOME) { return $env:ANDROID_HOME } if ($env:ANDROID_SDK_ROOT) { return $env:ANDROID_SDK_ROOT } if ($env:LOCALAPPDATA) { return (Join-Path $env:LOCALAPPDATA 'Android\Sdk') } return '' } function Resolve-Adb { $candidates = @() $sdk = Resolve-SdkDir if ($sdk) { $candidates += (Join-Path $sdk 'platform-tools\adb.exe') } if ($env:LOCALAPPDATA) { $candidates += (Join-Path $env:LOCALAPPDATA 'Android\Sdk\platform-tools\adb.exe') } foreach ($candidate in $candidates) { if (Test-Path $candidate) { return $candidate } } # 退回 PATH $onPath = Get-Command adb.exe -ErrorAction SilentlyContinue if ($onPath) { return $onPath.Source } throw '未找到 adb.exe,请确认 Android SDK platform-tools 已安装' } $Adb = $null function Get-Adb { if (-not $script:Adb) { $script:Adb = Resolve-Adb } return $script:Adb } # ============================ 设备选择(含记忆) ============================ function Get-ConnectedDevices { $adb = Get-Adb $result = Invoke-Native $adb @('devices', '-l') -Quiet $devices = @() $abnormal = @() foreach ($line in ($result.Output -split "`r?`n")) { if ($line -match '^(\S+)\s+(device|unauthorized|offline|no permissions)\b\s*(.*)$') { if ($Matches[2] -eq 'device') { $devices += [pscustomobject]@{ Serial = $Matches[1]; Desc = $Matches[3].Trim() } } else { $abnormal += "$($Matches[1]) [$($Matches[2])]" } } } if ($abnormal.Count -gt 0) { Write-Warn ("下列设备状态异常:" + ($abnormal -join ',')) } return $devices } function Read-SavedSerial { if (-not (Test-Path $StateFile)) { return '' } try { return (Get-Content $StateFile -Raw | ConvertFrom-Json).serial } catch { return '' } } function Save-Serial([string]$Value) { $json = "{`r`n `"serial`": `"$Value`"`r`n}`r`n" try { # 不写 BOM,避免其它工具解析 JSON 出错 [System.IO.File]::WriteAllText($StateFile, $json, (New-Object System.Text.UTF8Encoding($false))) } catch { # 写入失败不影响主流程 } } function Select-Device { if ($Serial) { Save-Serial $Serial return $Serial } $devices = @(Get-ConnectedDevices) if ($devices.Count -eq 0) { throw '未检测到已连接设备。请检查 USB / 无线调试,或执行 adb devices 确认。' } $saved = Read-SavedSerial if ($saved) { foreach ($device in $devices) { if ($device.Serial -eq $saved) { Write-Step "使用上次选择的设备:$($device.Serial) $($device.Desc)(可用 -Serial 更换)" return $device.Serial } } } if ($devices.Count -eq 1) { Save-Serial $devices[0].Serial Write-Step "使用设备:$($devices[0].Serial) $($devices[0].Desc)" return $devices[0].Serial } Write-Host '[android] 检测到多台设备:' -ForegroundColor Cyan for ($i = 0; $i -lt $devices.Count; $i++) { Write-Host (" [{0}] {1} {2}" -f ($i + 1), $devices[$i].Serial, $devices[$i].Desc) } if (-not $Host.Name -or [Console]::IsInputRedirected) { throw "多台设备时请用 -Serial 指定,例如:-Serial $($devices[0].Serial)" } $answer = Read-Host "请选择设备序号 [1-$($devices.Count)],直接回车取 1" $index = 0 if ($answer) { $index = [int]$answer - 1 } if ($index -lt 0 -or $index -ge $devices.Count) { throw "无效序号:$answer" } Save-Serial $devices[$index].Serial return $devices[$index].Serial } # ============================ 构建 ============================ function Invoke-Gradle { param([string[]]$Arguments) $javaHome = Resolve-JavaHome if ($javaHome) { $env:JAVA_HOME = $javaHome Write-Step "JAVA_HOME = $javaHome" } else { Write-Warn '未探测到 JDK,若构建失败请手动设置 JAVA_HOME' } $gradlew = Join-Path $ProjectRoot 'gradlew.bat' if (-not (Test-Path $gradlew)) { throw "未找到 gradlew.bat:$gradlew" } Write-Step ("gradlew " + ($Arguments -join ' ')) $result = Invoke-Native $gradlew $Arguments if ($result.ExitCode -ne 0) { throw "构建失败(gradlew 退出码 $($result.ExitCode))" } } function Get-ApkPath { $dir = Join-Path $ProjectRoot "app\build\outputs\apk\$Variant" $expected = Join-Path $dir "app-$Variant.apk" if (Test-Path $expected) { return $expected } if (Test-Path $dir) { $latest = Get-ChildItem -Path $dir -Filter '*.apk' -ErrorAction SilentlyContinue | Sort-Object LastWriteTime -Descending | Select-Object -First 1 if ($latest) { return $latest.FullName } } throw "未找到 APK:$expected" } function Invoke-Build { if ($CleanFirst) { Invoke-Gradle @('clean', '--console=plain') } $variantCap = $Variant.Substring(0, 1).ToUpper() + $Variant.Substring(1) Invoke-Gradle @(":app:assemble$variantCap", '--console=plain') $apk = Get-ApkPath $size = [math]::Round((Get-Item $apk).Length / 1MB, 2) Write-Ok "APK = $apk ($size MB)" return $apk } # ============================ 装机 ============================ function Install-Apk { param([string]$TargetSerial, [string]$Apk) $adb = Get-Adb for ($attempt = 1; $attempt -le 3; $attempt++) { Write-Step "adb install -r(第 $attempt/3 次)" $result = Invoke-Native $adb @('-s', $TargetSerial, 'install', '-r', $Apk) -Quiet Write-Host $result.Output.TrimEnd() if ($result.ExitCode -eq 0) { Write-Ok '安装成功' return } if ($attempt -lt 3) { Start-Sleep -Seconds 2 } } # 老盒子(Android 7.1.2 等)的流式安装常报 fork failed,改用两段式 Write-Warn 'adb install 连续失败,降级为 push + pm install' $remote = '/data/local/tmp/' + [System.IO.Path]::GetFileName($Apk) $push = Invoke-Native $adb @('-s', $TargetSerial, 'push', $Apk, $remote) -Quiet Write-Host $push.Output.TrimEnd() if ($push.ExitCode -ne 0) { throw '推送到设备失败' } $install = Invoke-Native $adb @('-s', $TargetSerial, 'shell', 'pm', 'install', '-r', $remote) -Quiet Write-Host $install.Output.TrimEnd() Invoke-Native $adb @('-s', $TargetSerial, 'shell', 'rm', '-f', $remote) -Quiet | Out-Null if ($install.Output -notmatch 'Success') { throw 'pm install 失败,请查看上方设备输出' } Write-Ok '安装成功(push + pm install)' } # ============================ 预置成系统应用 ============================ # ============================ 启动 ============================ function Start-App { param([string]$TargetSerial) $adb = Get-Adb Invoke-Native $adb @('-s', $TargetSerial, 'shell', 'am', 'force-stop', $PackageName) -Quiet | Out-Null $attempts = @( [pscustomobject]@{ Name = 'am start -n' Args = @('-s', $TargetSerial, 'shell', 'am', 'start', '-n', $ActivityName) Expect = 'Starting:' }, [pscustomobject]@{ Name = 'am start (LEANBACK)' Args = @('-s', $TargetSerial, 'shell', 'am', 'start', '-a', 'android.intent.action.MAIN', '-c', 'android.intent.category.LEANBACK_LAUNCHER', '-n', $ActivityName) Expect = 'Starting:' }, [pscustomobject]@{ Name = 'monkey' Args = @('-s', $TargetSerial, 'shell', 'monkey', '-p', $PackageName, '-c', 'android.intent.category.LAUNCHER', '1') Expect = 'Events injected' } ) foreach ($attempt in $attempts) { $result = Invoke-Native $adb $attempt.Args -Quiet if ($result.ExitCode -eq 0 -and $result.Output -match [regex]::Escape($attempt.Expect)) { Write-Ok "已启动应用($($attempt.Name))" return $true } $firstLine = ($result.Output -split "`r?`n" | Where-Object { $_.Trim() } | Select-Object -First 1) Write-Warn "$($attempt.Name) 未成功:$firstLine" } Write-Warn '自动启动失败。部分海思/定制固件的 am 与 monkey 都会报 AMS 空指针,' Write-Warn '本机无法绕过,请用遥控器手动打开「扫描中心」。' return $false } # ============================ 日志 ============================ function Start-Logcat { param([string]$TargetSerial) $adb = Get-Adb Invoke-Native $adb @('-s', $TargetSerial, 'logcat', '-c') -Quiet | Out-Null Write-Step "跟随日志中(tag=$LogTag,含崩溃栈),Ctrl+C 退出" Write-Host ("[android] 单独抓取:`"$adb`" -s $TargetSerial logcat -v time $LogTag`:V AndroidRuntime:E `*:S") -ForegroundColor DarkGray $previous = $ErrorActionPreference $ErrorActionPreference = 'Continue' try { & $adb -s $TargetSerial logcat -v time "$($LogTag):V" 'AndroidRuntime:E' '*:S' } finally { $ErrorActionPreference = $previous } } # ============================ 帮助 ============================ function Show-Help { Write-Host @' AndroidStation 设备端真机调试脚手架 用法: powershell -NoProfile -ExecutionPolicy Bypass -File tools\android.ps1 <任务> [选项] 任务: build 仅构建 APK install 构建 + 安装 run 构建 + 安装 + 启动 dev 构建 + 安装 + 启动 + 跟随日志(日常开发用这个) logs 只跟随日志(不构建) clean 清理构建产物 devices 列出已连接设备与当前记住的设备 help 显示本帮助 选项: -Variant debug|release 构建类型,默认 debug -Serial <序列号> 指定设备(默认自动选择,多设备时记住上次选择) -CleanFirst 构建前先执行 gradle clean(全量重编) -NoLaunch 不自动启动应用 -NoLogcat 不跟随日志 示例: ... -File tools\android.ps1 dev ... -File tools\android.ps1 install -Serial 4235737 ... -File tools\android.ps1 dev -CleanFirst ... -File tools\android.ps1 run -Variant release '@ } function Show-Devices { $devices = @(Get-ConnectedDevices) $saved = Read-SavedSerial if ($devices.Count -eq 0) { Write-Warn '未检测到已连接设备' return } Write-Host '[android] 已连接设备:' -ForegroundColor Cyan foreach ($device in $devices) { $mark = '' if ($saved -and $device.Serial -eq $saved) { $mark = ' <- 当前记住' } Write-Host (" {0} {1}{2}" -f $device.Serial, $device.Desc, $mark) } } # ============================ 主流程 ============================ Set-Location $ProjectRoot try { switch ($Task) { 'help' { Show-Help } 'devices' { Show-Devices } 'clean' { Invoke-Gradle @('clean', '--console=plain') Write-Ok '已清理' } 'build' { $apk = Invoke-Build # 单独输出一遍路径到管道,便于其它脚本捕获 Write-Output $apk } 'install' { $apk = Invoke-Build Install-Apk -TargetSerial (Select-Device) -Apk $apk } 'run' { $apk = Invoke-Build $target = Select-Device Install-Apk -TargetSerial $target -Apk $apk if (-not $NoLaunch) { Start-App -TargetSerial $target | Out-Null } if (-not $NoLogcat) { Start-Logcat -TargetSerial $target } } 'dev' { $apk = Invoke-Build $target = Select-Device Install-Apk -TargetSerial $target -Apk $apk if (-not $NoLaunch) { Start-App -TargetSerial $target | Out-Null } if (-not $NoLogcat) { Start-Logcat -TargetSerial $target } else { Write-Ok '完成(-NoLogcat 未跟随日志)' } } 'logs' { Start-Logcat -TargetSerial (Select-Device) } } } catch { Write-Host "[android] 失败:$($_.Exception.Message)" -ForegroundColor Red exit 1 }