סקירה כללית של משאבי האפליקציה

המשאבים הם הקבצים הנוספים והתוכן הסטטי שבהם הקוד משתמש, כמו מפות סיביות, פריסה הגדרות, מחרוזות ממשק משתמש, הוראות לאנימציה ועוד.

תמיד צריך להוציא את המשאבים של האפליקציה, כמו תמונות ומחרוזות, כדי לנהל אותם באופן עצמאי. כמו כן, לספק מקורות מידע חלופיים תצורות ספציפיות של מכשירים על ידי קיבוץ שלהם בספריות משאבים בעלות שם ייחודי. בשעה בזמן הריצה, Android משתמש במשאב המתאים בהתאם להגדרה הנוכחית. עבור לדוגמה, ייתכן שתרצו לספק פריסה שונה של ממשק המשתמש, בהתאם לגודל המסך או מחרוזות, בהתאם להגדרת השפה.

אחרי הוצאת המשאבים של האפליקציה באופן חיצוני, אפשר לגשת אליהם באמצעות מזהי המשאבים שנוצרים במחלקה R של הפרויקט. במסמך הזה נסביר איך לקבץ את המשאבים בפרויקט Android. הוא גם מראה איך כדי לספק משאבים חלופיים לתצורות מכשירים ספציפיות ואז לגשת אליהם בקוד האפליקציה או בקובצי XML אחרים.

סוגי המשאבים של הקבוצה

מציבים כל סוג משאב בספריית משנה ספציפית של הפרויקט ספריית res/. לדוגמה, כך היררכיית הקבצים בפרויקט פשוט:

MyProject/
    src/
        MyActivity.java
    res/
        drawable/
            graphic.png
        layout/
            main.xml
            info.xml
        mipmap/
            icon.png
        values/
            strings.xml

הספרייה res/ מכילה את כל המשאבים ספריות משנה: משאב תמונה, שני משאבי פריסה, ספריית mipmap/ למרכז האפליקציות וקובץ משאב מסוג מחרוזת. מקור המידע שמות הספריות חשובים והם מתוארים בטבלה 1.

הערה: מידע נוסף על השימוש בתיקיות ה-mipmap זמין במאמר להציב סמלי אפליקציות בספריות של מיפוי במפה.

טבלה 1. ספריות משאבים נתמך בספריית הפרויקט res/.

זהירות: אף פעם אל תשמרו קובצי משאבים ישירות בתוך ספריית res/. הוא גורם לשגיאת מהדר.

כדי לקבל מידע נוסף על כל סוג של משאבים, אפשר לעיין במאמר סקירה כללית של סוגי משאבים.

המשאבים שאתם שומרים בספריות המשנה ומוגדרים בטבלה 1 מוגדרים כברירת מחדל. במשאבי אנוש. כלומר המשאבים האלה מגדירים את עיצוב ברירת המחדל והתוכן של האפליקציה. עם זאת, סוגים שונים של מכשירים מבוססי Android עשויים לדרוש סוגים שונים של משאבים.

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

מתן מקורות מידע חלופיים

רוב האפליקציות מספקות משאבים חלופיים לתמיכה במכשיר ספציפי הגדרות אישיות. לדוגמה, אפשר לכלול משאבים שניתנים להזזה חלופיים דחיסות מסך ומשאבים חלופיים למחרוזות לשפות שונות. בזמן הריצה, Android מזהה את תצורת המכשיר הנוכחית וטוען את משאבים לאפליקציה.

איור 1. שני מכשירים שמשתמשים במשאבי פריסה שונים בהתאם לגודל המסך.

כדי לציין חלופות ספציפיות להגדרות אישיות לקבוצת משאבים, צריך לבצע את הפעולות הבאות:

1. יצירת ספרייה חדשה ב-res/ ששמה מופיע בטופס <resources_name>-<qualifier>.
   • <resources_name> הוא שם הספרייה של ברירת המחדל המתאימה משאבים (מוגדרים בטבלה 1).
   • <qualifier> הוא שם שמציין הגדרה אישית מסוימת שעבורם רוצים להשתמש במשאבים האלה (מוגדר בטבלה 2).

   אפשר לצרף יותר ממחרוזת <qualifier> אחת. הפרדה אחד עם מקף.

   זהירות: כשמצרפים מספר ערכים מזהים, צריך ומציבים אותן לפי אותו סדר שבו הן מופיעות בטבלה 2. אם ערכי השוויון מסודרים באופן שגוי, המערכת מתעלמת מהמשאבים.

