נוסף ברמת API 34
זמין גם בתוספים 4 לשירותי מודעות

סיכום: קבועים שעברו בירושה | שדות | מנצחים | שיטות | שיטות שעברו בירושה

SandboxedSdk (ארגז חול)

public final class SandboxedSdk
extends Object implements Parcelable

java.lang.Object
↳	android.app.sdksandbox.SandboxedSdk

---

מייצג ערכת SDK שנטענה בתהליך ארגז החול.

הוחזרה בתגובה ל-SdkSandboxManager#loadSdk, בעקבות הצלחה. האפליקציה יכולה כדי לקבל אותו, צריך להתקשר אל SdkSandboxManager#loadSdk. הוא צריך להשתמש באובייקט הזה כדי לקבל ל-SDK דרך getInterface().

ה-SDK צריך ליצור אותה כשמתבצעת קריאה אל SandboxedSdkProvider#onLoadSdk, ולשחרר את כל הפניות אליו כשמתבצעת קריאה אל SandboxedSdkProvider#beforeUnloadSdk(). בנוסף, ה-SDK לא אמור לקבל קריאות ל-IBinder שהוחזרו מ-getInterface() אחרי בוצעה שיחה אל SandboxedSdkProvider#beforeUnloadSdk().

סיכום

קבועים שעברו בירושה

מהממשק android.os.Parcelable int CONTENTS_FILE_DESCRIPTOR ביט מתאר שנעשה בו שימוש עם describeContents(): מציין הייצוג הקבוע של האובייקט Parcelable כולל מתאר קובץ. int PARCELABLE_WRITE_RETURN_VALUE סימון לשימוש עם writeToParcel(Parcel, int): האובייקט שנכתב הוא ערך מוחזר, כלומר תוצאה של פונקציה כמו "Parcelable someFunction()", "void someFunction(out Parcelable)", או "void someFunction(inout Parcelable)".

שדות
public static final Creator<SandboxedSdk>	CREATOR

בנאים ציבוריים
SandboxedSdk(IBinder sdkInterface) יצירת אובייקט SandboxedSdk.

שיטות ציבוריות
int	describeContents() תיאור סוגי העצמים המיוחדים שכלולים בחבילה הזו הייצוגים המשולבים של המכונה.
IBinder	getInterface() מחזירה את הממשק ל-SDK שנטען בתגובה ל-SdkSandboxManager.loadSdk(String, Bundle, Executor, OutcomeReceiver).
SharedLibraryInfo	getSharedLibraryInfo() הפונקציה מחזירה את הערך SharedLibraryInfo של ה-SDK.
void	writeToParcel(Parcel dest, int flags) יש לשטח את האובייקט ל-Parcel

שיטות שעברו בירושה
מהכיתה java.lang.Object Object clone() יצירה ומחזירה של עותק של האובייקט הזה. boolean equals(Object obj) מציין אם אובייקט אחר הוא "שווה ל" הזה. void finalize() שיחה מופעלת על ידי אוסף האשפה על עצם כלשהו במהלך איסוף אשפה קובע שאין יותר הפניות לאובייקט. final Class<?> getClass() הפונקציה מחזירה את המחלקה של סביבת זמן הריצה של Object. int hashCode() מחזירה ערך גיבוב (hash) של האובייקט. final void notify() הוצאת שרשור יחיד שממתין לאובייקט מעקב. final void notifyAll() פעולה זו מוציאה את כל השרשורים שממתינים למסך של האובייקט הזה. String toString() מחזירה ייצוג במחרוזת של האובייקט. final void wait(long timeoutMillis, int nanos) גורם לשרשור הנוכחי להמתין עד שהוא מופעל, בדרך כלל באמצעות התראה או הפרעה, או עד מתבצע פרק זמן מסוים בזמן אמת. final void wait(long timeoutMillis) גורם לשרשור הנוכחי להמתין עד שהוא מופעל, בדרך כלל באמצעות התראה או הפרעה, או עד מתבצע פרק זמן מסוים בזמן אמת. final void wait() גורם לשרשור הנוכחי להמתין עד שהוא מופעל, בדרך כלל על ידי קבלת התראה או הפרעה.
מהממשק android.os.Parcelable abstract int describeContents() תיאור סוגי העצמים המיוחדים שכלולים בחבילה הזו הייצוגים המשולבים של המכונה. abstract void writeToParcel(Parcel dest, int flags) יש לשטח את האובייקט ל-Parcel

שדות

CREATOR

נוסף ברמת API 34
זמין גם בתוספים 4 לשירותי מודעות

public static final Creator<SandboxedSdk> CREATOR

בנאים ציבוריים

SandboxedSdk (ארגז חול)

נוסף ברמת API 34
זמין גם בתוספים 4 לשירותי מודעות

public SandboxedSdk (IBinder sdkInterface)

יצירת אובייקט SandboxedSdk.

פרמטרים
sdkInterface	IBinder: הממשק של ה-SDK. זו תהיה נקודת הכניסה ל-SDK עם ארגז חול (sandbox) עבור האפליקציה. ה-SDK אמור להשאיר את השדה הזה בתוקף עד שהוא נטען ב-Sandbox, וגם קריאות נכשלות לממשק הזה לאחר סיום הטעינה שלו. אפשר לאחזר את הממשק הזה מאוחר יותר באמצעות getInterface(). הערך הזה לא יכול להיות null.

שיטות ציבוריות

תיאור התוכן

נוסף ברמת API 34

public int describeContents ()

תיאור סוגי העצמים המיוחדים שכלולים בחבילה הזו הייצוגים המשולבים של המכונה. לדוגמה, אם האובייקט לכלול מתאר קובץ בפלט של writeToParcel(android.os.Parcel, int), הערך המוחזר בשיטה הזו חייב לכלול את ביט אחד (CONTENTS_FILE_DESCRIPTOR).

החזרות
int	מסכת ביט שמציינת את הקבוצה של סוגי האובייקטים המיוחדים שמעורבים של המופע הזה של אובייקט Parcelable. הערך הוא 0 או CONTENTS_FILE_DESCRIPTOR

getInterface

נוסף ברמת API 34
זמין גם בתוספים 4 לשירותי מודעות

public IBinder getInterface ()

מחזירה את הממשק ל-SDK שנטען בתגובה ל-SdkSandboxManager.loadSdk(String, Bundle, Executor, OutcomeReceiver). מוחזר ממשק null אם Binder מאז יפסיקו להיות זמינות בתגובה להסרת ה-SDK.

החזרות
IBinder

getSharedLibraryInfo

נוסף ברמת API 34
זמין גם בתוספים 5 של שירותי מודעות

public SharedLibraryInfo getSharedLibraryInfo ()

הפונקציה מחזירה את הערך SharedLibraryInfo של ה-SDK.

החזרות
SharedLibraryInfo	הערך הזה לא יכול להיות null.

קליעות
IllegalStateException	אם שירות המערכת עדיין לא צירף את SharedLibraryInfo לאובייקט SandboxedSdk שנשלח על ידי ה-SDK.

WriteToParcel

נוסף ברמת API 34

public void writeToParcel (Parcel dest, 
                int flags)

יש לשטח את האובייקט ל-Parcel

פרמטרים
dest	Parcel: הערך הזה לא יכול להיות null.
flags	int: דגלים נוספים לגבי אופן הכתיבה של האובייקט. יכול להיות 0 או Parcelable.PARCELABLE_WRITE_RETURN_VALUE. הערך הוא 0 או שילוב של Parcelable.PARCELABLE_WRITE_RETURN_VALUE, עם android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES