💬 Add path entity update readme.

Author: AlexV525

README-ZH.md

@@ -34,6 +34,7 @@ Language: [English](README.md) | 中文简体
 * [常见问题](#常见问题-)
   * [`xxx` 版本获取冲突 (例如 `dartx`)](#xxx-版本获取冲突-例如-dartx)
   * [如何获取资源的路径以进行上传或编辑等操作的整合？](#如何获取资源的路径以进行上传或编辑等操作的整合)
+  * [如何更改“Recent”或其他路径的名称或属性？](#如何更改recent或其他路径的名称或属性)
   * [从`File`或`Uint8List`创建`AssetEntity`的方法](#从file或uint8list创建assetentity的方法)
   * [控制台提示 'Failed to find GeneratedAppGlideModule'](#控制台提示-failed-to-find-generatedappglidemodule)
 
@@ -294,6 +295,38 @@ dependency_overrides:
 
 如果再此之后你仍然需要路径，那么可以通过已获得的 `File` 对象获取： `file.absolutePath`。
 
+### 如何更改“Recent”或其他路径的名称或属性？
+
+由 `photo_manager` 传递的 “Recent” 路径，包含了您设备上的所有的 `AssetEntity`。大部分的平台都会将这个路径命名为 “Recent”。尽管我们提供了自定义文字构建的能力，但是 `AssetPathEntity` 的名字或属性只能通过 `SortPathDelegate` 进行更改。这是你能访问到所有 `AssetPathEntity` 的唯一方法，或者说，是现阶段我们暴露出来的唯一方法。
+
+若需要更改某一个路径的名字，继承 `SortPathDelegate` 并实现你自己的构建，接着像如下代码一样进行编写：
+
+```dart
+/// 构建你自己的排序
+class CustomSortPathDelegate extends SortPathDelegate {
+  const CustomSortPathDelegate();
+
+  @override
+  void sort(List<AssetPathEntity> list) {
+    ///...///
+
+    // 在这里你可以对每个你认为需要的路径进行判断。
+    // 我们唯一推荐更改的属性是 [name]，
+    // 并且我们不对更改其他属性造成的问题负责。
+    for (final AssetPathEntity entity in list) {
+      // 如果这个路径的 `isAll` 为真，则该路径就是你需要的。
+      if (entity.isAll) {
+        entity.name = '最近';
+      }
+    }
+
+    ///...///
+  }
+}
+```
+
+将你的构建传递至静态调用方法里，而后你就会看到你自定义了名称的路径。
+
 ### 从`File`或`Uint8List`创建`AssetEntity`的方法
 
 如果需要使用此库结合一些拍照需求，可通过以下方法将`File`或`Uint8List`转为`AssetEntity`。

README.md

@@ -55,6 +55,7 @@ This project follows the [all-contributors](https://github.com/all-contributors/
 * [Frequent asked question](#frequent-asked-question-)
   * [Version resolve conflict with `xxx` (e.g. `dartx`)](#version-resolve-conflict-with-xxx-eg-dartx)
   * [How can I get path from the `AssetEntity` to integrate with `File` object, upload or edit?](#how-can-i-get-path-from-the-assetentity-to-integrate-with-file-object-upload-or-edit)
+  * [How can I change the name of "Recent" or other entities name/properties?](#how-can-i-change-the-name-of-recent-or-other-entities-nameproperties)
   * [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)
 
@@ -315,6 +316,39 @@ You can always request the `File` object with `entity.originFile`, if `Uint8List
 
 If you still needs path after requested the `File`, get it through `file.absolutePath`.
 
+### How can I change the name of "Recent" or other entities name/properties?
+
+The path entity called "Recent", brought by `photo_manager` in the path entities list, includes all `AssetEntity` on your device. "Recent" is a system named entity in most of platforms. While we provided ability to customize the text delegate, the name/properties can only be updated with `SortPathDelegate` . This is the only way that you have access to all path entities, or the only way that we exposed currently.
+
+To change the name of the path entity, extend the `SortPathDelegate` with your own delegate, then write something like the code below:
+
+```dart
+/// Create your own sort path delegate.
+class CustomSortPathDelegate extends SortPathDelegate {
+  const CustomSortPathDelegate();
+
+  @override
+  void sort(List<AssetPathEntity> list) {
+    ///...///
+
+    // In here you can check every path entities if you want.
+    // The only property we recommend to change is [name],
+    // And we have no responsibility for issues caused by
+    // other properties update.
+    for (final AssetPathEntity entity in list) {
+      // If the entity `isAll`, that's the "Recent" entity you want.
+      if (entity.isAll) {
+        entity.name = 'Whatever you want';
+      }
+    }
+
+    ///...///
+  }
+}
+```
+
+Pass the delegate through the static call method, then you will get a self-named path entity.
+
 ### Create `AssetEntity` from `File` or `Uint8List` (rawData)
 
 In order to combine this package with camera shooting or something related, there's a solution about how to create an `AssetEntity` with `File` or `Uint8List` object.