2. שומרים את המשאבים החלופיים המתאימים בספרייה החדשה. קובצי המשאבים חייבים להיות שהשם יהיה זהה לגמרי לקובצי ברירת המחדל של המשאבים.

לדוגמה, ריכזנו כאן כמה מקורות מידע ומשאבים חלופיים כברירת מחדל:

res/
    drawable/
        icon.png
        background.png
    drawable-hdpi/
        icon.png
        background.png

ערך האישור hdpi מציין שהמשאבים בספרייה הזו מיועדים למכשירים עם מסך עם צפיפות גבוהה. התמונות בספריות שניתנות להזזה אלה מותאמות לגודל דחיסות המסך, אבל שמות הקבצים זהים כמעט זהים. כך, מזהה המשאב שבו משתמשים כדי להפנות אל icon.png או התמונה background.png תמיד זהה. Android בוחר את של כל משאב המתאים ביותר למכשיר הנוכחי, על ידי השוואת המכשיר את ההגדרות האישיות עם המפרידים בשם ספריית המשאבים.

זהירות: כשמגדירים משאב חלופי, צריך להקפיד להגדיר גם את המשאב בהגדרות ברירת המחדל. אחרת, האפליקציה עשויה להיתקל בזמן ריצה חריגים כשהמכשיר משנה הגדרה אישית. לדוגמה, אם תוסיפו מחרוזת רק values-en ולא values, האפליקציה עלולה להיתקל ב חריג Resource Not Found כאשר המשתמש משנה את שפת ברירת המחדל של המערכת.

טבלה 2 מפרטת את מגדירי ההגדרות החוקיים לפי סדר הקדימות. אפשר להוסיף מספר מגדירים לשם ספרייה אחד על ידי הפרדה בין כל תוחם באמצעות מקף. אם משתמשים מספר מגדירים לספריית משאבים, צריך להוסיף אותם לשם הספרייה לפי הסדר מפורטים בטבלה.

טבלה 2. תוחם ההגדרות האישיות שמות.

הערה: לא כל הגרסאות של Android תומכות בכל ערכי האישור. שימוש במאפיין חדש באופן מרומז מוסיף את תוחם גרסת הפלטפורמה כדי שמכשירים ישנים יותר יוכלו להתעלם ממנו. לדוגמה, שימוש ב- תוחם w600dp כולל באופן אוטומטי את הערך v13, כי תוחם הרוחב הזמין היה חדש ברמת API 13. כדי להימנע מבעיות, מומלץ תמיד לכלול קבוצה של משאבי ברירת מחדל (קבוצת משאבים ללא מאפיינים). מידע נוסף זמין במאמר הקטע התאמה הטובה ביותר למכשירים עם משאבים.

כללים למתן שמות למזהה

הנה כמה כללים לגבי השימוש בשמות של מגדיר התצורה:

• ניתן לציין מספר ערכי אישור לקבוצה אחת של משאבים, ולהפריד ביניהם במקפים. עבור לדוגמה, המדיניות drawable-en-rUS-land חלה על מכשירים באנגלית ארה"ב בפריסה לרוחב לכיוון מסוים.
• ערכי ההפרדה חייבים להיות בסדר שמוצג בטבלה 2.
  • שגוי: drawable-hdpi-port/
  • נכון: drawable-port-hdpi/
• אי אפשר ליצור ספריות משאבים חלופיות כספריות מקוננות. לדוגמה, לא ניתן לכתוב res/drawable/drawable-en/
• הערכים לא תלויי-רישיות. המהדר של המשאבים ממיר שמות ספריות לאותיות קטנות לפני העיבוד כדי למנוע בעיות הקשורות לאותיות לא תלויות-רישיות. מערכות קבצים. כל שימוש באותיות רישיות בשמות נועד רק לשיפור הקריאוּת.
• יש תמיכה בערך אחד בלבד לכל סוג מזהה. לדוגמה, אם רוצים להשתמש אותם קבצים ניתנים להזזה לספרד ולצרפת, לא ניתן להשתמש בספרייה בשם drawable-es-fr/. במקום זאת, אתם צריכים שתי ספריות משאבים, כמו drawable-es/ ו-drawable-fr/, שמכילים את הקבצים המתאימים. עם זאת, לא צריך לשכפל את הקבצים בשני המיקומים בפועל. במקום זאת, יכול ליצור כינוי למשאב, כפי שמתואר במאמר יצירה משאבים חלופיים.

