创建Android MVVM架构示例项目

android-mvvm-demo/README.md

@@ -0,0 +1,156 @@
+# Android MVVM 架构示例项目
+
+这是一个使用 MVVM (Model-View-ViewModel) 架构模式的 Android 示例项目。
+
+## 项目概述
+
+本项目展示了如何在 Android 应用中实现 MVVM 架构，包括：
+- Model: 数据模型
+- View: UI 层（Activity/Fragment）
+- ViewModel: 业务逻辑层
+- Repository: 数据仓库层
+
+## 技术栈
+
+- **语言**: Java
+- **最小 SDK**: 24 (Android 7.0)
+- **目标 SDK**: 34 (Android 14)
+- **架构**: MVVM (Model-View-ViewModel)
+- **核心库**:
+  - AndroidX Lifecycle (ViewModel, LiveData)
+  - Material Components
+  - RecyclerView
+  - ConstraintLayout
+
+## 项目结构
+
+```
+app/src/main/java/com/example/mvvmdemo/
+├── model/              # 数据模型
+│   └── User.java       # 用户实体类
+├── repository/         # 数据仓库层
+│   └── UserRepository.java  # 用户数据管理
+├── view/               # UI 层
+│   ├── MainActivity.java    # 主界面
+│   └── UserAdapter.java     # RecyclerView 适配器
+└── viewmodel/          # 业务逻辑层
+    └── UserViewModel.java   # 用户视图模型
+```
+
+## MVVM 架构说明
+
+### Model (模型层)
+- **位置**: `model/User.java`
+- **职责**: 定义数据结构和业务实体
+- **特点**: 纯数据类，不包含业务逻辑
+
+### Repository (数据仓库层)
+- **位置**: `repository/UserRepository.java`
+- **职责**: 管理数据源，提供统一的数据访问接口
+- **特点**:
+  - 使用单例模式
+  - 可以整合多个数据源（本地数据库、远程 API 等）
+  - 为 ViewModel 提供干净的数据访问 API
+
+### ViewModel (视图模型层)
+- **位置**: `viewmodel/UserViewModel.java`
+- **职责**:
+  - 处理业务逻辑
+  - 管理 UI 相关数据
+  - 通过 LiveData 向 View 提供数据
+- **特点**:
+  - 继承自 `androidx.lifecycle.ViewModel`
+  - 使用 LiveData 实现数据观察
+  - 生命周期感知，配置更改时保持数据
+
+### View (视图层)
+- **位置**: `view/MainActivity.java`, `view/UserAdapter.java`
+- **职责**:
+  - 显示 UI
+  - 处理用户交互
+  - 观察 ViewModel 的数据变化
+- **特点**:
+  - 不包含业务逻辑
+  - 通过观察 LiveData 更新 UI
+  - 通过 ViewModel 执行操作
+
+## 数据流向
+
+```
+View (用户操作)
+  ↓
+ViewModel (处理逻辑)
+  ↓
+Repository (获取数据)
+  ↓
+Model (数据实体)
+  ↓
+LiveData (通知变化)
+  ↓
+View (更新UI)
+```
+
+## 主要功能
+
+1. **用户列表展示**: 使用 RecyclerView 显示用户列表
+2. **数据观察**: 通过 LiveData 实现响应式 UI 更新
+3. **刷新功能**: 点击 FAB 按钮刷新用户数据
+4. **Toast 消息**: 显示操作结果反馈
+
+## 如何运行
+
+1. 使用 Android Studio 打开项目
+2. 等待 Gradle 同步完成
+3. 连接 Android 设备或启动模拟器
+4. 点击 Run 按钮运行应用
+
+## 构建项目
+
+```bash
+# 清理构建
+./gradlew clean
+
+# 构建 Debug 版本
+./gradlew assembleDebug
+
+# 构建 Release 版本
+./gradlew assembleRelease
+
+# 运行测试
+./gradlew test
+```
+
+## MVVM 架构的优势
+
+1. **关注点分离**: 清晰的层次划分，各层职责明确
+2. **可测试性**: ViewModel 独立于 Android 组件，易于单元测试
+3. **生命周期感知**: ViewModel 在配置更改时保持数据
+4. **响应式编程**: 使用 LiveData 实现数据驱动 UI
+5. **可维护性**: 代码结构清晰，易于维护和扩展
+
+## 扩展建议
+
+要进一步完善项目，可以考虑：
+
+1. **网络请求**: 集成 Retrofit 实现真实的 API 调用
+2. **本地存储**: 使用 Room 数据库持久化数据
+3. **依赖注入**: 使用 Dagger/Hilt 实现依赖注入
+4. **协程**: 使用 Kotlin Coroutines 处理异步操作
+5. **分页加载**: 使用 Paging 3 库实现列表分页
+6. **错误处理**: 完善错误处理和用户反馈机制
+7. **单元测试**: 为 ViewModel 和 Repository 编写单元测试
+
+## 相关资源
+
+- [Android Architecture Components](https://developer.android.com/topic/libraries/architecture)
+- [LiveData](https://developer.android.com/topic/libraries/architecture/livedata)
+- [ViewModel](https://developer.android.com/topic/libraries/architecture/viewmodel)
+- [MVVM Pattern](https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93viewmodel)
+
+## 许可证
+
+MIT License
+
+## 作者
+
+Android MVVM Demo Project

android-mvvm-demo/app/build.gradle

@@ -0,0 +1,66 @@
+plugins {
+    id 'com.android.application'
+}
+
+android {
+    namespace 'com.example.mvvmdemo'
+    compileSdk 34
+
+    defaultConfig {
+        applicationId "com.example.mvvmdemo"
+        minSdk 24
+        targetSdk 34
+        versionCode 1
+        versionName "1.0"
+
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+
+    buildFeatures {
+        viewBinding true
+    }
+}
+
+dependencies {
+    // AndroidX Core
+    implementation 'androidx.appcompat:appcompat:1.6.1'
+    implementation 'com.google.android.material:material:1.10.0'
+    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
+
+    // Lifecycle components (ViewModel, LiveData)
+    implementation 'androidx.lifecycle:lifecycle-viewmodel:2.6.2'
+    implementation 'androidx.lifecycle:lifecycle-livedata:2.6.2'
+    implementation 'androidx.lifecycle:lifecycle-runtime:2.6.2'
+    implementation 'androidx.lifecycle:lifecycle-extensions:2.2.0'
+
+    // RecyclerView
+    implementation 'androidx.recyclerview:recyclerview:1.3.2'
+
+    // Retrofit for networking (optional)
+    implementation 'com.squareup.retrofit2:retrofit:2.9.0'
+    implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
+
+    // Coroutines for async operations
+    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3'
+
+    // Room Database (optional)
+    implementation 'androidx.room:room-runtime:2.6.0'
+    annotationProcessor 'androidx.room:room-compiler:2.6.0'
+
+    // Testing
+    testImplementation 'junit:junit:4.13.2'
+    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
+    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
+}

android-mvvm-demo/app/proguard-rules.pro

@@ -0,0 +1,25 @@
+# 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
+
+# Keep MVVM classes
+-keep class com.example.mvvmdemo.model.** { *; }
+-keep class com.example.mvvmdemo.viewmodel.** { *; }

android-mvvm-demo/app/src/main/AndroidManifest.xml

@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+
+    <!-- Internet permission for API calls -->
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+
+    <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.MVVMDemo"
+        tools:targetApi="31">
+
+        <activity
+            android:name=".view.MainActivity"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+
+    </application>
+
+</manifest>

android-mvvm-demo/app/src/main/java/com/example/mvvmdemo/model/User.java

@@ -0,0 +1,63 @@
+package com.example.mvvmdemo.model;
+
+/**
+ * User Model class
+ * Represents a user entity in the MVVM architecture
+ */
+public class User {
+    private int id;
+    private String name;
+    private String email;
+    private String phone;
+
+    public User(int id, String name, String email, String phone) {
+        this.id = id;
+        this.name = name;
+        this.email = email;
+        this.phone = phone;
+    }
+
+    // Getters
+    public int getId() {
+        return id;
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public String getEmail() {
+        return email;
+    }
+
+    public String getPhone() {
+        return phone;
+    }
+
+    // Setters
+    public void setId(int id) {
+        this.id = id;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public void setEmail(String email) {
+        this.email = email;
+    }
+
+    public void setPhone(String phone) {
+        this.phone = phone;
+    }
+
+    @Override
+    public String toString() {
+        return "User{" +
+                "id=" + id +
+                ", name='" + name + '\'' +
+                ", email='" + email + '\'' +
+                ", phone='" + phone + '\'' +
+                '}';
+    }
+}