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 裝置。