לאחר שמירת משאבים חלופיים בספריות עם שם את המאפיינים האלה, מערכת Android מחילה את המשאבים באפליקציה באופן אוטומטי בהתאם ההגדרות האישיות הנוכחיות של המכשיר. בכל פעם שנשלחת בקשה למשאב, מערכת Android בודקת אם יש מקור חלופי את ספריות המשאבים שמכילות את קובץ המשאב המבוקש, ואז מוצאת את את מקור המידע המתאים ביותר.

אם אין מקורות מידע חלופיים שתואמים לחיפוש בתצורה מסוימת של המכשיר, מערכת Android משתמשת במשאבי ברירת המחדל המתאימים – קבוצת משאבים לסוג משאב מסוים שלא כולל הגדרות אישיות מגדיר.

יצירת משאבים חלופיים

כשיש משאב שאתם רוצים להשתמש בו בכמה מכשירים אבל לא רוצים לספק אותו כמשאב ברירת מחדל, אין צורך להוסיף אותו ביותר מספריית משאבים חלופית אחת. במקום זאת, אפשר ליצור חלופה משאב שמשמש ככינוי של משאב שנשמר בספריית המשאבים המוגדרת כברירת מחדל.

הערה: לא כל המשאבים מציעים מנגנון שמאפשר ליצור כינוי למשאב אחר. בפרט, אנימציה, תפריט, RAW ואחרים שלא צוינו המשאבים בספרייה xml/ לא מציעים את התכונה הזו.

לדוגמה, נניח שיש לך סמל אפליקציה, icon.png, ואתה זקוק לגרסה ייחודית של אותו ללוקאלים שונים. עם זאת, שני לוקאלים, אנגלית-קנדית וצרפתית-קנדית, משתמשים באותה גרסה. אין צורך להעתיק את אותה התמונה במאגר המשאבים גם באנגלית-קנדית וגם בצרפתית-קנדית. במקום זאת, אפשר לשמור את התמונה שמשמשת גם לכל שם שאינו icon.png, כמו icon_ca.png, ו-put אותו בספריית ברירת המחדל res/drawable/. לאחר מכן יוצרים קובץ icon.xml ב-res/drawable-en-rCA/ וב-res/drawable-fr-rCA/ שמפנה אל icon_ca.png באמצעות הרכיב <bitmap>. כך ניתן לאחסן רק גרסה אחת של קובץ PNG ושני קובצי XML קטנים שמצביעים אליו. ראו את הדוגמאות בקטעים הבאים. לקבלת פרטים.

ניתן להזזה

כדי ליצור כינוי למכשיר קיים להזזה, צריך להשתמש ברכיב <drawable>:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <drawable name="icon">@drawable/icon_ca</drawable>
</resources>

אם יש לך אפשרות לשמור את הקובץ הזה כ-icon.xml במקום אחר הוא עבר הידור של ספריית המשאבים, כמו res/values-en-rCA/. למשאב שאפשר להפנות אליו בתור R.drawable.icon, אבל למעשה כינוי למשאב R.drawable.icon_ca, נשמרה ברשימה res/drawable/.

פריסה

כדי ליצור כינוי לפריסה קיימת, צריך להשתמש ב-<include> רכיב, מוקף ב-<merge>:

<?xml version="1.0" encoding="utf-8"?>
<merge>
    <include layout="@layout/main_ltr"/>
</merge>

אם הקובץ הזה יישמר בתור main.xml, הוא יעובד למשאב שאפשר להפנות אליו בתור R.layout.main, אבל הוא למעשה כינוי של R.layout.main_ltr משאב.

מחרוזות וערכים פשוטים אחרים

כדי ליצור כינוי למחרוזת קיימת, משתמשים במזהה המשאב של מחרוזת בתור הערך של המחרוזת החדשה:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="hello">Hello</string>
    <string name="hi">@string/hello</string>
</resources>

המשאב R.string.hi הוא עכשיו כינוי של R.string.hello.

ערכים פשוטים אחרים פועלים באותה דרך, למשל צבעים:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <color name="red">#f00</color>
    <color name="highlight">@color/red</color>
</resources>

גישה למשאבי האפליקציה

