From 2f3a4fbf4f1a0ba1c56564ff8f571c2b1e2ef77d Mon Sep 17 00:00:00 2001 From: dxcsmam Date: Wed, 26 Aug 2026 17:40:44 +0800 Subject: [PATCH] fix: require Android 11 for screenshot execution --- README.ja-JP.md | 4 ++-- README.md | 4 ++-- README.zh-CN.md | 4 ++-- client/app/build.gradle.kts | 4 ++-- docs/get-started.md | 4 ++++ skills/open-gui-bootstrap/SKILL.md | 1 + 6 files changed, 13 insertions(+), 8 deletions(-) diff --git a/README.ja-JP.md b/README.ja-JP.md index 5a991db..1ed07b9 100644 --- a/README.ja-JP.md +++ b/README.ja-JP.md @@ -40,7 +40,7 @@ Read ./skills/open-gui-bootstrap/SKILL.md and help me run OpenGUI. Only ask me f 必要なもの: -- Android スマートフォンまたはエミュレーター +- Android 11（API 30）以降のスマートフォンまたはエミュレーター - USB デバッグの有効化 - AccessibilityService の有効化 - 実際のタスク実行に使うモデル API キー @@ -131,7 +131,7 @@ OpenGUI は、明示的なオーケストレーションレイヤーを持つモ ## 現在の制限 -- Android 実機またはエミュレーターが必要です。 +- Android 11（API 30）以降の実機またはエミュレーターが必要です。 - USB デバッグと AccessibilityService 権限が必要です。 - 実行品質は、モデル、アプリ UI、ネットワーク状態、タスクの長さに依存します。 - 現時点では OS レベルの常駐アシスタントではありません。タスクは手動、または設定済みのディスパッチ経路から起動します。 diff --git a/README.md b/README.md index 4d47272..f0dce42 100644 --- a/README.md +++ b/README.md @@ -41,7 +41,7 @@ Read ./skills/open-gui-bootstrap/SKILL.md and help me run OpenGUI. Only ask me f You will need: -- an Android phone or emulator +- an Android 11 (API 30) or newer phone or emulator - USB debugging enabled - AccessibilityService enabled - model API keys for real task execution @@ -134,7 +134,7 @@ The source code currently exposes these pieces: ## Current Limitations -- Requires an Android device or emulator. +- Requires an Android 11 (API 30) or newer device or emulator. - Requires USB debugging and AccessibilityService permissions. - Execution quality depends on the model, app UI, network state, and task length. - Not an always-on OS-level assistant yet; tasks are currently triggered manually or through configured dispatch channels. diff --git a/README.zh-CN.md b/README.zh-CN.md index ffc7a2c..1b00c70 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -40,7 +40,7 @@ Read ./skills/open-gui-bootstrap/SKILL.md and help me run OpenGUI. Only ask me f 你需要准备： -- 一台 Android 手机或模拟器 +- 一台 Android 11（API 30）或更高版本的手机或模拟器 - 已开启 USB 调试 - 已开启 AccessibilityService - 用于真实任务执行的模型 API Key @@ -132,7 +132,7 @@ OpenGUI 采用的是一套分层清晰的移动 operator system。 ## 当前限制 -- 需要 Android 真机或模拟器。 +- 需要 Android 11（API 30）或更高版本的真机或模拟器。 - 需要开启 USB 调试和 AccessibilityService 权限。 - 执行质量会受到模型能力、App UI、网络状态和任务长度影响。 - 目前还不是 OS 级常驻助手；任务需要手动触发，或通过已配置的派发入口触发。 diff --git a/client/app/build.gradle.kts b/client/app/build.gradle.kts index 6d3e140..cb7a0f7 100644 --- a/client/app/build.gradle.kts +++ b/client/app/build.gradle.kts @@ -19,7 +19,7 @@ android { defaultConfig { applicationId = "com.coremate.opengui" - minSdk = 24 + minSdk = 30 targetSdk = 35 versionCode = 1000031701 versionName = "1.0.0317.01" @@ -108,4 +108,4 @@ dependencies { implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.8.4") implementation("androidx.core:core-splashscreen:1.2.0") -} \ No newline at end of file +} diff --git a/docs/get-started.md b/docs/get-started.md index 4260e49..cf136a4 100644 --- a/docs/get-started.md +++ b/docs/get-started.md @@ -66,6 +66,10 @@ Useful endpoints after startup: ### 2. Connect a device and install the Android client +The current Android client requires Android 11 (API 30) or newer. Android 9 +(API 28) and other older releases are not supported by the screenshot-based +execution path. The client currently targets Android 15 (API 35). + ```bash cd client ./start.sh diff --git a/skills/open-gui-bootstrap/SKILL.md b/skills/open-gui-bootstrap/SKILL.md index b20ab34..74f297f 100644 --- a/skills/open-gui-bootstrap/SKILL.md +++ b/skills/open-gui-bootstrap/SKILL.md @@ -158,6 +158,7 @@ Expected behavior: - checks `adb` and Java - verifies a device is connected +- installs only on Android 11 (API 30) or newer, matching the app's minimum SDK - runs `adb reverse tcp:7777 tcp:7777` - builds the debug APK - installs it