首页

Screen Remote for macOS

English

Screen Remote for macOS 是用于从 macOS 控制和管理 Android 设备的原生 SwiftUI 应用。本 Wiki 是 macOS 使用说明、架构和维护资料的中英双语权威入口。

当前产品边界

• 应用已具备设备发现、持久化设备分组、基于 ADB 的应用/文件/进程/端口转发/设备信息、工具、虚拟设备、设置、诊断和多屏 UI。
• 主屏幕会话使用应用自有的原生 scrcpy 4.1 链路：官方 server、顺序 socket、通过 VideoToolbox 的 H264/H265 解码和 SwiftUI 画面。
• OPUS、AAC 和 FLAC 音频可通过 Core Audio 解码，并支持 RAW 回退与播放。指针触控消息已通过 control socket 路由；其他 control message 类型仍未完整实现。
• 通知、消息和照片目前仅有 UI/空状态；需要伴侣端或协议数据通道后才能成为可用功能。

产品术语

• 小窗：显示在 Screens 工作区中的屏幕会话。
• 大窗：从 Screens 中放大后显示的同一屏幕会话。
• 辅助菜单：围绕小窗或大窗按需显示的功能控件与会话操作。

产品文档和面向用户的说明统一使用上述名称。“嵌入式”“分离式”“独立窗口”“窗口装饰”“工具栏”或“控制栏”等名称仅在解释具体实现细节时使用。

阅读路径

• 项目架构：当前代码、当前限制和目标模块设计。
• 目录与模块边界：当前平铺 Xcode 源码 Group 的迁移图。
• ADB 与 dadb：helper 与可复用设备操作的边界。
• 原生 scrcpy 会话：server、socket、解码器与未完成链路的事实。
• UI 设计系统、本地化 和 macOS 兼容性：全局实现规则。
• 构建与发布、诊断与日志 和 第三方项目与许可证：运维维护资料。

文档规则

每个被维护的英文页面都必须有章节和事实一致的简体中文页面。以当前源码、Xcode 配置和仓库 AGENTS.md 为技术事实源；不得把目标目录架构或计划中的协议功能写成已实现功能。