אחרי שמספקים משאב באפליקציה, אפשר להחיל אותו על ידי: שמפנה למזהה המשאב שלו. כל מזהי המשאבים מוגדרים במחלקה R של הפרויקט, הכלי aapt יוצר באופן אוטומטי.

כשהאפליקציה עוברת הידור, aapt יוצר את המחלקה R, שמכילה מזהי המשאבים של כל המשאבים בספרייה res/. לכל סוג משאב, יש תת-מחלקה R, כמו R.drawable לכל המשאבים שניתנים להזזה. לכל משאב מהסוג הזה יש מספר שלם סטטי, למשל R.drawable.icon. המספר השלם הזה הוא מזהה המשאב שבו אפשר להשתמש כדי לאחזר את המשאב.

המחלקה R היא המקום שבו צוינו מזהי המשאבים, אבל לא צריך היכנסו לשם כדי לגלות מזהה משאב. מזהה משאב תמיד מורכב מהפרטים הבאים:

• סוג המשאב: כל משאב מקובץ ל"סוג", כמו string, drawable ו-layout. אפשר לקרוא מידע נוסף על הסוגים השונים במאמר סקירה כללית של סוגי המשאבים.
• שם המשאב, שהוא שם הקובץ לא כולל את התוסף או את הערך במאפיין XML android:name, אם הוא ערך פשוט, כמו מחרוזת.

יש שתי דרכים לגשת למשאב:

• בקוד: משתמש במספר שלם סטטי ממחלקה משנית של R class, כמו:

  R.string.hello

  string הוא סוג המשאב ו-hello הוא שם המשאב. יש הרבה ממשקי API של Android שיכולים לגשת למשאבים שלכם כשמציינים מזהה משאב בפורמט הזה. לקבלת מידע נוסף מידע נוסף ראה את הקטע גישה למשאבים בקוד.

• ב-XML: באמצעות תחביר XML מיוחד שתואם מזהה המשאב שהוגדר במחלקה R, למשל:

  @string/hello

  string הוא סוג המשאב ו-hello הוא שם המשאב. אפשר להשתמש במשאב XML בכל מקום שבו צפוי ערך שתספקו במשאב. לקבלת מידע נוסף מידע נוסף זמין בקטע גישה למשאבים מ-XML.

גישה למשאבים בקוד

כדי להשתמש במשאב בקוד, תוכלו להעביר את מזהה המשאב כפרמטר של שיטה. עבור לדוגמה, אפשר להגדיר ש-ImageView ישתמש בפונקציה res/drawable/myimage.png משאב שמשתמש ב-setImageResource():

val imageView = findViewById(R.id.myimageview) as ImageView
imageView.setImageResource(R.drawable.myimage)

ImageView imageView = (ImageView) findViewById(R.id.myimageview);
imageView.setImageResource(R.drawable.myimage);

אפשר גם לאחזר משאבים בודדים באמצעות methods ב-Resources, שבהן אפשר לקבל מופע של עם getResources().

תחביר

זהו התחביר להפניה למשאב בקוד:

[<package_name>.]R.<resource_type>.<resource_name>

• <package_name> הוא שם החבילה שבה המשאב נמצא (לא שנדרשים כשאתם מפנים למשאבים מהחבילה שלכם).
• <resource_type> הוא מחלקה המשנה R של סוג המשאב.
• <resource_name> הוא שם הקובץ של המשאב ללא סיומת או ערך מאפיין android:name ברכיב ה-XML, בערכים פשוטים.

עבור כדי לקבל מידע נוסף על כל סוגי משאבים ואיך להפנות אליהם, ראו סקירה כללית של סוגי משאבים.

תרחישים לדוגמה

יש הרבה שיטות שמקבלות פרמטר של מזהה משאב, ואפשר לאחזר משאבים באמצעות ב-Resources. שלך יכול לקבל מופע של Resources באמצעות Context.getResources().

הנה כמה דוגמאות לגישה למשאבים בקוד:

// Load a background for the current screen from a drawable resource.
window.setBackgroundDrawableResource(R.drawable.my_background_image)

// Set the Activity title by getting a string from the Resources object, because
//  this method requires a CharSequence rather than a resource ID.
window.setTitle(resources.getText(R.string.main_title))

// Load a custom layout for the current screen.
setContentView(R.layout.main_screen)

