android-screen-capture

android-screen-capture 工具为开发者与测试工程师提供了一个流畅的界面，将 Android 设备屏幕直接镜像到 macOS 环境中。通过利用高效能的 scrcpy 工具，此技能建立了一个无边框的交互窗口，能实时反映设备屏幕画面。其设计旨在弥合实体硬件与桌面开发流程之间的鸿沟，为监控应用程序行为、调试 UI 布局以及测试用户交互提供了无缝的体验。

除了基本的镜像功能外，此代理还包含自定义的整合式控制台功能。点击工具栏中的绿色按钮，用户即可访问一个实时日志面板，该面板通过 adb logcat 撷取特定应用程序的事件。这让开发者能够立即将视觉画面变化与后台系统日志相互关联，显著减少除错过程中的环境切换。该工具具备高度可设定性，支持旋转、调整大小与剪贴板同步的快捷键，成为移动开发任务中强大的辅助工具。

• 通过 scrcpy 进行低延迟的实时 Android 屏幕镜像。

• 整合式实时控制台，用于检视由自定义前缀过滤的应用程序日志。

• 桌面原生窗口控制，包括可拖曳工具栏与点击调整大小功能。

• 支持进阶快捷键：⌘+f 全屏、⌘+r 屏幕旋转、⌘+g 像素对齐缩放、⌘+c 剪贴板共享。

• 原生截图功能，可撷取设备状态以供文件说明或错误报告使用。

• 统一的 macOS 界面，简化了标准 scrcpy 命令行操作。

• 使用前请确保 Android 设备已启用 USB 除错与开发者选项。

• 需要通过 Homebrew 安装 scrcpy 与 android-platform-tools。

• 使用提供的 Shell 脚本 (android_screencap.sh, screenshot.sh) 以确保执行一致性。

• Logcat 功能依赖于应用程序输出带有 [APP] 前缀的日志以进行最佳化过滤。

• 若镜像窗口无法随拖曳移动，请在系统设置中授予辅助使用权限。

• 适用于任何通过 ADB 授权的 USB 连接 Android 设备。