diff --git a/.gitignore b/.gitignore
index 7f56fac..e2e46ef 100644
--- a/.gitignore
+++ b/.gitignore
@@ -35,8 +35,9 @@ upload-keystore.jks
*.key
# Tauri build artifacts and generated files
-src-tauri/gen/
src-tauri/target/
-src-tauri/.gradle/
+src-tauri/gen/android/.gradle/
+src-tauri/gen/android/app/build/
+src-tauri/gen/android/buildSrc/build/
*.apk
*.aab
diff --git a/ANDROID_BUILD.md b/ANDROID_BUILD.md
new file mode 100644
index 0000000..afb47a0
--- /dev/null
+++ b/ANDROID_BUILD.md
@@ -0,0 +1,86 @@
+# Android 构建说明
+
+## 本地开发构建
+
+### 1. 环境准备
+确保已安装：
+- Node.js 18+
+- Rust 1.70+
+- Android SDK
+- pnpm
+
+### 2. 安装依赖
+```bash
+pnpm install
+```
+
+### 3. 配置签名（可选）
+如果需要生产签名（发布到应用商店），需要配置签名密钥：
+
+1. 复制配置模板：
+```bash
+cp keystore.properties.example keystore.properties
+```
+
+2. 编辑 `keystore.properties`，填入你的密钥信息：
+```properties
+storeFile=your-keystore.jks
+storePassword=your_keystore_password
+keyPassword=your_key_password
+keyAlias=your_key_alias
+```
+
+3. 确保密钥文件在项目根目录
+
+### 4. 构建应用
+```bash
+# 构建Android APK
+./build_android.sh
+
+# 或使用 Tauri 命令
+pnpm tauri android build --apk
+```
+
+## CI/CD 环境构建
+
+### 自动处理签名
+构建系统会自动检测签名配置：
+
+- **有 `keystore.properties`**: 使用自定义签名密钥
+- **无 `keystore.properties`**: 自动使用debug签名
+
+这确保了CI/CD环境可以正常构建，无需额外配置。
+
+### GitHub Actions 示例
+```yaml
+- name: Build Android APK
+ run: |
+ pnpm install
+ pnpm tauri android build --apk
+ # 无需配置密钥，会自动使用debug签名
+```
+
+### 生产环境签名
+如果需要在CI/CD中使用生产签名：
+
+1. 将密钥文件和配置作为secrets添加到CI/CD系统
+2. 在构建前创建 `keystore.properties` 文件
+3. 构建系统会自动使用生产签名
+
+## 输出文件
+构建完成后，APK文件位于：
+```
+src-tauri/gen/android/app/build/outputs/apk/universal/release/
+```
+
+## 故障排除
+
+### 签名相关错误
+- 检查 `keystore.properties` 文件路径和内容
+- 确保密钥文件存在且密码正确
+- 如果不需要生产签名，删除 `keystore.properties` 文件
+
+### 构建环境问题
+- 确保Android SDK正确安装
+- 检查环境变量 `ANDROID_HOME`
+- 更新Android构建工具到最新版本
\ No newline at end of file
diff --git a/keystore.properties.example b/keystore.properties.example
new file mode 100644
index 0000000..c229354
--- /dev/null
+++ b/keystore.properties.example
@@ -0,0 +1,4 @@
+storeFile=upload-keystore.jks
+storePassword=your_keystore_password
+keyPassword=your_key_password
+keyAlias=upload
\ No newline at end of file
diff --git a/src-tauri/gen/android/.editorconfig b/src-tauri/gen/android/.editorconfig
new file mode 100644
index 0000000..ebe51d3
--- /dev/null
+++ b/src-tauri/gen/android/.editorconfig
@@ -0,0 +1,12 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = false
+insert_final_newline = false
\ No newline at end of file
diff --git a/src-tauri/gen/android/.gitignore b/src-tauri/gen/android/.gitignore
new file mode 100644
index 0000000..b248203
--- /dev/null
+++ b/src-tauri/gen/android/.gitignore
@@ -0,0 +1,19 @@
+*.iml
+.gradle
+/local.properties
+/.idea/caches
+/.idea/libraries
+/.idea/modules.xml
+/.idea/workspace.xml
+/.idea/navEditor.xml
+/.idea/assetWizardSettings.xml
+.DS_Store
+build
+/captures
+.externalNativeBuild
+.cxx
+local.properties
+key.properties
+
+/.tauri
+/tauri.settings.gradle
\ No newline at end of file
diff --git a/src-tauri/gen/android/app/.gitignore b/src-tauri/gen/android/app/.gitignore
new file mode 100644
index 0000000..446fd0b
--- /dev/null
+++ b/src-tauri/gen/android/app/.gitignore
@@ -0,0 +1,6 @@
+/src/main/java/com/countdown/app/generated
+/src/main/jniLibs/**/*.so
+/src/main/assets/tauri.conf.json
+/tauri.build.gradle.kts
+/proguard-tauri.pro
+/tauri.properties
\ No newline at end of file
diff --git a/src-tauri/gen/android/app/build.gradle.kts b/src-tauri/gen/android/app/build.gradle.kts
new file mode 100644
index 0000000..d914f5d
--- /dev/null
+++ b/src-tauri/gen/android/app/build.gradle.kts
@@ -0,0 +1,106 @@
+import java.util.Properties
+
+plugins {
+ id("com.android.application")
+ id("org.jetbrains.kotlin.android")
+ id("rust")
+}
+
+val tauriProperties = Properties().apply {
+ val propFile = file("tauri.properties")
+ if (propFile.exists()) {
+ propFile.inputStream().use { load(it) }
+ }
+}
+
+// 加载签名密钥配置
+// keystore.properties文件应包含：storeFile, storePassword, keyPassword, keyAlias
+// 如果文件不存在，将使用debug签名（适用于CI/CD环境）
+val keystoreProperties = Properties().apply {
+ val propFile = file("../../../../keystore.properties")
+ if (propFile.exists()) {
+ propFile.inputStream().use { load(it) }
+ }
+}
+
+android {
+ compileSdk = 34
+ namespace = "com.countdown.app"
+ defaultConfig {
+ manifestPlaceholders["usesCleartextTraffic"] = "false"
+ applicationId = "com.countdown.app"
+ minSdk = 24
+ targetSdk = 34
+ versionCode = tauriProperties.getProperty("tauri.android.versionCode", "1").toInt()
+ versionName = tauriProperties.getProperty("tauri.android.versionName", "1.0")
+ }
+
+ // 签名配置
+ signingConfigs {
+ create("release") {
+ // 检查是否存在密钥配置，如果没有则使用debug签名
+ // 这确保了CI/CD环境可以正常构建，即使没有生产密钥
+ if (keystoreProperties.containsKey("keyAlias")) {
+ keyAlias = keystoreProperties["keyAlias"] as String
+ keyPassword = keystoreProperties["keyPassword"] as String
+ storeFile = file("../../../../${keystoreProperties["storeFile"]}")
+ storePassword = keystoreProperties["storePassword"] as String
+ println("✓ 使用自定义签名密钥: ${keystoreProperties["keyAlias"]}")
+ } else {
+ // 如果没有密钥配置，使用debug签名配置
+ // CI/CD环境通常不需要生产签名
+ println("⚠ 未找到keystore.properties，将使用debug签名")
+ }
+ }
+ }
+ buildTypes {
+ getByName("debug") {
+ manifestPlaceholders["usesCleartextTraffic"] = "true"
+ isDebuggable = true
+ isJniDebuggable = true
+ isMinifyEnabled = false
+ packaging { jniLibs.keepDebugSymbols.add("*/arm64-v8a/*.so")
+ jniLibs.keepDebugSymbols.add("*/armeabi-v7a/*.so")
+ jniLibs.keepDebugSymbols.add("*/x86/*.so")
+ jniLibs.keepDebugSymbols.add("*/x86_64/*.so")
+ }
+ }
+ getByName("release") {
+ isMinifyEnabled = true
+ proguardFiles(
+ *fileTree(".") { include("**/*.pro") }
+ .plus(getDefaultProguardFile("proguard-android-optimize.txt"))
+ .toList().toTypedArray()
+ )
+ // 应用签名配置：有自定义密钥时使用自定义签名，否则使用debug签名
+ // 这确保CI/CD环境能正常构建release版本，即使没有生产密钥
+ if (keystoreProperties.containsKey("keyAlias")) {
+ signingConfig = signingConfigs.getByName("release")
+ } else {
+ // 在CI/CD环境中，如果没有生产密钥，使用debug签名
+ signingConfig = signingConfigs.getByName("debug")
+ }
+ }
+ }
+ kotlinOptions {
+ jvmTarget = "1.8"
+ }
+ buildFeatures {
+ buildConfig = true
+ }
+}
+
+rust {
+ rootDirRel = "../../../"
+}
+
+dependencies {
+ implementation("androidx.webkit:webkit:1.6.1")
+ implementation("androidx.appcompat:appcompat:1.6.1")
+ implementation("com.google.android.material:material:1.8.0")
+ testImplementation("junit:junit:4.13.2")
+ androidTestImplementation("androidx.test.ext:junit:1.1.4")
+ androidTestImplementation("androidx.test.espresso:espresso-core:3.5.0")
+}
+
+apply(from = "tauri.build.gradle.kts")
\ No newline at end of file
diff --git a/src-tauri/gen/android/app/proguard-rules.pro b/src-tauri/gen/android/app/proguard-rules.pro
new file mode 100644
index 0000000..481bb43
--- /dev/null
+++ b/src-tauri/gen/android/app/proguard-rules.pro
@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+# http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+# public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile
\ No newline at end of file
diff --git a/src-tauri/gen/android/app/src/main/AndroidManifest.xml b/src-tauri/gen/android/app/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..28c5b3f
--- /dev/null
+++ b/src-tauri/gen/android/app/src/main/AndroidManifest.xml
@@ -0,0 +1,37 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/src-tauri/gen/android/app/src/main/java/com/countdown/app/MainActivity.kt b/src-tauri/gen/android/app/src/main/java/com/countdown/app/MainActivity.kt
new file mode 100644
index 0000000..daf0ecd
--- /dev/null
+++ b/src-tauri/gen/android/app/src/main/java/com/countdown/app/MainActivity.kt
@@ -0,0 +1,3 @@
+package com.countdown.app
+
+class MainActivity : TauriActivity()
\ No newline at end of file
diff --git a/src-tauri/gen/android/app/src/main/res/drawable-v24/ic_launcher_foreground.xml b/src-tauri/gen/android/app/src/main/res/drawable-v24/ic_launcher_foreground.xml
new file mode 100644
index 0000000..2b068d1
--- /dev/null
+++ b/src-tauri/gen/android/app/src/main/res/drawable-v24/ic_launcher_foreground.xml
@@ -0,0 +1,30 @@
+
+
+
+
+