📝 Update glide question.

Author: AlexV525

README-ZH.md

@@ -23,7 +23,9 @@ Language: [English](README.md) | 中文简体
 * [使用方法](#使用方法-)
   * [简单的使用方法](#简单的使用方法)
   * [完整参数的使用方法](#完整参数的使用方法)
+* [常见问题](#常见问题)
   * [从`File`或`Uint8List`创建`AssetEntity`的方法](#从file或uint8list创建assetentity的方法)
+  * [控制台提示 'Failed to find GeneratedAppGlideModule'](#控制台提示-failed-to-find-generatedappglidemodule)
 
 ## 特性 ✨
 
@@ -72,6 +74,49 @@ import 'package:wechat_assets_picker/wechat_assets_picker.dart';
 
 应用至少需要声明三个权限：`INTERNET` `READ_EXTERNAL_STORAGE WRITE_EXTERNAL_STORAGE`
 
+主项目组要实现 `AppGlideModule`。比如：
+`example/android/app/build.gradle`:
+```gradle
+  apply plugin: 'com.android.application'
+  apply plugin: 'kotlin-android'
++ apply plugin: 'kotlin-kapt'
+  apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"
+  
+  dependencies {
+    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlin_version"
++   implementation 'com.github.bumptech.glide:glide:4.11.0'
++   kapt 'com.github.bumptech.glide:compiler:4.11.0'
+    testImplementation 'junit:junit:4.12'
+}
+```
+
+`example/android/app/src/main/kotlin/com/example/exampleapp/ExampleAppGlideModule.java`:
+```kotlin
+package com.example.exampleapp;
+
+import com.bumptech.glide.annotation.GlideModule;
+import com.bumptech.glide.module.AppGlideModule;
+
+@GlideModule
+public class ExampleAppGlideModule extends AppGlideModule {
+}
+```
+如果你使用了与该库不一样的`Glide`版本，请将以下内容添加到`build.gradle`：
+```gradle
+rootProject.allprojects {
+    subprojects {
+        project.configurations.all {
+            resolutionStrategy.eachDependency { details ->
+                if (details.requested.group == 'com.github.bumptech.glide'
+                        && details.requested.name.contains('glide')) {
+                    details.useVersion "4.11.0"
+                }
+            }
+        }
+    }
+}
+```
+
 ### iOS
 
 将以下内容添加至`info.plist`。
@@ -163,6 +208,8 @@ AssetPicker.pickAssets(
 });
 ```
 
+## 常见问题
+
 ### 从`File`或`Uint8List`创建`AssetEntity`的方法
 
 如果需要使用此库结合一些拍照需求，可通过以下方法将`File`或`Uint8List`转为`AssetEntity`。
@@ -179,4 +226,14 @@ final AssetEntity imageEntity = await PhotoManager.editor.saveImage(byteData); /
 final List<String> result = await PhotoManager.editor.deleteWithIds([entity.id]);
 ```
 
-参考文档： [flutter_photo_manager#insert-new-item](https://github.com/CaiJingLong/flutter_photo_manager#insert-new-item)
+参考文档： [flutter_photo_manager#insert-new-item](https://github.com/CaiJingLong/flutter_photo_manager#insert-new-item)
+
+
+### 控制台提示 'Failed to find GeneratedAppGlideModule'
+
+```
+W/Glide   (21133): Failed to find GeneratedAppGlideModule. You should include an annotationProcessor complie dependency on com.github.bumptech.glide:compiler in you application ana a @GlideModule annotated AppGlideModule implementation or LibraryGlideModules will be silently ignored.
+```
+
+`Glide` 通过注解来保证单例，防止单例或版本之间的冲突，而因为`photo_manager`使用了`Glide`提供部分图片功能，所以使用它的项目必须实现自己的`AppGlideModule`。 请移步[Android](#android)部分了解如何实现。
+

README.md

@@ -23,7 +23,9 @@ An **assets picker** which looks like the one in WeChat, based on `photo_manager
 * [Usage](#usage-)
   * [Simple usage](#simple-usage)
   * [Complete param usage](#complete-param-usage)
+* [Frequent asked questions](#frequent-asked-question)
   * [Create `AssetEntity` from `File` or `Uint8List` (rawData)](#create-assetentity-from-file-or-uint8list-rawdata)
+  * [Console warning 'Failed to find GeneratedAppGlideModule'](#glide-warning-failed-to-find-generatedappglidemodule)
 
 ## Features ✨
 
@@ -70,6 +72,50 @@ import 'package:wechat_assets_picker/wechat_assets_picker.dart';
 
 You need at lease three permissions: `INTERNET` `READ_EXTERNAL_STORAGE` `WRITE_EXTERNAL_STORAGE`.
 
+Then the main project needs implementation of `AppGlideModule`. For example:
+`example/android/app/build.gradle`:
+```gradle
+  apply plugin: 'com.android.application'
+  apply plugin: 'kotlin-android'
++ apply plugin: 'kotlin-kapt'
+  apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"
+  
+  dependencies {
+    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlin_version"
++   implementation 'com.github.bumptech.glide:glide:4.11.0'
++   kapt 'com.github.bumptech.glide:compiler:4.11.0'
+    testImplementation 'junit:junit:4.12'
+}
+```
+
+`example/android/app/src/main/kotlin/com/example/exampleapp/ExampleAppGlideModule.java`:
+
+```kotlin
+package com.example.exampleapp;
+
+import com.bumptech.glide.annotation.GlideModule;
+import com.bumptech.glide.module.AppGlideModule;
+
+@GlideModule
+public class ExampleAppGlideModule extends AppGlideModule {
+}
+```
+If you're using different versions of `Glide`, please add this to the `build.gradle`:
+```gradle
+rootProject.allprojects {
+    subprojects {
+        project.configurations.all {
+            resolutionStrategy.eachDependency { details ->
+                if (details.requested.group == 'com.github.bumptech.glide'
+                        && details.requested.name.contains('glide')) {
+                    details.useVersion "4.11.0"
+                }
+            }
+        }
+    }
+}
+```
+
 ### iOS
 
 Add following content to `info.plist`.
@@ -118,7 +164,7 @@ AssetPicker.pickAsset(context).then((List<AssetEntity> assets) {
 
 ### Complete param usage
 
-```dart
+​```dart
 List<AssetEntity> assets = <AssetEntity>{};
 
 final List<AssetEntity> result = await AssetPicker.pickAssets(
@@ -160,6 +206,8 @@ AssetPicker.pickAssets(
 });
 ```
 
+## Frequent asked question
+
 ### Create `AssetEntity` from `File` or `Uint8List` (rawData)
 
 In order to combine this package with camera shooting or something related, there's a wordaround about how to create an `AssetEntity` with `File` or `Uint8List` object.
@@ -176,4 +224,12 @@ If you don't want to keep the asset in your device, just delete it after you com
 final List<String> result = await PhotoManager.editor.deleteWithIds([entity.id]);
 ```
 
-ref: [flutter_photo_manager#insert-new-item](https://github.com/CaiJingLong/flutter_photo_manager#insert-new-item)
+ref: [flutter_photo_manager#insert-new-item](https://github.com/CaiJingLong/flutter_photo_manager#insert-new-item)
+
+### Glide warning 'Failed to find GeneratedAppGlideModule'
+
+```
+W/Glide   (21133): Failed to find GeneratedAppGlideModule. You should include an annotationProcessor complie dependency on com.github.bumptech.glide:compiler in you application ana a @GlideModule annotated AppGlideModule implementation or LibraryGlideModules will be silently ignored.
+```
+
+`Glide` needs annotation to keep singleton, prevent conflict between instances and versions, so while the photo manager uses `Glide` to implement image features, the project which import this should define its own `AppGlideModule`. See [Android](#android) section for implementation.

example/android/app/build.gradle

@@ -23,6 +23,7 @@ if (flutterVersionName == null) {
 
 apply plugin: 'com.android.application'
 apply plugin: 'kotlin-android'
+apply plugin: 'kotlin-kapt'
 apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"
 
 android {
@@ -60,7 +61,9 @@ flutter {
 }
 
 dependencies {
-    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
+    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlin_version"
+    implementation 'com.github.bumptech.glide:glide:4.11.0'
+    kapt 'com.github.bumptech.glide:compiler:4.11.0'
     testImplementation 'junit:junit:4.12'
     androidTestImplementation 'androidx.test:runner:1.1.1'
     androidTestImplementation 'androidx.test.espresso:espresso-core:3.1.1'

example/android/app/src/main/kotlin/com/example/example/ExampleAppGlideModule.java

@@ -0,0 +1,8 @@
+package com.example.example;
+
+import com.bumptech.glide.annotation.GlideModule;
+import com.bumptech.glide.module.AppGlideModule;
+
+@GlideModule
+public class ExampleAppGlideModule extends AppGlideModule {
+}