<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
ראו גם: