用途:在 Mac 上启动 Android 屏幕镜像,实时显示安卓设备画面,并可选显示应用日志。属于原生 macOS 应用,使用 scrcpy 实现镜像,集成控制台用于查看实时应用日志,体验与 iPhone 屏幕捕捉统一。
主要能力:顶部工具栏加下方 scrcpy 的集成窗口;绿色“>”按钮可打开实时日志面板;点击窗口切换全屏/半屏;拖动工具栏移动窗口,scrcpy 跟随;通过 adb logcat 显示带 [APP] 前缀的应用日志。scrcpy 区域快捷键:⌘+f 切换全屏、⌘+r 旋转屏幕、⌘+g 调整为 1:1 像素级、⌘+c 复制设备剪贴板到电脑。截图命令:./screenshot.sh output_filename.png。读取日志命令:adb logcat -v brief -d | grep "[APP]" | tail -30。
使用方式:先确保通过 USB 连接 Android 设备、开启 USB 调试和开发者模式、设备已授权调试,并安装 scrcpy:brew install scrcpy,ADB:brew install android-platform-tools。然后进入目录 cd miso/platforms/android/development/screen-capture/imp 并运行 ./android_screencap.sh,应用会自动构建、检测设备、启动 scrcpy 并显示工具栏。关闭窗口或 Cmd+Q 退出。
适用场景:用户要求“启动 Android 屏幕捕捉”“查看 Android 屏幕”“镜像 Android 设备”或展示安卓手机时调用。
限制与常见问题:设备未找到时需检查 USB 调试、接受授权提示并用 adb devices 验证;scrcpy 不跟随拖动需在系统设置→隐私与安全性→辅助功能中授权;scrcpy 未安装需 brew install scrcpy;控制台无日志需确保应用使用带 [APP] 前缀的 Logger 且应用在设备上运行。文件包括 main.swift、build.sh、android_screencap.sh、screenshot.sh。具体收费、价格、平台支持等信息暂未提供。