附註:Google Play 會使用應用程式資訊清單中宣告的 <uses-library> 元素,篩選出不符合其資料庫規定的裝置。如要進一步瞭解篩選功能,請參閱 Google Play 篩選器主題。
- 語法:
-
<uses-library android:name="string" android:required=["true" | "false"] />
- 包含於:
-
<application>
- 說明:
-
指定應用程式必須建立連結的共用資料庫。系統可透過這個元素,掌握要在類別載入器中為套件加入的資訊庫程式碼。
android
套件 (例如android.app
、android.content
、android.view
和android.widget
) 全都位在所有應用程式都會自動建立連結的預設資料庫中。不過,某些套件 (例如maps
) 位在應用程式不會自動建立連結的獨立資料庫中。請參閱所用套件的說明文件,瞭解哪個資料庫包含套件程式碼。<uses-library>
標記的順序十分重要,會影響應用程式載入時的類別查詢和解析順序。部分資料庫可能有重複的類別,在這種情況下,系統會優先採用第一個資料庫。這個元素也會影響應用程式在特定裝置上的安裝情形,以及在 Google Play 上的提供情形:
- 安裝
- 如果有這個元素,且其
android:required
屬性設為true
,則除非使用者裝置上存在該資料庫,否則PackageManager
架構不允許使用者安裝應用程式。
下節將詳細說明
android:required
屬性。 - 屬性:
-
android:name
- 資料庫的名稱。這個名稱是由所用套件的說明文件提供。以
android.test.runner
為例,這個套件包含 Android 測試類別。 android:required
- 布林值,用於表示應用程式是否需要
android:name
指定的資料庫:-
"true"
:如果沒有這個資料庫,應用程式就無法運作。在沒有資料庫的裝置上,系統不會允許安裝應用程式。 -
"false"
:應用程式可以使用資料庫 (如果有的話),但假如沒有資料庫,也可以在必要時運作。即使沒有資料庫,系統仍允許安裝應用程式。如果您使用"false"
,則必須負責在執行階段檢查是否有資料庫。如要檢查資料庫,您可以使用反射判斷是否有特定類別可用。
預設值為
"true"
。導入版本:API 級別 7。
-
- 導入版本:
- API 級別 1
- 另請參閱: