החל מ-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 שמבצע הפשטה של האינטראקציות עם ספק התוכן ומאפשר להשתמש בספק התוכן בצד המכשיר לפעולות שונות.

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

סיכום

ערכים קבועים
`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`

Constructors ציבוריים
`ContentProviderHandler(ITestDevice device)` Constructor.
`ContentProviderHandler(ITestDevice device, Integer userId)`

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

ערך קבוע: "metadata"

COLUMN_MIME_TYPE

public static final String COLUMN_MIME_TYPE

ערך קבוע: "mime_type"

COLUMN_NAME

public static final String COLUMN_NAME

ערך קבוע: "name"

CONTENT_PROVIDER_URI

public static final String CONTENT_PROVIDER_URI

ערך קבוע: "content://android.tradefed.contentprovider"

NO_RESULTS_STRING

public static final String NO_RESULTS_STRING

ערך קבוע: "No result found."

PACKAGE_NAME

public static final String PACKAGE_NAME

ערך קבוע: "android.tradefed.contentprovider"

QUERY_INFO_VALUE

public static final String QUERY_INFO_VALUE

ערך קבוע: "INFO"

שדות

COLUMNS

public static final String[] COLUMNS

Constructors ציבוריים

ContentProviderHandler

public ContentProviderHandler (ITestDevice device)

Constructor.

פרמטרים
`device`	`ITestDevice`

זריקות
`DeviceNotAvailableException`

ContentProviderHandler

public ContentProviderHandler (ITestDevice device, 
                Integer userId)

פרמטרים
`device`	`ITestDevice`
`userId`	`Integer`

‫methods ציבוריים

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`

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)

קריאה חוזרת (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`

setRunUtil

public void setRunUtil (IRunUtil runUtil)

פרמטרים
`runUtil`	`IRunUtil`

setUp

public boolean setUp ()

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

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

זריקות
`DeviceNotAvailableException`

tearDown

public void tearDown ()

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

זריקות
`DeviceNotAvailableException`