Skip to content

Releases: yiyifred/Cloud-Phone

Cloud Phone Android v1.0.0

29 May 01:09
@yiyifred yiyifred
android-v1.0.0
e3a18b6

Choose a tag to compare

View all tags
Cloud Phone Android v1.0.0

Cloud Phone Android v1.0.0

首个正式标记的 Android 伴侣客户端版本，与 Cloud Phone Node 后端 + Web 控制台共用同一套会话与投屏 API。适合在局域网内用手机查看 ADB 设备画廊、配置 scrcpy 投屏参数，并全屏遥控已连接设备。

对应仓库提交： 基于 main 分支 v0.12.13 功能集（versionName 0.12.13）。

下载

文件 说明
cloud-phone-android-v1.0.0-debug.apk Debug 签名 APK，可直接安装（需允许安装未知来源）

生产环境建议使用自行签名的 Release 包；本 Release 附带的是便于快速体验的 Debug 构建。

系统要求

项目 要求
Android 版本 API 28+（Android 9 及以上）
网络 手机与运行 Cloud Phone 后端的机器处于同一局域网（或可达其 IP）
后端 已部署的 Cloud Phone Node 服务（默认端口 3000），且目标 Android 设备已通过 ADB 连接至后端主机
浏览器（可选） 在 PC 上用 Web 控制台管理文件/应用/终端时，需 Chromium + WebCodecs

快速开始

  1. 在 PC 上启动 Cloud Phone 后端（见仓库根目录 npm run dev 或生产部署说明）。
  2. 确保调试机已被后端 ADB 识别（USB 或无线调试）。
  3. 安装本 Release 中的 APK。
  4. 首次打开：填写服务器地址（默认可用网关 x.x.x.1）与端口 3000，保存并连接。
  5. 使用默认密码 admin 登录后请立即修改密码（与 Web 一致）。
  6. 底部 设备 Tab 查看画廊；点设备进入工作区配置参数，点 开始 进入横屏全屏投屏。

功能概览

连接与认证

  • 服务器在线检测、首次改密、单密码登录（无用户名）
  • 登录密码 EncryptedSharedPreferences 本地加密保存，下次自动登录
  • 与 Web 相同的 会话 Cookie + API AES-GCM 加密通道

设备画廊

  • 横向设备卡片：型号、在线状态、实时截图
  • 设备列表 / 截图 可配置刷新间隔（设置 → 刷新，1–120 秒，默认 1s / 5s）
  • 下拉手动刷新；更新截图时保留上一帧，减少闪烁
  • 添加设备：USB 引导、无线配对码、二维码配对（对齐 Web）

设置（与 Web Settings 对齐）

分区 功能
账号 密码状态、会话到期时间、修改密码、退出登录
外观 界面语言偏好（zh-CN / en-US / zh-TW / ja-JP / ko-KR）、浅色/深色主题（Material3 DayNight）
刷新 设备列表与截图轮询间隔
服务器 显示当前 host:port，支持更换服务器并重新登录

设备工作区 · 投屏参数

  • 镜像 / 摄像头（Android 12+）两种模式
  • 多标签表单，结构对齐 Web 工作区左侧面板，按设备序列号持久化：
    • 镜像：视频、音频、设备、屏幕（虚拟屏预设 Desktop/Mac/iPad 等、__main__/__custom__、DPI 建议、start_app 包名）
    • 摄像头：摄像头、视频、音频（audioCode、缓冲参数等，流 extra 与 Web 一致）

全屏投屏

  • POST /api/devices/:serial/cast/start + WebSocket H.264 流
  • MediaCodec 硬件解码，画布 letterbox + 预览旋转
  • 镜像工具栏：多任务、主屏、返回、电源、音量、旋转、停止；画布触控注入（scrcpy 控制协议）
  • 摄像头工具栏：手电筒、缩小、放大、停止（画布不注入触控）
  • 顶/底栏约 3.5s 自动隐藏，点击画面切换；进入退出淡入淡出动画
  • 流参数（codecOptions、虚拟屏、audioDup 最低 SDK 33+ 等）与 Web/桌面端同一套规则

与 Web 的能力对照

能力 Web Android v1
设备画廊 / 截图轮询 ✅ ✅
设置（账号/外观/刷新） ✅ ✅
添加设备（USB/配对/二维码） ✅ ✅
投屏参数工作区 ✅ ✅
全屏投屏 + 触控/工具栏 ✅ ✅
文件管理 ✅ —
应用管理 ✅ —
ADB 终端 ✅ —
剪贴板 / 录屏 / 浏览器截屏下载 ✅ —

技术说明

  • 源码路径： frontend/android/
  • UI： Material Design 3、Community Material 图标（Android-Iconics）
  • 网络： OkHttp + 会话 Cookie；WebSocket 投屏与控制
  • 本地存储： SharedPreferences（服务器、刷新间隔、主题、语言）；加密存储会话密钥与密码
  • 构建： Gradle，minSdk 28，compileSdk 36

自行编译：

cd frontend/android
./gradlew :app:assembleDebug

已知限制

  • 仅支持连接 自建 Cloud Phone 后端，非独立云手机 SaaS。
  • 局域网 HTTP 明文（开发配置 network_security_config）；生产建议在可信网络使用或自行加固。
  • 界面文案以简体中文为主；语言偏好已保存，完整多语言资源将陆续补充。
  • Debug APK 使用调试签名，不可直接覆盖安装已签名的 Release 包（若后续提供）。

致谢

投屏能力基于 scrcpy 4.0 魔改 server 与 ws-scrcpy 协议思路，与 Web 端共用后端。

完整变更记录见仓库 CHANGELOG.md。

Loading

Android v0.12.14

30 May 02:49
@yiyifred yiyifred
android-v0.12.14
344a3e4

Choose a tag to compare

View all tags
Android v0.12.14 Latest
Latest

Android v0.12.14

  • 全屏投屏：工具箱底部常驻并支持折叠/展开；画布 letterbox 对齐 Web（长边贴长边，尽量减少黑边）
  • 修复旋转/横竖屏切换后的触摸坐标映射
  • 解码器读取 MediaCodec crop，使用实际视频帧尺寸更新触控/布局

安装

下载附件 \�pp-debug.apk\ 安装即可（需允许未知来源）。

Assets 3
Loading