# CloudPhoneApp

**Repository Path**: qs0010/cloudphoneapp

## Basic Information

- **Project Name**: CloudPhoneApp
- **Description**: 为cloudphone打包的apk
- **Primary Language**: Android
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-20
- **Last Updated**: 2026-04-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# CloudPhoneApp

云手机 WebView 应用 - 一个基于 Android WebView 的云手机应用客户端

## 项目简介

CloudPhoneApp 是一个 Android 原生应用程序，通过 WebView 组件封装云手机服务的 Web 端界面，为用户提供移动端的云手机体验服务。

## 主要功能

- **WebView 内核**：内置 Chrome WebView，提供原生网页浏览体验
- **全屏模式**：支持沉浸式全屏显示，隐藏系统状态栏
- **文件上传支持**：支持从相册选择图片或直接调用相机拍照上传
- **JavaScript 交互**：通过 WebAppInterface 实现 JavaScript 与原生 Android 代码的交互
- **返回键处理**：自定义返回键逻辑，支持在网页内返回上一页
- **错误处理**：内置网络错误提示页面，支持重新加载
- **主页快捷键**：提供返回主页的快捷按钮

## 技术特性

- Android 原生开发
- 使用 AndroidX 组件
- AppCompatActivity 作为主Activity
- WebView 高级配置

## 快速开始

### 环境要求

- Android Studio 版本要求
- 最低 SDK 版本：21 (Android 5.0)
- 目标 SDK 版本：34
- JDK 11 或更高版本
- Android SDK（包含 platform-tools、platforms;android-34 和 build-tools;34.0.0）

### 编译运行

1. 克隆项目到本地
2. 使用 Android Studio 打开项目
3. 等待 Gradle 同步完成
4. 连接 Android 设备或启动模拟器
5. 点击 Run 运行项目

### 构建 APK

#### 构建调试版本

```bash
./gradlew assembleDebug
```

构建完成后，APK 文件位于：
`app/build/outputs/apk/debug/app-debug.apk`

#### 构建生产版本（使用自签名）

1. **安装必要依赖**

   ```bash
   # 安装 git 和 JDK
   apt-get update && apt-get install -y git openjdk-21-jdk
   
   # 安装 Android SDK 命令行工具
   wget https://dl.google.com/android/repository/commandlinetools-linux-11076708_latest.zip
   unzip commandlinetools-linux-11076708_latest.zip -d android-sdk
   rm commandlinetools-linux-11076708_latest.zip
   mkdir -p android-sdk/cmdline-tools/latest
   mv android-sdk/cmdline-tools/cmdline-tools/* android-sdk/cmdline-tools/latest/
   rmdir android-sdk/cmdline-tools/cmdline-tools
   
   # 配置环境变量
   export ANDROID_HOME=$(pwd)/android-sdk
   export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools
   
   # 接受 SDK 许可证并安装必要组件
   yes | sdkmanager --licenses
   sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"
   ```

2. **生成自签名密钥库**

   ```bash
   cd app
   keytool -genkey -v -keystore my-release-key.keystore -alias cloudphoneapp -keyalg RSA -keysize 2048 -validity 10000 -dname "CN=cloudphoneapp, OU=cloudphone, O=cloudphone, L=Beijing, ST=Beijing, C=CN" -storepass password123 -keypass password123
   cd ..
   ```

3. **构建生产版本**

   ```bash
   ./gradlew assembleRelease
   ```

4. **构建结果**

   构建完成后，APK 文件位于：
   `app/build/outputs/apk/release/app-release.apk`

## 项目结构

```
app/
├── src/main/
│   ├── java/com/cloudphone/app/
│   │   └── MainActivity.java      # 主界面逻辑
│   ├── res/
│   │   ├── layout/                # 布局文件
│   │   ├── drawable/              # 图片资源
│   │   ├── values/                # 字符串/颜色/主题
│   │   └── xml/                   # 备份规则
│   └── AndroidManifest.xml       # 应用清单
└── build.gradle                  # 应用级构建脚本
```

## 使用说明

1. 应用启动后自动加载配置的云手机服务 URL
2. 点击右上角刷新按钮可重新加载当前页面
3. 点击主页按钮可返回云手机服务首页
4. 如遇网络错误，显示错误提示页面，点击重试按钮重新加载
5. 支持网页内的图片上传和相机拍照功能

## 许可证

本项目仅供学习和交流使用。