// Set a slide in animation by getting an Animation from the Resources object.
flipper.setInAnimation(AnimationUtils.loadAnimation(this,
        R.anim.hyperspace_in))

// Set the text on a TextView object using a resource ID.
val msgTextView = findViewById(R.id.msg) as TextView
msgTextView.setText(R.string.hello_message)

// Load a background for the current screen from a drawable resource.
getWindow().setBackgroundDrawableResource(R.drawable.my_background_image) ;

// Set the Activity title by getting a string from the Resources object, because
//  this method requires a CharSequence rather than a resource ID.
getWindow().setTitle(getResources().getText(R.string.main_title));

// Load a custom layout for the current screen.
setContentView(R.layout.main_screen);

// Set a slide in animation by getting an Animation from the Resources object.
flipper.setInAnimation(AnimationUtils.loadAnimation(this,
        R.anim.hyperspace_in));

// Set the text on a TextView object using a resource ID.
TextView msgTextView = (TextView) findViewById(R.id.msg);
msgTextView.setText(R.string.hello_message);

זהירות: אל תשנו את הקובץ R.java באופן ידני. הוא נוצר על ידי הכלי aapt כשהפרויקט שעברה הידור. השינויים יבוטלו בפעם הבאה שתתבצע הידור.

גישה למשאבים מ-XML

אפשר להגדיר ערכים למאפיינים ורכיבים מסוימים של XML באמצעות הפניה למשאב קיים. אתה עושה זאת לעתים קרובות כאשר אתה יוצר קובצי פריסה, כדי לספק מחרוזות ותמונות לווידג'טים.

לדוגמה, אם מוסיפים Button לפריסה, משתמשים ב- משאב מחרוזת לטקסט הלחצן:

<Button
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="@string/submit" />

תחביר

זהו התחביר להפניה למשאב במשאב XML:

@[<package_name>:]<resource_type>/<resource_name>

• <package_name> הוא שם החבילה שבה נמצא המשאב (לא שנדרשת כשפונים למשאבים מאותה חבילה).
• <resource_type> הוא/היא מחלקה משנית R לסוג המשאב.
• <resource_name> הוא שם הקובץ של המשאב ללא סיומת או ערך מאפיין android:name ברכיב ה-XML, בשביל בערכים פשוטים.

עבור כדי לקבל מידע נוסף על כל סוגי משאבים ואיך להפנות אליהם, ראו סקירה כללית של סוגי משאבים.

תרחישים לדוגמה

במקרים מסוימים, צריך להשתמש במשאב עבור ערך ב-XML, למשל כדי להחיל תמונה שניתן לצייר. לווידג'ט, אבל אפשר להשתמש גם במשאב ב-XML בכל מקום שמקבל ערך פשוט. עבור לדוגמה, אם יש לכם את קובץ המשאבים הבא שכולל משאב צבע ומשאב מחרוזות:

<?xml version="1.0" encoding="utf-8"?>
<resources>
   <color name="opaque_red">#f00</color>
   <string name="hello">Hello!</string>
</resources>

אפשר להשתמש במשאבים האלה בקובץ הפריסה הבא כדי להגדיר את צבע הטקסט מחרוזת טקסט:

<?xml version="1.0" encoding="utf-8"?>
<EditText xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:textColor="@color/opaque_red"
    android:text="@string/hello" />

במקרה כזה, אין צורך לציין את שם החבילה בהפניה למשאב, כי המאפיין המשאבים מגיעים מהחבילה שלכם. שפת תרגום להפנות למשאב מערכת, עליכם לכלול את שם החבילה, כפי שמוצג בדוגמה הבאה:

<?xml version="1.0" encoding="utf-8"?>
<EditText xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:textColor="@android:color/secondary_text_dark"
    android:text="@string/hello" />

הערה: השתמשו תמיד במשאבי מחרוזות, כדי שהאפליקציה תהיה מותאמת לשוק המקומי לשפות אחרות. לקבלת מידע על יצירת חלופה למשאבים (כמו מחרוזות שהותאמו לשוק המקומי), אפשר לעיין בקטע מתן חלופה משאבים. לקבלת המדריך המלא להתאמת האפליקציה לשפות אחרות: ראה לוקליזציה של האפליקציה.

אפשר אפילו להשתמש במשאבים ב-XML כדי ליצור כינויים. לדוגמה, אפשר ליצור משאב שניתן להזזה שהוא כינוי של משאב אחר שניתן להזזה:

