تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ملف مستند
عرض مستند ملف
آخر تعديل |
الإصدار الثابت |
إصدار محتمل |
الإصدار التجريبي |
الإصدار الأولي |
7 أيار (مايو) 2025 |
1.1.0 |
- |
- |
- |
تحديد التبعيات
لإضافة تبعية على DocumentFile، يجب إضافة مستودع Google Maven إلى
مشروعك. اطّلِع على مستودع Maven من Google
لمزيد من المعلومات.
أضِف التبعيات للعناصر التي تحتاج إليها في ملف build.gradle
ل
تطبيقك أو وحدتك:
Groovy
dependencies {
implementation "androidx.documentfile:documentfile:1.1.0"
}
Kotlin
dependencies {
implementation("androidx.documentfile:documentfile:1.1.0")
}
الملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا واجهت مشاكل جديدة أو كان لديك
أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على
المشاكل الحالية
في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال
النقر على زر النجمة.
إنشاء مشكلة جديدة
اطّلِع على مستندات أداة تتبُّع المشاكل
لمزيد من المعلومات.
الإصدار 1.1.0
الإصدار 1.1.0
7 أيار (مايو) 2025
تم إصدار androidx.documentfile:documentfile:1.1.0
. يحتوي الإصدار 1.1.0 على عمليات الربط هذه.
الإصدار 1.1.0-rc01
23 أبريل 2025
تم إصدار androidx.documentfile:documentfile:1.1.0-rc01
. يتضمّن الإصدار 1.1.0-rc01 عمليات الربط هذه.
تغييرات واجهة برمجة التطبيقات
- تتطلّب المشاريع التي تم إصدارها باستخدام Kotlin 2.0 استخدام KGP 2.0.0 أو إصدار أحدث. (Idb6b5)
الإصدار 1.1.0-beta01
9 أبريل 2025
تم إصدار androidx.documentfile:documentfile:1.1.0-beta01
. يتضمّن الإصدار 1.1.0-beta01 عمليات الربط هذه.
إصلاح الأخطاء
- تستخدم هذه المكتبة الآن تعليقات توضيحية حول عدم تحديد قيمة JSpecify، وهي عبارة عن استخدام نوع. على مطوّري لغة Kotlin استخدام وسيطة المُجمِّع التالية لفرض الاستخدام الصحيح:
-Xjspecify-annotations=strict
(هذه هي القيمة التلقائية بدءًا من الإصدار 2.1.0 من مُجمِّع Kotlin). b/326456246
- حلّ المشاكل في المستندات في ملف المستند b/337250687
الإصدار 1.1.0-alpha01
18 آب (أغسطس) 2021
تم إصدار androidx.documentfile:documentfile:1.1.0-alpha01
. يحتوي الإصدار 1.1.0-alpha01 على هذه المراجعات.
إصلاح الأخطاء
- يجب حلّ أخطاء ClassVerificationFailures في
DocumentFile
. (b/188452767)
الإصدار 1.0.1
الإصدار 1.0.1
25 شباط (فبراير) 2019
تم إصدار androidx.documentfile:documentfile 1.0.1
.
إصلاح الأخطاء
- تم إصلاح الخلل الذي كان يؤدي إلى اقتطاع معرّفات الموارد المنتظمة (URI) للمسارات المتعمّقة من قِبل
Document.fromUri
(b/37081745)
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 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))"]]