透過集合功能整理內容
你可以依據偏好儲存及分類內容。
Documentfile
查看檔案文件。
最近更新時間 |
穩定版 |
候選版 |
Beta 版 |
Alpha 版 |
2025 年 5 月 7 日 |
1.1.0 |
- |
- |
- |
宣告依附元件
如要新增 DocumentFile 的依附元件,您必須在專案中新增 Google Maven 存放區。詳情請參閱 Google 的 Maven 存放區。
在應用程式或模組的 build.gradle
檔案中,新增您需要的構件依附元件:
Groovy
dependencies {
implementation "androidx.documentfile:documentfile:1.1.0"
}
Kotlin
dependencies {
implementation("androidx.documentfile:documentfile:1.1.0")
}
意見回饋
您的意見可協助我們改善 Jetpack。如果您發現新問題,或是有改進這個程式庫的建議,請告訴我們。回報新問題前,請先查看這個程式庫的現有問題。只要按一下星號按鈕,即可投票給現有的問題。
建立新問題
詳情請參閱 Issue Tracker 說明文件。
1.1.0 版
1.1.0 版本
2025 年 5 月 7 日
發布 androidx.documentfile:documentfile:1.1.0
。1.1.0 版包含這些修訂版本。
1.1.0-rc01 版本
2025 年 4 月 23 日
發布 androidx.documentfile:documentfile:1.1.0-rc01
。1.1.0-rc01 版包含這些修訂版本。
API 變更
- 使用 Kotlin 2.0 發布的專案需要使用 KGP 2.0.0 以上版本。(Idb6b5)。
1.1.0-beta01 版本
2025 年 4 月 9 日
發布 androidx.documentfile:documentfile:1.1.0-beta01
。1.1.0-beta01 版本包含這些修訂版本。
修正錯誤
1.1.0-alpha01 版本
2021 年 8 月 18 日
發布 androidx.documentfile:documentfile:1.1.0-alpha01
。1.1.0-alpha01 版包含以下修訂項目。
修正錯誤
- 修正
DocumentFile
的 ClassVerificationFailures。(b/188452767)
1.0.1 版
1.0.1 版
2019 年 2 月 25 日
androidx.documentfile:documentfile 1.0.1
發布。
修正錯誤
- 修正問題,其中深層樹狀結構 URI 被
Document.fromUri
截斷 (b/37081745)
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間:2025-07-27 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-07-27 (世界標準時間)。"],[],[],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))"]]