<?xml version="1.0" encoding="utf-8"?>
<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
    android:src="@drawable/other_drawable" />

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

מאפייני סגנון של קובץ עזר

משאב של מאפיין סגנון מאפשר להפנות לערך של מאפיין בעיצוב שהוחל כרגע. הפניה למאפיין סגנון מאפשרת לכם להתאים אישית את המראה של רכיבי ממשק המשתמש על ידי עיצוב שלהם כך שיתאימו לווריאציות הרגילות שזמינות את העיצוב הנוכחי, במקום לספק ערך בתוך הקוד. הפניה למאפיין סגנון בעיקרון, "שימוש בסגנון שמוגדר על ידי המאפיין הזה בעיצוב הנוכחי".

כדי להפנות למאפיין סגנון, התחביר של השם כמעט זהה למשאב הרגיל אבל במקום התחילית 'at'. (@), יש להשתמש בסימן שאלה (?). החלק של סוג המשאב הוא אופציונלי. לכן, התחביר של ההפניה:

?[<package_name>:][<resource_type>/]<resource_name>

לדוגמה, כך תוכלו להפנות למאפיין כדי להגדיר את צבע הטקסט כך שיתאים הצבע המשני של הטקסט של עיצוב המערכת:

<EditText id="text"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:textColor="?android:textColorSecondary"
    android:text="@string/hello_world" />

כאן, המאפיין android:textColor מציין את השם של מאפיין סגנון בעיצוב הנוכחי. מערכת Android משתמשת עכשיו בערך שהוחל על android:textColorSecondary בתור הערך של android:textColor בווידג'ט הזה. כי המערכת שבהקשר הזה נדרש משאב מאפיין, אתם לא צריכים לציין במפורש את הסוג, ?android:attr/textColorSecondary אפשר להחריג את הסוג attr.

גישה לקבצים המקוריים

למרות שהדבר לא נפוץ, ייתכן שתזדקקו לגשת לקבצים ולספריות המקוריים שלכם. אם תעשו זאת, לא ניתן לשמור את הקבצים ב-res/ מפני שהדרך היחידה לקרוא משאב res/ עם מזהה המשאב. במקום זאת, תוכלו לשמור את המשאבים שלכם ספריית assets/.

קבצים שנשמרו בספרייה assets/ לא מקבלים משאב מזהה, כך שלא ניתן להפנות אליהם דרך המחלקה R או ממשאבי XML. במקום זאת, אפשר קובצי שאילתות בספרייה assets/ כמו במערכת קבצים רגילה, וקוראים נתונים גולמיים באמצעות AssetManager.

עם זאת, אם הדבר היחיד שדרוש לך הוא יכולת לקרוא נתונים גולמיים (כמו קובץ וידאו או אודיו), לאחר מכן שומרים את הקובץ בספרייה res/raw/ וקוראים זרם של בייטים באמצעות openRawResource().

משאבי פלטפורמת גישה

ב-Android יש מספר משאבים סטנדרטיים, כמו סגנונות, עיצובים ופריסות. שפת תרגום לגשת למשאבים האלה, להגדיר את ההפניה למשאבים באמצעות שם החבילה android. לדוגמה, Android מספק משאב פריסה שאפשר להשתמש בו פריטים ב-ListAdapter:

listAdapter = ArrayAdapter(this, android.R.layout.simple_list_item_1, myarray)

setListAdapter(new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, myarray));

בדוגמה הזו, simple_list_item_1 הוא משאב פריסה שמוגדר על ידי פלטפורמה לפריטים ב-ListView. אפשר להשתמש בה במקום ליצור פריסה משלך של פריטים ברשימה.

התאימות הטובה ביותר למכשירים עם משאבים

כדי שהאפליקציה שלך תתמוך בכמה תצורות מכשירים, חשוב מאוד אתם תמיד מספקים משאבי ברירת מחדל לכל סוג של משאב שהאפליקציה שלכם משתמשת בו.

לדוגמה, אם האפליקציה תומכת בכמה שפות, צריך לכלול תמיד ספריית values/ (שבה נשמרות המחרוזות) ללא הגדרת שפה ואזור. אם במקום זאת תוסיפו את כל קובצי המחרוזת בספריות עם תוחם שפה ואזור, האפליקציה קורסת בזמן הריצה במכשיר שמוגדר לשפה שהמחרוזות שלך לא תומכות בה.

