增加群组通知过滤

example/libs/README.md

@@ -0,0 +1,114 @@
+# 本地 AAR 调试配置
+
+此目录用于放置本地编译的 OpenIM SDK AAR 文件，仅在 example 项目调试时使用。
+
+## 快速开始
+
+### 步骤 1: 准备 AAR 文件
+
+将你的 AAR 文件重命名为 `sdkcore-debug.aar` 并放在本目录：
+
+```
+example/libs/
+└── sdkcore-debug.aar  (你的本地编译 AAR 文件)
+```
+
+### 步骤 2: 复制到 Maven 仓库结构
+
+```bash
+# Linux/Mac/Git Bash
+cd example
+cp libs/sdkcore-debug.aar android/local-maven/com/openim/sdkcore/1.0.15-local/sdkcore-1.0.15-local.aar
+
+# Windows PowerShell
+cd example
+Copy-Item libs\sdkcore-debug.aar android\local-maven\com\openim\sdkcore\1.0.15-local\sdkcore-1.0.15-local.aar
+```
+
+**注意**: POM 文件已自动创建在 `android/local-maven/com/openim/sdkcore/1.0.15-local/sdkcore-1.0.15-local.pom`
+
+### 步骤 3: 启用本地 AAR
+
+编辑 `example/android/build.gradle`，取消以下两处注释：
+
+**1. 第 28 行 - 启用本地 Maven 仓库:**
+```gradle
+maven { url 'file://' + projectDir.absolutePath + '/local-maven' }
+```
+
+**2. 第 43-49 行 - 强制使用本地版本:**
+```gradle
+configurations.all {
+    resolutionStrategy {
+        force 'com.openim:sdkcore:1.0.15-local'
+    }
+}
+```
+
+### 步骤 4: 清理并重新构建
+
+```bash
+cd example
+flutter clean
+flutter pub get
+flutter build apk  # 或 flutter run
+```
+
+## 更新 AAR 后快速替换
+
+如果你已经配置过一次，只是更新了 AAR 文件：
+
+```bash
+cd example
+# 复制新的 AAR 文件
+cp libs/sdkcore-debug.aar android/local-maven/com/openim/sdkcore/1.0.15-local/sdkcore-1.0.15-local.aar
+
+# 清理并重新构建
+flutter clean && flutter pub get && flutter run
+```
+
+## 调试完成后恢复
+
+重新注释掉 `example/android/build.gradle` 中的两处配置即可恢复使用远程 Maven 仓库的版本。
+
+## 目录结构
+
+```
+example/
+├── libs/
+│   ├── README.md  (本文件)
+│   └── sdkcore-debug.aar  (你的 AAR 源文件)
+└── android/
+    └── local-maven/  (Git 已忽略)
+        └── com/openim/sdkcore/1.0.15-local/
+            ├── sdkcore-1.0.15-local.aar  (Maven 仓库中的 AAR)
+            └── sdkcore-1.0.15-local.pom  (Maven 元数据)
+```
+
+## 注意事项
+
+- ✅ 此配置只影响 example 项目，不会修改插件本身
+- ✅ 切换远程/本地版本只需注释/取消注释即可
+- ✅ `.gitignore` 已配置忽略 `android/local-maven/` 目录
+- ⚠️  每次修改 AAR 文件后需要重新复制到 Maven 目录并运行 `flutter clean`
+- ⚠️  确保 AAR 文件名和版本号匹配
+
+## 故障排查
+
+### 问题 1: Kotlin 版本不兼容错误
+已修复：插件的 `android/build.gradle` 已添加 Kotlin 插件和正确的配置。
+
+### 问题 2: "Zip file already contains entry" 错误
+运行彻底清理：
+```bash
+cd example
+flutter clean
+rm -rf build
+cd android && ./gradlew clean
+```
+
+### 问题 3: 找不到 sdkcore 依赖
+确保：
+1. `android/build.gradle` 中的本地 Maven 仓库已取消注释
+2. `resolutionStrategy.force` 配置已取消注释
+3. AAR 文件已正确复制到 Maven 目录结构中