Merge pull request #65 from lakscastro/docs/v0.4.0-changelog

Add `v0.4.0`  changes to `CHANGELOG.md`

Author: Laks Castro

CHANGELOG.md

@@ -1,3 +1,22 @@
+## 0.4.0
+
+Fix the current behavior of `listFiles` and `openDocumentFile` API.
+
+### Improvements
+
+- It's now possible to list contents of all subfolders of a granted Uri opened from `openDocumentTree` ([@EternityForest](https://github.com/EternityForest)).
+- Now `ACTION_VIEW` intent builder through `openDocumentFile` API was fixed. So it's now possible to open any file of any kind in third party apps without needing specify the mime type.
+
+### Breaking changes
+
+- Removed Android specific APIs:
+  - `DocumentFile.listFiles` (Now it's only available globally).
+  - `buildDocumentUriUsingTree` removed due high coupling with Android API (Android specific API that are not useful on any other platforms).
+  - `buildDocumentUri` removed due high coupling with Android API (Android specific API that are not useful on any other platforms).
+  - `buildTreeDocumentUri` removed due high coupling with Android API (Android specific API that are not useful on any other platforms).
+- `getDocumentThumbnail` now receives only the `uri` param instead of a `rootUri` and a `documentId`.
+- `rootUri` field from `QueryMetadata` was removed due API ambiguity: there's no such concept in the Android API and this is not required by it to work well.
+
 ## 0.3.1
 
 Minor improvements and bug fixes:

docs/Usage/Storage Access Framework.md

@@ -321,56 +321,6 @@ const List<DocumentFileColumn> columns = <DocumentFileColumn>[
 final Stream<PartialDocumentFile> onNewFileLoaded = documentFileOfMyGrantedUri.listFiles(columns);
 ```
 
-### <samp>buildDocumentUriUsingTree</samp>
-
-<samp>Mirror of [`DocumentsContract.buildDocumentUriUsingTree`](<https://developer.android.com/reference/android/provider/DocumentsContract#buildDocumentUriUsingTree(android.net.Uri,%20java.lang.String)>)</samp>
-
-This is typically used to access documents under a user-selected directory tree, since it doesn't require the user to separately confirm each new document access.
-
-For details refer to the [original docs](<https://developer.android.com/reference/android/provider/DocumentsContract#buildDocumentUriUsingTree(android.net.Uri,%20java.lang.String)>).
-
-```dart
-final Uri treeUri = ...
-
-final PartialDocumentFile partialDocumentFile = ...
-
-final String documentId = partialFile.data![DocumentFileColumn.id]!;
-
-final Uri? documentUri = await buildDocumentUriUsingTree(treeUri, documentId);
-```
-
-### <samp>buildDocumentUri</samp>
-
-<samp>Mirror of [`DocumentsContract.buildDocumentUri`](<https://developer.android.com/reference/android/provider/DocumentsContract#buildDocumentUri(java.lang.String,%20java.lang.String)>)</samp>
-
-Less common method. Use it when you need to (e.g some SAF tutorial/API point to this method or you want a custom authority when building the document file).
-
-For details refer to the [original docs](<https://developer.android.com/reference/android/provider/DocumentsContract#buildDocumentUri(java.lang.String,%20java.lang.String)>).
-
-```dart
-final String customAuthority = ...
-final String documentId = ...
-
-final Uri? documentUri = await buildDocumentUri(customAuthority, documentId);
-```
-
-### <samp>buildTreeDocumentUri</samp>
-
-<samp>Mirror of [`DocumentsContract.buildTreeDocumentUri`](<https://developer.android.com/reference/android/provider/DocumentsContract#buildTreeDocumentUri(java.lang.String,%20java.lang.String)>)</samp>
-
-Less common method. Use it when you need to (e.g some SAF tutorial/API point to this method or you want a custom authority when building the document file).
-
-Build URI representing access to descendant documents of the given [`Document#COLUMN_DOCUMENT_ID`](https://developer.android.com/reference/android/provider/DocumentsContract.Document#COLUMN_DOCUMENT_ID).
-
-For details refer to the [original docs](<https://developer.android.com/reference/android/provider/DocumentsContract#buildTreeDocumentUri(java.lang.String,%20java.lang.String)>).
-
-```dart
-final String customAuthority = ...
-final String documentId = ...
-
-final Uri? documentUri = await buildDocumentUri(customAuthority, documentId);
-```
-
 ### <samp>delete</samp>
 
 <samp>Mirror of [`DocumentFile.delete`](<https://developer.android.com/reference/androidx/documentfile/provider/DocumentFile#delete()>)</samp>
@@ -598,7 +548,6 @@ This class represents but is not the mirror of the original [`DocumentFile`](htt
 
 This class is not intended to be instantiated, and it is only used for typing and convenient purposes.
 
-
 ### <samp>QueryMetadata</samp>
 
 This class wraps useful metadata of the source queries returned by the `PartialDocumentFile`.