مشاركة الملفات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
غالبًا ما تحتاج التطبيقات إلى عرض ملف أو أكثر من ملفاتها على تطبيق آخر. على سبيل المثال، قد يريد معرض الصور عرض ملفات لمحرّري الصور، أو قد يحتاج تطبيق إدارة الملفات إلى السماح للمستخدمين بنسخ الملفات ولصقها بين المناطق في وحدة تخزين خارجية. وهناك طريقة يمكن لتطبيق إرسال من خلالها مشاركة ملف، وهي الرد على طلب من التطبيق المستلِم.
في جميع الحالات، الطريقة الوحيدة الآمنة لتقديم ملف من تطبيقك إلى تطبيق آخر هي إرسال
معرّف الموارد المنتظم (URI) لمحتوى الملف إلى التطبيق المستلم ومنح أذونات الوصول المؤقتة إلى معرّف الموارد المنتظم هذا.
إنّ معرّفات الموارد المنتظمة الخاصة بالمحتوى والتي لديها أذونات وصول مؤقتة إلى معرّف الموارد المنتظم (URI) تكون آمنة لأنّها لا تسري إلا على
التطبيق الذي يتلقّى معرّف الموارد المنتظم (URI)، وتنتهي صلاحيتها تلقائيًا. يوفّر المكوِّن FileProvider لنظام التشغيل Android الطريقة getUriForFile() لإنشاء معرّف الموارد المنتظم (URI) لمحتوى الملف.
إذا أردت مشاركة كميات صغيرة من البيانات النصية أو الرقمية بين التطبيقات، يجب إرسال
Intent يتضمّن البيانات. للتعرّف على طريقة إرسال بيانات بسيطة باستخدام
Intent، راجِع الصف التدريبي
مشاركة البيانات البسيطة.
تشرح هذه الدورة التدريبية كيفية مشاركة الملفات بأمان من تطبيقك مع تطبيق آخر باستخدام معرّفات الموارد المنتظمة (URI) للمحتوى التي تم إنشاؤها بواسطة مكوّن FileProvider على Android
والأذونات المؤقتة التي تمنحها للتطبيق المُستلِم في معرّف الموارد المنتظم للمحتوى.
دروس
- إعداد مشاركة الملفات
-
تعرَّف على طريقة إعداد تطبيقك لمشاركة الملفات.
- مشاركة ملف
-
تعرَّف على كيفية عرض ملف على تطبيق آخر من خلال إنشاء معرّف موارد منتظم (URI) للمحتوى للملف،
ومنح أذونات الوصول إلى معرّف الموارد المنتظم (URI)، وإرسال معرّف الموارد المنتظم (URI) إلى التطبيق.
- طلب ملف مشترك
-
تعرَّف على طريقة طلب ملف شاركه تطبيق آخر واستلام معرّف الموارد المنتظم للمحتوى للملف واستخدام معرّف الموارد المنتظم (URI) للمحتوى لفتح الملف.
-
استرداد معلومات الملف
-
تعرَّف على كيفية استخدام تطبيق لمعرّف الموارد المنتظم (URI) للمحتوى الذي تم إنشاؤه من خلال
FileProvider لاسترداد معلومات الملف، بما في ذلك نوع MIME وحجم الملف.
للحصول على معلومات إضافية ذات صلة، راجع:
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ 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,["# Sharing files\n\nApps often have a need to offer one or more of their files to another app. For example, an image\ngallery may want to offer files to image editors, or a file management app may want to allow\nusers to copy and paste files between areas in external storage. One way a sending app can\nshare a file is to respond to a request from the receiving app.\n\n\nIn all cases, the only secure way to offer a file from your app to another app is to send the\nreceiving app the file's content URI and grant temporary access permissions to that URI.\nContent URIs with temporary URI access permissions are secure because they apply only to the\napp that receives the URI, and they expire automatically. The Android\n[FileProvider](/reference/androidx/core/content/FileProvider) component provides the method\n[getUriForFile()](/reference/androidx/core/content/FileProvider#getUriForFile(android.content.Context, java.lang.String, java.io.File)) for\ngenerating a file's content URI.\n\n\nIf you want to share small amounts of text or numeric data between apps, you should send an\n[Intent](/reference/android/content/Intent) that contains the data. To learn how to send simple data with an\n[Intent](/reference/android/content/Intent), see the training class\n[Sharing simple data](/training/sharing).\n\n\nThis class explains how to securely share files from your app to another app using content URIs\ngenerated by the Android [FileProvider](/reference/androidx/core/content/FileProvider) component and\ntemporary permissions that you grant to the receiving app for the content URI.\n\nLessons\n-------\n\n**[Setting up file sharing](/training/secure-file-sharing/setup-sharing)**\n:\n Learn how to set up your app to share files.\n\n**[Sharing a file](/training/secure-file-sharing/share-file)**\n:\n Learn how to offer a file to another app by generating a content URI for the file,\n granting access permissions to the URI, and sending the URI to the app.\n\n**[Requesting a shared file](/training/secure-file-sharing/request-file)**\n:\n Learn how to request a file shared by another app, receive the content URI for the file,\n and use the content URI to open the file.\n\n\n**[Retrieving file information](/training/secure-file-sharing/retrieve-info)**\n:\n Learn how an app can use a content URI generated by a\n [FileProvider](/reference/androidx/core/content/FileProvider) to retrieve file information including\n MIME type and file size.\n\nFor additional related information, refer to:\n\n- [Storage Options](/guide/topics/data/data-storage)\n- [Saving Files](/training/basics/data-storage/files)\n- [Sharing Simple Data](/training/sharing)"]]
