Add API to allow read data from a specific `URI`

[alexrintt]

Details

The most recent Android API's, handle the files as a database of URI's, so we can handle it by adding support for cursor queries, as required by #10, thanks @ankitparmar007.

Tasks

• [x] Search and add experimental APIs to allow this usecase.
• [x] Add support for initialUri.
• [x] Add copy API to allow export files.
• [ ] ~Get data dir from a specific app (package id)~ (Not covered by this package).

Issues

• [x] Avoid using listFiles with large data sets.

Useful resources

• How to list files in an android directory.
• Check query public method API from DocumentProvider class.
• THIS is what I was looking for... maybe. Useful to query a large data set as we can see here.
• Implement initial dir param.
• Remember: Tree Document URI is not Single Document URI.

[ankitparmar007]

@LaksCastro When You are planning for package update ?

[alexrintt]

When I get some free time on the weekend

[ankitparmar007]

Great news that package update will be available on this weekend :)

Also Flutter 2.8.0 • channel stable is live on • github.com/flutter/flutter.git

Make sure package is compatible with the latest version.

Huge Thanks in advance :)

[alexrintt]

Nice!! I did start work right now, later you'll see some updates man and maybe on sunday I'll publish the new release if everything goes fine! thanks for all

[alexrintt]

Snapshot 13 Dec. 2021

News

• Added support for large data sets and removed the API DocumentFile.listFiles due to low performance issue
• Refactor of SAF API: split code into several modules to allow safe and easy refactor and new API implementations
• DocumentFile.listFiles is now an EventChannel since we load all files lazily
• Added support to these DocumentsContract and DocumentFile APIs:

  const val GET_DOCUMENT_THUMBNAIL = "getDocumentThumbnail"
  const val BUILD_DOCUMENT_URI_USING_TREE = "buildDocumentUriUsingTree"
  const val BUILD_DOCUMENT_URI = "buildDocumentUri"
  const val BUILD_TREE_DOCUMENT_URI = "buildTreeDocumentUri"

• Added optional argument grantWritePermission to the openDocumentTree API

Missing:

• Support to copy a document to another location
• Support to initialDir of the openDocumentTree API
• Update and improve documentation

_{Even not done yet, I consider a nice progress, I'll try to continue over the week, thanks}

[ankitparmar007]

Definitely a nice progress ! hopefully on next weekend package will be updated with Missing APIs and version code 0.3.0 :)

[ankitparmar007]

hey @LaksCastro Hope You are doing well :) Btw When are you planning for next package update ?

[alexrintt]

All features mentioned in this issue are available on v0.4.x except by the last one that doesn't make sense for this package.