Stay organized with collections
Save and categorize content based on your preferences.
Documentfile
View a file document.
| Latest Update |
Stable Release |
Release Candidate |
Beta Release |
Alpha Release |
| May 7, 2025 |
1.1.0 |
- |
- |
- |
Declaring dependencies
To add a dependency on DocumentFile, you must add the Google Maven repository to your
project. Read Google's Maven repository
for more information.
Add the dependencies for the artifacts you need in the build.gradle file for
your app or module:
Groovy
dependencies {
implementation "androidx.documentfile:documentfile:1.1.0"
}
Kotlin
dependencies {
implementation("androidx.documentfile:documentfile:1.1.0")
}
Feedback
Your feedback helps make Jetpack better. Let us know if you discover new issues or have
ideas for improving this library. Please take a look at the
existing issues
in this library before you create a new one. You can add your vote to an existing issue by
clicking the star button.
Create a new issue
See the Issue Tracker documentation
for more information.
Version 1.1.0
Version 1.1.0
May 7, 2025
androidx.documentfile:documentfile:1.1.0 is released. Version 1.1.0 contains these commits.
Version 1.1.0-rc01
April 23, 2025
androidx.documentfile:documentfile:1.1.0-rc01 is released. Version 1.1.0-rc01 contains these commits.
API Changes
- Projects released with Kotlin 2.0 require KGP 2.0.0 or newer to be consumed. (Idb6b5)
Version 1.1.0-beta01
April 9, 2025
androidx.documentfile:documentfile:1.1.0-beta01 is released. Version 1.1.0-beta01 contains these commits.
Bug Fixes
- This library now uses JSpecify nullness annotations, which are type-use. Kotlin developers should use the following compiler argument to enforce correct usage:
-Xjspecify-annotations=strict (this is the default starting with version 2.1.0 of the Kotlin compiler). b/326456246
- Fix documentation issues in documentfile b/337250687
Version 1.1.0-alpha01
August 18, 2021
androidx.documentfile:documentfile:1.1.0-alpha01 is released. Version 1.1.0-alpha01 contains these commits.
Bug Fixes
- Fix ClassVerificationFailures for
DocumentFile. (b/188452767)
Version 1.0.1
Version 1.0.1
February 25, 2019
androidx.documentfile:documentfile 1.0.1 is released.
Bug fixes
- Fixed bug where deep tree URIs were truncated by
Document.fromUri (b/37081745)
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-05-29 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-05-29 UTC."],[],[],null,["# Documentfile\n============\n\n[User Guide](/guide/topics/providers/document-provider) [Code Sample](https://github.com/android/storage-samples/tree/main/ActionOpenDocumentTree) \nAPI Reference \n[androidx.documentfile.provider](/reference/kotlin/androidx/documentfile/provider/package-summary) \nView a file document. \n\n| Latest Update | Stable Release | Release Candidate | Beta Release | Alpha Release |\n|---------------|--------------------------------------------------------|-------------------|--------------|---------------|\n| May 7, 2025 | [1.1.0](/jetpack/androidx/releases/documentfile#1.1.0) | - | - | - |\n\nDeclaring dependencies\n----------------------\n\nTo add a dependency on DocumentFile, you must add the Google Maven repository to your\nproject. Read [Google's Maven repository](/studio/build/dependencies#google-maven)\nfor more information.\n\nAdd the dependencies for the artifacts you need in the `build.gradle` file for\nyour app or module: \n\n### Groovy\n\n```groovy\ndependencies {\n implementation \"androidx.documentfile:documentfile:1.1.0\"\n}\n```\n\n### Kotlin\n\n```kotlin\ndependencies {\n implementation(\"androidx.documentfile:documentfile:1.1.0\")\n}\n```\n\nFeedback\n--------\n\nYour feedback helps make Jetpack better. Let us know if you discover new issues or have\nideas for improving this library. Please take a look at the\n[existing issues](https://issuetracker.google.com/issues?q=componentid:460422%20status:open)\nin this library before you create a new one. You can add your vote to an existing issue by\nclicking the star button.\n\n[Create a new issue](https://issuetracker.google.com/issues/new?component=460422&template=1422753)\n\nSee the [Issue Tracker documentation](https://developers.google.com/issue-tracker)\nfor more information.\n\nVersion 1.1.0\n-------------\n\n### Version 1.1.0\n\nMay 7, 2025\n\n`androidx.documentfile:documentfile:1.1.0` is released. Version 1.1.0 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/1fa883225f3ca6238e47b26124515acd0531da82..27495ca3d1fe4a1166bea16413ecf8cff5d85855/documentfile/documentfile).\n\n### Version 1.1.0-rc01\n\nApril 23, 2025\n\n`androidx.documentfile:documentfile:1.1.0-rc01` is released. Version 1.1.0-rc01 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/fa21b171320cb3de44a0848d06967a15c6402770..1fa883225f3ca6238e47b26124515acd0531da82/).\n\n**API Changes**\n\n- Projects released with Kotlin 2.0 require KGP 2.0.0 or newer to be consumed. ([Idb6b5](https://android-review.googlesource.com/#/q/Idb6b5d6ae1625ab870ffe74f9790ffabc82a63b4))\n\n### Version 1.1.0-beta01\n\nApril 9, 2025\n\n`androidx.documentfile:documentfile:1.1.0-beta01` is released. Version 1.1.0-beta01 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/1e0ab9e58c3c2ebe8152b7507938aef7e9c1acdc..fa21b171320cb3de44a0848d06967a15c6402770/documentfile/documentfile).\n\n**Bug Fixes**\n\n- This library now uses [JSpecify nullness annotations](https://jspecify.dev/), which are type-use. Kotlin developers should use the following compiler argument to enforce correct usage: `-Xjspecify-annotations=strict` (this is the default starting with version 2.1.0 of the Kotlin compiler). [b/326456246](https://issuetracker.google.com/issues/326456246)\n- Fix documentation issues in documentfile [b/337250687](https://issuetracker.google.com/issues/337250687)\n\n### Version 1.1.0-alpha01\n\nAugust 18, 2021\n\n`androidx.documentfile:documentfile:1.1.0-alpha01` is released. [Version 1.1.0-alpha01 contains these commits.](https://android.googlesource.com/platform/frameworks/support/+log/1e0ab9e58c3c2ebe8152b7507938aef7e9c1acdc/documentfile/documentfile)\n\n**Bug Fixes**\n\n- Fix ClassVerificationFailures for `DocumentFile`. ([b/188452767](https://issuetracker.google.com/issues/188452767))\n\nVersion 1.0.1\n-------------\n\n### Version 1.0.1\n\nFebruary 25, 2019\n\n`androidx.documentfile:documentfile 1.0.1` is released.\n\n**Bug fixes**\n\n- Fixed bug where deep tree URIs were truncated by `Document.fromUri` ([b/37081745](https://issuetracker.google.com/37081745))"]]
