החל מ-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

טיפול (handler) שמציג באופן מופשט את האינטראקציות עם ספק התוכן ומאפשר להשתמש בספק התוכן בצד המכשיר לפעולות שונות.

כל ההטמעות בכיתה הזו צריכות להביא בחשבון את המשתמש שפועל כרגע במכשיר.

סיכום

שדות
`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 המלאה של נתיב המכשיר שצוין, עם תו בריחה (escape) וקידוד כדי למנוע תווים שאינם כתובות URL.
`boolean`	`deleteFile(String deviceFilePath)` קריאה חוזרת (callback) של ספק התוכן למחיקה של קובץ במיקום ה-URI.
`boolean`	`doesFileExist(String deviceFilePath)` הפונקציה קובעת אם הקובץ או הספרייה שאינם ריקים קיימים במכשיר.
`Integer`	`getUserId()` הפונקציה מחזירה את מזהה המשתמש שבו מופעלת האינטראקציה הראשונה עם המופע הזה.
`boolean`	`pullDir(String deviceFilePath, File localDir)` אחזור חזרה (recursive) של תוכן הספריות מהמכשיר באמצעות ספק התוכן.
`boolean`	`pullFile(String deviceFilePath, File localFile)` קריאה חוזרת (callback) של ספק התוכן שמושכת קובץ ממיקום ה-URI לקובץ מקומי.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` קריאה חוזרת של ספק תוכן שמעבירה ספרייה למיקום ה-URI.
`boolean`	`pushFile(File fileToPush, String deviceFilePath)` קריאה חוזרת (callback) של ספק התוכן שמעבירה קובץ למיקום ה-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 המלאה של נתיב המכשיר שצוין, עם תו בריחה (escape) וקידוד כדי למנוע תווים שאינם כתובות URL.

פרמטרים
`deviceFilePath`	`String`

החזרות
`String`

deleteFile

public boolean deleteFile (String deviceFilePath)

קריאה חוזרת (callback) של ספק התוכן למחיקה של קובץ במיקום ה-URI. הקובץ יימחק מהתוכן במכשיר.

פרמטרים
`deviceFilePath`	`String`: הנתיב במכשיר של הקובץ שרוצים למחוק.

החזרות
`boolean`	True אם הפעולה בוצעה בהצלחה, False אחרת

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

הפונקציה קובעת אם הקובץ או הספרייה שאינם ריקים קיימים במכשיר.

פרמטרים
`deviceFilePath`	`String`: הנתיב המוחלט של הקובץ במכשיר לבדיקה אם הוא קיים.

החזרות
`boolean`	הערך יהיה True אם הקובץ או הספרייה קיימים, ו-False אחרת. אם הספרייה ריקה, גם היא תחזיר את הערך False.

זריקות
`DeviceNotAvailableException`

getUserId

public Integer getUserId ()

הפונקציה מחזירה את מזהה המשתמש שבו מופעלת האינטראקציה הראשונה עם המופע הזה.

החזרות
`Integer`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

אחזור חזרה (recursive) של תוכן הספריות מהמכשיר באמצעות ספק התוכן.

פרמטרים
`deviceFilePath`	`String`: הנתיב המוחלט של קובץ המקור המרוחק
`localDir`	`File`: הספרייה המקומית שאליה יישלפו הקבצים

החזרות
`boolean`	`true` אם הקובץ נשלף בהצלחה. `false` אחרת.

זריקות
`DeviceNotAvailableException`	אם החיבור למכשיר נותק ולא ניתן לשחזר אותו.

pullFile

public boolean pullFile (String deviceFilePath, 
                File localFile)

קריאה חוזרת (callback) של ספק התוכן שמושכת קובץ ממיקום ה-URI לקובץ מקומי.

פרמטרים
`deviceFilePath`	`String`: הנתיב במכשיר שממנו רוצים למשוך את הקובץ.
`localFile`	`File`: ה-`ERROR(/File)` שבו יישמרו התוכן. אם הוא לא ריק, התוכן יוחלף.

החזרות
`boolean`	True אם הפעולה בוצעה בהצלחה, False אחרת

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pushDir

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

קריאה חוזרת של ספק תוכן שמעבירה ספרייה למיקום ה-URI.

פרמטרים
`localFileDir`	`File`: הספרייה שרוצים לדחוף
`deviceFilePath`	`String`: המיקום במכשיר
`excludedDirectories`	: ספריות שלא נכללות בהעברה.

החזרות
`boolean`	True אם הפעולה בוצעה בהצלחה

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File fileToPush, 
                String deviceFilePath)

קריאה חוזרת (callback) של ספק התוכן שמעבירה קובץ למיקום ה-URI.

פרמטרים
`fileToPush`	`File`: ה-`ERROR(/File)` שרוצים לדחוף למכשיר.
`deviceFilePath`	`String`: הנתיב במכשיר שאליו רוצים לדחוף את הקובץ.

החזרות
`boolean`	True אם הפעולה בוצעה בהצלחה, False אחרת

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
	IllegalArgumentException
`DeviceNotAvailableException`

setUp

public boolean setUp ()

מוודאים שה-APK של הכלי לעזרת ספק התוכן מותקן ומוכן לשימוש.

החזרות
`boolean`	הערך True אם הנכס מוכן לשימוש, ו-False אחרת.

זריקות
`DeviceNotAvailableException`

tearDown

public void tearDown ()

לנקות את המכשיר מהעזרה של ספק התוכן.

זריקות
`DeviceNotAvailableException`