<uses-library>

注意:Google Play 會使用應用程式資訊清單中宣告的 <uses-library> 元素,篩選出不符合其資料庫規定的裝置。如要進一步瞭解篩選功能,請參閱「Google Play 的篩選功能」。

語法:
<uses-library
  android:name="string"
  android:required=["true" | "false"] />
包含於:
<application>
說明:

指定應用程式必須建立連結的共用資料庫。系統可透過這個元素,掌握要在類別載入器中為套件加入的資訊庫程式碼。

android 套件 (例如 android.appandroid.contentandroid.viewandroid.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
另請參閱: