📝 Improve docs with new sections and relative packages

Author: AlexV525

README-ZH.md

@@ -18,10 +18,7 @@ that can be found in the LICENSE file. -->
 
 Language: [English](README.md) | 中文
 
-基于 **微信 UI** 的 Flutter 图片选择器（同时支持视频和音频）。
-该插件基于 [photo_manager][photo_manager pub] 实现资源相关功能，
-[extended_image][extended_image pub] 用于查看图片，
-[provider][provider pub] 用于协助管理选择器的状态。
+基于 **微信 UI** 的 Flutter **图片选择器（同时支持视频和音频）**。
 
 当前的界面设计基于的微信版本：**8.3.x**
 界面更新将在微信版本更新后随时进行跟进。
@@ -32,11 +29,27 @@ Language: [English](README.md) | 中文
 
 查看 [迁移指南][] 了解如何从破坏性改动中迁移为可用代码。
 
+## 主要使用的 package
+
+该插件基于这些优秀的 package 构建：
+
+| Name                                 | Features      |
+|:-------------------------------------|:--------------|
+| [photo_manager][photo_manager pub]   | 资源的基础抽象和管理。   |
+| [extended_image][extended_image pub] | 以熟悉的操作预览所有资源。 |
+| [provider][provider pub]             | 协助选择器管理器内部状态。 |
+| [video_player][video_player pub]     | 播放对应的视频和音频。   |
+
+这些 package 在该插件中的实现已相对稳定。
+如果你在使用中发现于它们相关的问题，
+请先在本插件的问题跟踪中报告相关问题。
+
 <details>
   <summary>目录列表</summary>
 
 <!-- TOC -->
 * [Flutter WeChat Assets Picker](#flutter-wechat-assets-picker)
+  * [主要使用的 package](#主要使用的-package)
   * [特性 ✨](#特性-)
     * [特别提醒 📝](#特别提醒-)
   * [项目展柜 🖼️](#项目展柜-)
@@ -92,7 +105,7 @@ Language: [English](README.md) | 中文
 1. HEIF (HEIC) 图片支持获取和转换，但是它们的显示依托于 Flutter 的图片解析。
    在此 issue 中 [flutter/flutter#20522](https://github.com/flutter/flutter/issues/20522) 有所说明。
    若要用于显示，请使用 `entity.file` 或 `AssetEntityImage` 进行处理。
-2. 由于 iOS 和 macOS 的系统限制，在获取音频时只能获取应用沙盒环境内的音频
+2. 由于 iOS 和 macOS 的系统限制，在获取音频时只能获取应用沙盒环境内的音频。
 
 ## 项目展柜 🖼️
 
@@ -204,6 +217,7 @@ import 'package:wechat_assets_picker/wechat_assets_picker.dart';
    ```ruby
    platform :ios, '11.0'
    ```
+   如果该行以 `#` (注释) 开头，请把 `#` 删除。
 2. 将以下内容添加至 `Info.plist`。
 ```
 <key>NSAppTransportSecurity</key>
@@ -221,6 +235,7 @@ import 'package:wechat_assets_picker/wechat_assets_picker.dart';
    ```Podfile
    platform :osx, '10.15'
    ```
+   如果该行以 `#` (注释) 开头，请把 `#` 删除。
 2. 使用 **Xcode** 打开 `macos/Runner.xcworkspace`。
    接着将 macOS 的最低构建版本提升至 **10.15**。
 3. 与 [iOS](#iOS) 一样，添加相同的内容到 `Info.plist` 里。
@@ -508,6 +523,7 @@ W/Glide   (21133): Failed to find GeneratedAppGlideModule.
 [photo_manager pub]: https://pub.flutter-io.cn/packages/photo_manager
 [extended_image pub]: https://pub.flutter-io.cn/packages/extended_image
 [provider pub]: https://pub.flutter-io.cn/packages/provider
+[video_player pub]: https://pub.flutter-io.cn/packages/video_player
 [wechat_camera_picker pub]: https://pub.flutter-io.cn/packages/wechat_camera_picker
 [迁移指南]: https://github.com/fluttercandies/flutter_wechat_assets_picker/blob/main/guides/migration_guide.md
 [photo_manager API 文档]: https://pub.flutter-io.cn/documentation/photo_manager/latest/

README.md

@@ -14,32 +14,44 @@ that can be found in the LICENSE file. -->
 [![GitHub forks](https://img.shields.io/github/forks/fluttercandies/flutter_wechat_assets_picker?logo=github&style=flat-square)](https://github.com/fluttercandies/flutter_wechat_assets_picker/network)
 
 [![Awesome Flutter](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/Solido/awesome-flutter)
-<a target="_blank" href="https://jq.qq.com/?_wv=1027&k=5bcc0gy"><img border="0" src="https://pub.idqqimg.com/wpa/images/group.png" alt="FlutterCandies" title="FlutterCandies"></a>
+[![Flutter Candies QQ群](https://pub.idqqimg.com/wpa/images/group.png)](https://jq.qq.com/?_wv=1027&k=5bcc0gy)
 
 Language: English | [中文](README-ZH.md)
 
-An image picker (also with videos and audios)
+An **image picker (also with videos and audios)**
 for Flutter projects based on the WeChat's UI.
-The package is using
-[photo_manager][photo_manager pub] for asset implementation,
-[extended_image][extended_image pub] for image preview,
-and [provider][provider pub] to help manage the state of the picker.
 
 Current WeChat version that UI based on: **8.3.x**
 UI designs will be updated following the WeChat update in anytime.
 
 To take a photo or a video for assets,
 please check the detailed usage in the example,
 and head over to [wechat_camera_picker][wechat_camera_picker pub].
-The package is a standalone extension that need to be used with combination.
+The package is a standalone extension that can to be used with combination.
 
 See the [Migration Guide][] to learn how to migrate between breaking changes.
 
+## Package credits
+
+The package is built from these wonderful packages.
+
+| Name                                 | Features                                             |
+|:-------------------------------------|:-----------------------------------------------------|
+| [photo_manager][photo_manager pub]   | The basic abstractions and management for assets.    |
+| [extended_image][extended_image pub] | Preview assets with expected behaviors.              |
+| [provider][provider pub]             | Helps to manage the interaction state of the picker. |
+| [video_player][video_player pub]     | Plays videos and audios correspondingly.             |
+ 
+Their implementation should be relatively stable in the package.
+If you've found any issues related to them when using the picker,
+submit issues to our issue tracker first.
+
 <details>
   <summary>Table of content</summary>
 
 <!-- TOC -->
 * [Flutter WeChat Assets Picker](#flutter-wechat-assets-picker)
+  * [Package credits](#package-credits)
   * [Features ✨](#features-)
     * [Notes 📝](#notes-)
   * [Projects using this plugin 🖼️](#projects-using-this-plugin-)
@@ -211,6 +223,7 @@ consider declare only relevant permission in your apps, more specifically:
    ```Podfile
    platform :ios, '11.0'
    ```
+   Remove the `#` heading if the line starts with it.
 2. Add the following content to `Info.plist`.
 ```
 <key>NSAppTransportSecurity</key>
@@ -229,6 +242,7 @@ consider declare only relevant permission in your apps, more specifically:
    ```ruby
    platform :osx, '10.15'
    ```
+   Remove the `#` heading if the line starts with it.
 2. Set the minimum deployment target of the macOS to *10.15*.
    Use XCode to open `macos/Runner.xcworkspace` .
 3. Follow the [iOS](#iOS) instructions and modify `Info.plist` accordingly.
@@ -579,6 +593,7 @@ such as [IntelliJ IDEA](https://www.jetbrains.com/idea/?from=fluttercandies).
 [photo_manager pub]: https://pub.dev/packages/photo_manager
 [extended_image pub]: https://pub.dev/packages/extended_image
 [provider pub]: https://pub.dev/packages/provider
+[video_player pub]: https://pub.dev/packages/video_player
 [wechat_camera_picker pub]: https://pub.dev/packages/wechat_camera_picker
 [Migration Guide]: https://github.com/fluttercandies/flutter_wechat_assets_picker/blob/main/guides/migration_guide.md
 [photo_manager's API docs]: https://pub.dev/documentation/photo_manager/latest/