החל משנת 2026, כדי להתאים למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור ולתרום ל-AOSP, צריך להשתמש ב-android-latest-release. הענף android-latest-release manifest תמיד יפנה לגרסה האחרונה שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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, Set<String> 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`

הקפצת הודעות שגיאה (throw)
`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

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

ההגדרה קובעת אם הקובץ או הספרייה הלא ריקה קיימים במכשיר.

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

החזרות
`boolean`	‫True אם הקובץ או הספרייה קיימים, אחרת False. אם הספרייה ריקה, הפונקציה תחזיר גם False.

הקפצת הודעות שגיאה (throw)
`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` אחרת.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

pullFile

public boolean pullFile (String deviceFilePath, 
                File localFile)

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

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

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

הקפצת הודעות שגיאה (throw)
	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`	‫True אם הפעולה הצליחה

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File fileToPush, 
                String deviceFilePath)

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

פרמטרים
`fileToPush`	‫`File`: ה-`File` שיועבר למכשיר.
`deviceFilePath`	‫`String`: הנתיב במכשיר שאליו רוצים להעביר את הקובץ.

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

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.device.DeviceNotAvailableException
	java.lang.IllegalArgumentException
`DeviceNotAvailableException`
`IllegalArgumentException`

setRunUtil

public void setRunUtil (IRunUtil runUtil)

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

setUp

public boolean setUp ()

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

tearDown

public void tearDown ()

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`