כל עוד מספקים ברירת מחדל values/ משאבים, אז האפליקציה תפעל באופן תקין, גם אם המשתמש לא פועל להבין את השפה שהוא מציג. זה עדיף על קריסות.

באופן דומה, אם מספקים משאבי פריסה שונים בהתאם לכיוון המסך, בוחרים כיוון אחד כברירת המחדל. לדוגמה, במקום לספק משאבי פריסה ב-layout-land/ לרוחב וב-layout-port/ לאורך, צריך להשאיר אחד כברירת המחדל, כמו layout/ לפורמט לרוחב ו-layout-port/ לפורמט לאורך.

חשוב לספק משאבי ברירת מחדל לא רק מכיוון שהאפליקציה עשויה לפעול אבל גם בגלל שגרסאות חדשות של Android מוסיפות לפעמים מגדירי התצורה שגרסאות ישנות יותר לא תומכות בהם. אם משתמשים במזהה משאבים חדש, אבל לשמור על תאימות הקוד עם גרסאות ישנות יותר של Android, ואז כשגרסה ישנה יותר של מערכת Android מפעילה את האפליקציה. היא קורסת אם לא מספקים משאבי ברירת מחדל, כי לא יכול להשתמש במשאבים שהשם שלהם מכיל את ערך האישור החדש.

לדוגמה: אם הערך בשדה minSdkVersion הוא 4, וכל המשאבים שניתנים להזזה עומדים בדרישות באמצעות מצב לילה (night או notnight, שנוספו דרך API). רמה 8), אז מכשיר ברמת API 4 לא יכול לגשת למשאבים שניתנים להזזה ולקריסות. כאן כנראה שתרצו ש-notnight יהיו משאבי ברירת המחדל שלכם, לכן אל כוללים את תוחם ולהציב את המשאבים שניתנים להזזה ב-drawable/ או ב-drawable-night/.

בקיצור, כדי לספק את תאימות המכשיר הטובה ביותר, מומלץ תמיד להשתמש בברירת מחדל למשאבים שהאפליקציה צריכה כדי לפעול באופן תקין. ואז ליצור חלופה משאבים לתצורות מכשירים ספציפיות באמצעות מגדירי תצורה.

לכלל הזה יש חריג אחד: אם הערך של minSdkVersion באפליקציה הוא 4 או גדולה יותר, לא צריך משאבים ניתנים להזזה שמוגדרים כברירת מחדל כשמספקים פריטים שניתנים להזזה משאבים עם תוחם צפיפות המסך. גם בלי ברירת המחדל משאבים שניתנים להזזה, Android יכול למצוא את ההתאמה הטובה ביותר בין צפיפות המסך החלופית וקנה המידה את מפות הסיביות לפי הצורך. עם זאת, כדי ליהנות מחוויית השימוש הטובה ביותר בכל סוגי המכשירים, מספקים משאבים חלופיים לכל שלושת סוגי הצפיפות.

איך מערכת Android מוצאת את המשאב המתאים ביותר

כשמבקשים משאב שיש לו חלופות, מערכת Android בוחרת משאב חלופי לשימוש בזמן הריצה, בהתאם להגדרות המכשיר הנוכחיות. שפת תרגום להדגים איך מערכת Android בוחרת משאב חלופי, נניח שהספריות הבאות ניתנות להזזה כל אחת מהן כוללת גרסאות שונות של אותן תמונות:

drawable/
drawable-en/
drawable-fr-rCA/
drawable-en-port/
drawable-en-notouch-12key/
drawable-port-ldpi/
drawable-port-notouch-12key/

ונניח שהגדרת המכשיר היא:

לוקאל = en-GB
כיוון המסך = port
דחיסות הפיקסלים במסך = hdpi
סוג מסך המגע = notouch
שיטת הקלט הראשית של הטקסט = 12key

מערכת Android משווה בין ההגדרות של המכשיר למשאבים החלופיים הזמינים. פריטים שניתן להזזה החל מ-drawable-en-port.

המערכת מחליטה באילו משאבים להשתמש עם הרכיבים הבאים לוגיקה:

איור 2. תרשים זרימה של האופן שבו מערכת Android מוצאת את המקור המתאים ביותר.

