From 006c598f14fa1eeaabe96134366ba85507eac1b2 Mon Sep 17 00:00:00 2001
From: RainySY <chenaidairong@outlook.com>
Date: Tue, 7 Apr 2026 14:46:51 +0800
Subject: [PATCH] init: Android backup GUI project

---
 .github/copilot-instructions.md | 15 +++++++++++
 README.md                       | 23 +++++++++++++++++
 app/AndroidManifest.xml         | 20 +++++++++++++++
 app/MainActivity.kt             | 44 +++++++++++++++++++++++++++++++++
 app/activity_main.xml           | 29 ++++++++++++++++++++++
 app/build.gradle                | 27 ++++++++++++++++++++
 build.gradle                    | 23 +++++++++++++++++
 scripts/README.md               |  2 ++
 settings.gradle                 |  2 ++
 9 files changed, 185 insertions(+)
 create mode 100644 .github/copilot-instructions.md
 create mode 100644 README.md
 create mode 100644 app/AndroidManifest.xml
 create mode 100644 app/MainActivity.kt
 create mode 100644 app/activity_main.xml
 create mode 100644 app/build.gradle
 create mode 100644 build.gradle
 create mode 100644 scripts/README.md
 create mode 100644 settings.gradle

diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
new file mode 100644
index 0000000..c640e20
--- /dev/null
+++ b/.github/copilot-instructions.md
@@ -0,0 +1,15 @@
+- [ ] Clarify Project Requirements
+- [x] Scaffold the Project
+- [ ] Customize the Project
+- [ ] Install Required Extensions
+- [ ] Compile the Project
+- [ ] Create and Run Task
+- [ ] Launch the Project
+- [ ] Ensure Documentation is Complete
+
+# 项目说明
+本项目为 backup_script 脚本提供 Android 图形化操作界面，支持本地运行脚本、参数配置、结果展示。
+
+## 进度说明
+- 已完成项目结构搭建与主要文件生成。
+- 下一步将完善脚本调用、参数配置与界面交互细节。
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..16aa2d9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# Android Backup GUI
+
+本项目为 backup_script 脚本提供 Android 图形化操作界面，支持本地运行脚本、参数配置、结果展示。
+
+## 功能规划
+- 通过界面选择/配置脚本参数
+- 一键执行 backup_script/tools.sh
+- 显示执行日志和结果
+
+## 技术栈
+- Kotlin
+- Android Studio 项目结构
+
+## 目录结构
+- app/ 主要 Android 源码
+- scripts/ 存放 shell 脚本（如 tools.sh）
+
+## 使用说明
+1. 用 Android Studio 打开本项目
+2. 运行 app 模块
+3. 在界面中配置参数并执行脚本
+
+> 注意：需确保 Android 设备具备 shell 权限（如 root 或 Termux 环境），否则无法直接运行 shell 脚本。
diff --git a/app/AndroidManifest.xml b/app/AndroidManifest.xml
new file mode 100644
index 0000000..5656c92
--- /dev/null
+++ b/app/AndroidManifest.xml
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.example.androidbackupgui">
+
+    <application
+        android:allowBackup="true"
+        android:icon="@mipmap/ic_launcher"
+        android:label="@string/app_name"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:supportsRtl="true"
+        android:theme="@style/Theme.AppCompat.Light.DarkActionBar">
+        <activity android:name=".MainActivity">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
+
+</manifest>
diff --git a/app/MainActivity.kt b/app/MainActivity.kt
new file mode 100644
index 0000000..bc721fd
--- /dev/null
+++ b/app/MainActivity.kt
@@ -0,0 +1,44 @@
+package com.example.androidbackupgui
+
+import android.os.Bundle
+import android.widget.*
+import androidx.appcompat.app.AppCompatActivity
+import java.io.BufferedReader
+import java.io.DataOutputStream
+import java.io.InputStreamReader
+
+class MainActivity : AppCompatActivity() {
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_main)
+
+        val paramInput = findViewById<EditText>(R.id.paramInput)
+        val runButton = findViewById<Button>(R.id.runButton)
+        val resultView = findViewById<TextView>(R.id.resultView)
+
+        runButton.setOnClickListener {
+            val params = paramInput.text.toString()
+            val result = runShellScript(params)
+            resultView.text = result
+        }
+    }
+
+    private fun runShellScript(params: String): String {
+        // 假设脚本已复制到 /data/data/com.example.androidbackupgui/files/scripts/tools.sh
+        val scriptPath = filesDir.absolutePath + "/scripts/tools.sh"
+        val cmd = "sh $scriptPath $params"
+        return try {
+            val process = Runtime.getRuntime().exec(arrayOf("su", "-c", cmd))
+            val reader = BufferedReader(InputStreamReader(process.inputStream))
+            val output = StringBuilder()
+            var line: String?
+            while (reader.readLine().also { line = it } != null) {
+                output.append(line).append("\n")
+            }
+            reader.close()
+            output.toString()
+        } catch (e: Exception) {
+            "执行失败: ${e.message}"
+        }
+    }
+}
diff --git a/app/activity_main.xml b/app/activity_main.xml
new file mode 100644
index 0000000..d54406e
--- /dev/null
+++ b/app/activity_main.xml
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical"
+    android:padding="16dp">
+
+    <EditText
+        android:id="@+id/paramInput"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:hint="输入脚本参数" />
+
+    <Button
+        android:id="@+id/runButton"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:text="运行脚本" />
+
+    <TextView
+        android:id="@+id/resultView"
+        android:layout_width="match_parent"
+        android:layout_height="0dp"
+        android:layout_weight="1"
+        android:text="结果输出..."
+        android:background="#EEE"
+        android:padding="8dp" />
+
+</LinearLayout>
diff --git a/app/build.gradle b/app/build.gradle
new file mode 100644
index 0000000..9937435
--- /dev/null
+++ b/app/build.gradle
@@ -0,0 +1,27 @@
+apply plugin: 'com.android.application'
+apply plugin: 'kotlin-android'
+
+android {
+    compileSdkVersion 34
+    defaultConfig {
+        applicationId "com.example.androidbackupgui"
+        minSdkVersion 24
+        targetSdkVersion 34
+        versionCode 1
+        versionName "1.0"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+
+dependencies {
+    implementation "org.jetbrains.kotlin:kotlin-stdlib:1.9.0"
+    implementation 'androidx.core:core-ktx:1.12.0'
+    implementation 'androidx.appcompat:appcompat:1.6.1'
+    implementation 'com.google.android.material:material:1.11.0'
+    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
+}
diff --git a/build.gradle b/build.gradle
new file mode 100644
index 0000000..468ff8b
--- /dev/null
+++ b/build.gradle
@@ -0,0 +1,23 @@
+// Top-level build file
+buildscript {
+    ext.kotlin_version = '1.9.0'
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.2.0'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+    }
+}
+
+allprojects {
+    repositories {
+        google()
+        mavenCentral()
+    }
+}
+
+task clean(type: Delete) {
+    delete rootProject.buildDir
+}
diff --git a/scripts/README.md b/scripts/README.md
new file mode 100644
index 0000000..a2189b6
--- /dev/null
+++ b/scripts/README.md
@@ -0,0 +1,2 @@
+# 该目录用于存放将要在 Android 端执行的 shell 脚本
+# 请将 backup_script/tools.sh 复制到此目录下，并确保脚本有可执行权限
diff --git a/settings.gradle b/settings.gradle
new file mode 100644
index 0000000..30f7712
--- /dev/null
+++ b/settings.gradle
@@ -0,0 +1,2 @@
+rootProject.name = "android-backup-gui"
+include ':app'