<uses-native-library>

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

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

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

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

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

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

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

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

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

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