1. להסיר קובצי משאבים שסותרים את תצורת המכשיר.

   הספרייה drawable-fr-rCA/ הוסרה כי היא שסותר את הלוקאל en-GB.

   drawable/
   drawable-en/
   drawable-fr-rCA/
   drawable-en-port/
   drawable-en-notouch-12key/
   drawable-port-ldpi/
   drawable-port-notouch-12key/
   

   חריג לכלל הזה: דחיסות הפיקסלים של המסך היא ערך האישור היחיד שאינו בוטלו עקב סתירה. למרות שצפיפות המסך של המכשיר היא באיכות HD, המדד drawable-port-ldpi/ לא נמחק מפני שכל דחיסות המסך נחשב כהתאמה בשלב זה. מידע נוסף מופיע במאמר סקירה כללית על תאימות מסך.

2. מוצאים ברשימה את תוחם הקדימות הבא (טבלה 2). (מתחילים עם חשבון ניהול (MCC).)
3. האם חלק מספריות המשאבים כוללות את המזהה הזה?
   • אם לא, חוזרים לשלב השני ובודקים את הערך הבא. במשפט הזה, התשובה היא 'לא' עד שמגיעים לערך השפה.
   • אם כן, ממשיכים לשלב הרביעי.
4. מסירים ספריות משאבים שלא כוללות את התו המגדיר הזה. בדוגמה הזאת, המערכת לאחר מכן כל הספריות שלא כוללות תוחם שפה:

   drawable/
   drawable-en/
   drawable-en-port/
   drawable-en-notouch-12key/
   drawable-port-ldpi/
   drawable-port-notouch-12key/
   

   חריג לכלל הזה: אם התוחם המדובר הוא דחיסות הפיקסלים של המסך, מערכת Android בוחרת את האפשרות שהכי מתאימה לדחיסות המסך של המכשיר. באופן כללי, Android מעדיפה להקטין תמונה מקורית גדולה יותר כדי להקטין אותה תמונה מקורית. אפשר לקרוא מידע נוסף בקטע מסך סקירה כללית על התאימות.

5. חוזרים על שלבים שתיים, שלוש וארבע עד שתישאר רק ספרייה אחת. בדוגמה הזו, המסך הוא ערך האישור הבא שעבורו יש התאמות. לכן, משאבים שלא מציינים את כיוון המסך יוסרו:

   drawable-en/
   drawable-en-port/
   drawable-en-notouch-12key/
   

   הספרייה שנותרה היא drawable-en-port.

למרות שתהליך זה מבוצע עבור כל משאב המבוקש, המערכת מבצעת אופטימיזציה היבטים מסוימים בו. אחת האופטימיזציה הזו היא שברגע שתצורת המכשיר ידועה, הוא עשוי להסיר משאבים חלופיים שאף פעם לא יכולים להיות זהים. לדוגמה, אם ההגדרות השפה היא אנגלית, ואז כל ספריית משאבים שבה מוגדר תוחם השפה תוכן שאינו אנגלית אף פעם לא ייכלל במאגר המשאבים שנבדק (למרות ספריית משאבים בלי תוחם השפה.

בעת בחירת משאבים על סמך ערכי הגודל של המסך, המערכת משתמשת במשאבים שמיועד למסך קטן יותר מהמסך הנוכחי, אם אין משאבים מתאימים יותר. לדוגמה, מסך גדול משתמש במשאבי מסך בגודל רגיל אם יש צורך.

אבל אם המשאבים היחידים הזמינים הם גדולים יותר מהמסך הנוכחי, המערכת לא משתמשת בהם, והאפליקציה קורסת אם אין משאבים אחרים שתואמים למכשיר הגדרה אישית. זה קורה, לדוגמה, אם כל משאבי הפריסה מתויגים באמצעות ערך האישור xlarge, אבל המכשיר הוא מסך בגודל רגיל.

הערה: הקדימות של ערך האישור (בטבלה 2) חשובה יותר את מספר המזהים שתואמים בדיוק למכשיר. בדוגמה הקודמת, בשלב ארבע האפשרות האחרונה ברשימה כוללת שלושה מאפיינים שתואמים בדיוק למכשיר (כיוון, סוג מסך המגע ושיטת הקלט), ואילו ב-drawable-en יש רק פרמטר אחד שתואם (שפה). עם זאת, לשפה יש קדימות גבוהה יותר מהמגדירים האחרים האלו, לכן drawable-port-notouch-12key הוסר.