اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

ContentProviderHandler

public class ContentProviderHandler
extends Object

java.lang.Object
↳	com.android.tradefed.device.contentprovider.ContentProviderHandler

معالِج يلخّص تفاعلات مقدّم المحتوى ويسمح باستخدام مقدّم المحتوى على الجهاز لإجراء عمليات مختلفة

يجب أن تراعي جميع عمليات التنفيذ في هذه الفئة المستخدم الذي يعمل حاليًا على الجهاز.

ملخّص

الحقول
`public static final String[]`	`COLUMNS`
`public static final String`	`COLUMN_ABSOLUTE_PATH`
`public static final String`	`COLUMN_DIRECTORY`
`public static final String`	`COLUMN_METADATA`
`public static final String`	`COLUMN_MIME_TYPE`
`public static final String`	`COLUMN_NAME`
`public static final String`	`CONTENT_PROVIDER_URI`
`public static final String`	`NO_RESULTS_STRING`
`public static final String`	`PACKAGE_NAME`
`public static final String`	`QUERY_INFO_VALUE`

وظائف الإنشاء العامة
`ContentProviderHandler(ITestDevice device)` طريقة الإنشاء
`ContentProviderHandler(ITestDevice device, Integer userId)`

الطرق العامة
`boolean`	`contentProviderNotFound()` تعرِض هذه الدالة القيمة True إذا تعذّر تنفيذ إحدى العمليات بسبب عدم العثور على موفِّر المحتوى.
`static String`	`createEscapedContentUri(String deviceFilePath)` عرض سلسلة عنوان URI الكاملة لمسار الجهاز المحدَّد، بعد ترميزها وتحويلها إلى أحرف ASCII لتجنُّب الأحرف غير المكوّنة من عنوان URL
`boolean`	`deleteFile(String deviceFilePath)` دالة استدعاء لموفّر المحتوى لحذف ملف في موقع معرّف الموارد المنتظم
`boolean`	`doesFileExist(String deviceFilePath)` لتحديد ما إذا كان الملف أو الدليل غير الفارغ متوفّرًا على الجهاز
`Integer`	`getUserId()` عرض رقم تعريف المستخدم الذي تمّت بدء تشغيل هذا المثيل به
`boolean`	`pullDir(String deviceFilePath, File localDir)` سحب محتويات الدليل بشكل متكرر من الجهاز باستخدام موفِّر المحتوى
`boolean`	`pullFile(String deviceFilePath, File localFile)` دالة استدعاء مقدّم المحتوى التي تسحب ملفًا من موقع معرّف URI إلى ملف محلي
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` ردّ اتصال مقدّم المحتوى الذي يدفع دليلاً إلى موقع معرّف الموارد المنتظم
`boolean`	`pushFile(File fileToPush, String deviceFilePath)` طلب استدعاء لموفّر المحتوى يُرسِل ملفًا إلى موقع معرّف الموارد المنتظم (URI).
`boolean`	`setUp()` تأكَّد من تثبيت حزمة apk الخاصة بتطبيق "مساعِد مقدّم المحتوى" وجاهزيتها للاستخدام.
`void`	`tearDown()` تنظيف الجهاز من مساعد موفّر المحتوى

الحقول

الأعمدة

public static final String[] COLUMNS

COLUMN_ABSOLUTE_PATH

public static final String COLUMN_ABSOLUTE_PATH

COLUMN_DIRECTORY

public static final String COLUMN_DIRECTORY

COLUMN_METADATA

public static final String COLUMN_METADATA

COLUMN_MIME_TYPE

public static final String COLUMN_MIME_TYPE

COLUMN_NAME

public static final String COLUMN_NAME

CONTENT_PROVIDER_URI

public static final String CONTENT_PROVIDER_URI

NO_RESULTS_STRING

public static final String NO_RESULTS_STRING

PACKAGE_NAME

public static final String PACKAGE_NAME

QUERY_INFO_VALUE

public static final String QUERY_INFO_VALUE

وظائف الإنشاء العامة

ContentProviderHandler

public ContentProviderHandler (ITestDevice device)

طريقة الإنشاء

المعلمات
`device`	`ITestDevice`

عمليات الرمي
`DeviceNotAvailableException`

ContentProviderHandler

public ContentProviderHandler (ITestDevice device, 
                Integer userId)

المعلمات
`device`	`ITestDevice`
`userId`	`Integer`

الطرق العامة

contentProviderNotFound

public boolean contentProviderNotFound ()

تعرِض هذه الدالة القيمة True إذا تعذّر تنفيذ إحدى العمليات بسبب عدم العثور على موفِّر المحتوى. يمكن محو هذه الرسالة من خلال تنفيذ setUp() بنجاح مرة أخرى.

المرتجعات
`boolean`

createEscapedContentUri

public static String createEscapedContentUri (String deviceFilePath)

عرض سلسلة عنوان URI الكاملة لمسار الجهاز المحدَّد، بعد ترميزها وتحويلها إلى أحرف ASCII لتجنُّب الأحرف غير المكوّنة من عنوان URL

المعلمات
`deviceFilePath`	`String`

المرتجعات
`String`

deleteFile

public boolean deleteFile (String deviceFilePath)

دالة استدعاء لموفّر المحتوى لحذف ملف في موقع معرّف الموارد المنتظم سيتم حذف الملف من محتوى الجهاز.

المعلمات
`deviceFilePath`	`String`: مسار الملف المطلوب حذفه على الجهاز

المرتجعات
`boolean`	صحيح إذا كان الإجراء ناجحًا، وخطأ في الحالات الأخرى

عمليات الرمي
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

لتحديد ما إذا كان الملف أو الدليل غير الفارغ متوفّرًا على الجهاز

المعلمات
`deviceFilePath`	`String`: المسار المطلق للملف على الجهاز للتحقّق من توفّره

المرتجعات
`boolean`	صحيح إذا كان الملف أو الدليل متوفّرًا، خطأ في الحالات الأخرى إذا كان الدليل فارغًا، سيتم عرض قيمة "خطأ" أيضًا.

عمليات الرمي
`DeviceNotAvailableException`

getUserId

public Integer getUserId ()

عرض رقم تعريف المستخدم الذي تمّت بدء تشغيل هذا المثيل به

المرتجعات
`Integer`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

سحب محتويات الدليل بشكل متكرر من الجهاز باستخدام موفِّر المحتوى

المعلمات
`deviceFilePath`	`String`: المسار المطلق للملف في المصدر البعيد
`localDir`	`File`: الدليل المحلي الذي يتم نقل الملفات إليه

المرتجعات
`boolean`	`true` إذا تم سحب الملف بنجاح. `false` بخلاف ذلك

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

pullFile

public boolean pullFile (String deviceFilePath, 
                File localFile)

دالة استدعاء مقدّم المحتوى التي تسحب ملفًا من موقع معرّف URI إلى ملف محلي

المعلمات
`deviceFilePath`	`String`: المسار على الجهاز الذي يتم سحب الملف منه
`localFile`	‫`File`: `ERROR(/File)` لتخزين المحتوى إذا لم تكن فارغة، سيتم استبدال المحتوى.

المرتجعات
`boolean`	صحيح إذا كان الإجراء ناجحًا، وخطأ في الحالات الأخرى

عمليات الرمي
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                 excludedDirectories)

ردّ اتصال مقدّم المحتوى الذي يدفع دليلاً إلى موقع معرّف الموارد المنتظم

المعلمات
`localFileDir`	`File`: الدليل المطلوب نقله
`deviceFilePath`	`String`: الموقع الجغرافي على الجهاز
`excludedDirectories`	: الأدلة غير المضمّنة في عملية الإرسال

المرتجعات
`boolean`	صحيح إذا كان الإجراء ناجحًا

عمليات الرمي
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File fileToPush, 
                String deviceFilePath)

طلب استدعاء لموفّر المحتوى يُرسِل ملفًا إلى موقع معرّف الموارد المنتظم (URI).

المعلمات
`fileToPush`	‫`File`: `ERROR(/File)` المطلوب إرساله إلى الجهاز
`deviceFilePath`	`String`: المسار على الجهاز الذي سيتم دفع الملف إليه

المرتجعات
`boolean`	صحيح إذا كان الإجراء ناجحًا، وخطأ في الحالات الأخرى

عمليات الرمي
	com.android.tradefed.device.DeviceNotAvailableException
	IllegalArgumentException
`DeviceNotAvailableException`

setUp

public boolean setUp ()

تأكَّد من تثبيت حزمة apk الخاصة بتطبيق "مساعِد مقدّم المحتوى" وجاهزيتها للاستخدام.

المرتجعات
`boolean`	صحيح إذا كان جاهزًا للاستخدام، خطأ في الحالات الأخرى

عمليات الرمي
`DeviceNotAvailableException`

tearDown

public void tearDown ()

تنظيف الجهاز من مساعد موفّر المحتوى

عمليات الرمي
`DeviceNotAvailableException`