<uses-native-library>

תחביר:
<uses-native-library
  android:name="string"
  android:required=["true" | "false"] />
כלול ב:
<application>
description:

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

ספריות NDK נגישות כברירת מחדל, ולכן לא נדרש התג <uses-native-library>.

לא ניתן לגשת כברירת מחדל לספריות מקוריות משותפות שאינן NDK, שמסופקות על ידי ספקי סיליקון או יצרני מכשירים, אם האפליקציה מיועדת ל-Android 12 (רמת API 31) ואילך. הגישה לספריות אפשרית רק אם מבקשים אותן במפורש באמצעות התג <uses-native-library>.

אם האפליקציה מטרגטת ל-Android 11 (רמת API 30) או לגרסה מוקדמת יותר, התג <uses-native-library> לא נדרש. במקרה כזה, אפשר לגשת לכל ספרייה מקורית משותפת, בלי קשר לשאלה אם היא ספריית NDK.

הרכיב הזה משפיע גם על התקנת האפליקציה במכשיר מסוים. אם הרכיב הזה קיים והמאפיין android:required שלו מוגדר ל-true, מסגרת PackageManager לא תאפשר למשתמש להתקין את האפליקציה אלא אם הספרייה קיימת במכשיר של המשתמש.

בקטע הבא מוסבר בפירוט על מאפיין android:required.

מאפיינים:
android:name
שם קובץ הספרייה.
android:required
ערך בוליאני שמציין אם האפליקציה דורשת את הספרייה שצוינה על ידי android:name.
  • ‫"true": האפליקציה לא פועלת בלי הספרייה הזו. המערכת לא מאפשרת להתקין את האפליקציה במכשיר שאין בו את הספרייה.
  • ‫"false": האפליקציה משתמשת בספרייה אם היא קיימת, אבל היא מתוכננת לפעול גם בלעדיה אם צריך. המערכת מאפשרת להתקין את האפליקציה, גם אם הספרייה לא קיימת. אם משתמשים ב-"false", האחריות לטיפול תקין בהיעדר הספרייה היא על המשתמש.

ערך ברירת המחדל הוא "true".

הוצג ב:
רמת API‏ 31
ראו גם: