ContentProviderHandler

public class ContentProviderHandler
extends Object

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

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

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

ملخّص

الثوابت

String COLUMN_ABSOLUTE_PATH

String COLUMN_DIRECTORY

String COLUMN_METADATA

String COLUMN_MIME_TYPE

String COLUMN_NAME

String CONTENT_PROVIDER_URI

String NO_RESULTS_STRING

String PACKAGE_NAME

String QUERY_INFO_VALUE

الحقول

public static final String[] COLUMNS

طُرق وضع التصميم العامة

ContentProviderHandler(ITestDevice device)

الشركة المصنِّعة

ContentProviderHandler(ITestDevice device, Integer userId)

الإجراءات العامة

boolean contentProviderNotFound()

تعرِض هذه الدالة القيمة True إذا تعذّرت إحدى العمليات بسبب عدم العثور على موفّر المحتوى.

static String createEscapedContentUri(String deviceFilePath)

تعرض هذه السمة سلسلة معرّف الموارد المنتظم (URI) الكاملة لمسار الجهاز المحدّد، مع إلغاء الترميز والترميز لتجنُّب الأحرف غير المتوافقة مع عناوين URL.

boolean deleteFile(String deviceFilePath)

دالة رد الاتصال لمزوّد المحتوى التي تحذف ملفًا في موقع معرّف الموارد المنتظم (URI).

boolean doesFileExist(String deviceFilePath)

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

IRunUtil getRunUtil()
Integer getUserId()

تعرِض هذه السمة رقم تعريف المستخدم الذي تمّت تهيئة هذا المثيل به.

boolean pullDir(String deviceFilePath, File localDir)

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

boolean pullFile(String deviceFilePath, File localFile)

دالة رد الاتصال الخاصة بموفّر المحتوى التي تسحب ملفًا من موقع معرّف الموارد المنتظم (URI) إلى ملف محلي

boolean pushDir(File localFileDir, String deviceFilePath, Set<String> excludedDirectories)

دالة رد الاتصال لمزوّد المحتوى التي تدفع دليلاً إلى موقع معرّف الموارد المنتظم (URI).

boolean pushFile(File fileToPush, String deviceFilePath)

دالة رد الاتصال لموفّر المحتوى التي ترسل ملفًا إلى موقع معرّف الموارد المنتظم (URI).

void setRunUtil(IRunUtil runUtil)
boolean setUp()

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

void tearDown()

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

الثوابت

COLUMN_ABSOLUTE_PATH

public static final String COLUMN_ABSOLUTE_PATH

القيمة الثابتة: "absolute_path"

COLUMN_DIRECTORY

public static final String COLUMN_DIRECTORY

القيمة الثابتة: "is_directory"

COLUMN_METADATA

public static final String COLUMN_METADATA

Constant Value: "metadata"

COLUMN_MIME_TYPE

public static final String COLUMN_MIME_TYPE

القيمة الثابتة: "mime_type"

COLUMN_NAME

public static final String COLUMN_NAME

Constant Value: "name"

CONTENT_PROVIDER_URI

public static final String CONTENT_PROVIDER_URI

Constant Value: "content://android.tradefed.contentprovider"

NO_RESULTS_STRING

public static final String NO_RESULTS_STRING

Constant Value: "No result found."

PACKAGE_NAME

public static final String PACKAGE_NAME

القيمة الثابتة: "android.tradefed.contentprovider"

QUERY_INFO_VALUE

public static final String QUERY_INFO_VALUE

Constant Value: "INFO"

الحقول

أعمدة

public static final String[] COLUMNS

طُرق وضع التصميم العامة

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) الكاملة لمسار الجهاز المحدّد، مع إلغاء الترميز والترميز لتجنُّب الأحرف غير المتوافقة مع عناوين URL.

المعلَمات
deviceFilePath String

المرتجعات
String

deleteFile

public boolean deleteFile (String deviceFilePath)

دالة رد الاتصال لمزوّد المحتوى التي تحذف ملفًا في موقع معرّف الموارد المنتظم (URI). سيتم حذف الملف من محتوى الجهاز.

المعلَمات
deviceFilePath String: مسار الملف المطلوب حذفه على الجهاز
المرتجعات
boolean صحيح إذا كان ناجحًا، خطأ في الحالات الأخرى
عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

المعلَمات
deviceFilePath ‫String: مسار الملف المطلق على الجهاز للتحقّق من توفّره.
المرتجعات
boolean صحيح إذا كان الملف أو الدليل متوفّرًا، وخطأ في الحالات الأخرى. إذا كان الدليل فارغًا، سيتم عرض القيمة False أيضًا.
عمليات الطرح
DeviceNotAvailableException

getRunUtil

public IRunUtil getRunUtil ()

المرتجعات
IRunUtil

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: File لتخزين المحتوى فيه في حال عدم توفّر قيمة، سيتم استبدال المحتوى.
المرتجعات
boolean صحيح إذا كان ناجحًا، خطأ في الحالات الأخرى
عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                Set<String> excludedDirectories)

دالة رد الاتصال لمزوّد المحتوى التي تدفع دليلاً إلى موقع معرّف الموارد المنتظم (URI).

المعلَمات
localFileDir File: الدليل المطلوب إرساله
deviceFilePath String: الموقع الجغرافي على الجهاز
excludedDirectories ‫Set: الأدلة غير المضمّنة في عملية الدفع
المرتجعات
boolean صحيح إذا كانت العملية ناجحة
عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pushFile

public boolean pushFile (File fileToPush, 
                String deviceFilePath)

دالة رد الاتصال لموفّر المحتوى التي ترسل ملفًا إلى موقع معرّف الموارد المنتظم (URI).

المعلَمات
fileToPush File: File التي سيتم إرسالها إلى الجهاز
deviceFilePath String: المسار على الجهاز الذي سيتم إرسال الملف إليه.
المرتجعات
boolean صحيح إذا كان ناجحًا، خطأ في الحالات الأخرى
عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
java.lang.IllegalArgumentException
DeviceNotAvailableException
IllegalArgumentException

setRunUtil

public void setRunUtil (IRunUtil runUtil)

المعلَمات
runUtil IRunUtil

setUp

public boolean setUp ()

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

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

tearDown

public void tearDown ()

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

عمليات الطرح
DeviceNotAvailableException