6월 3일의 ⁠#Android11: 베타 버전 출시 행사에 참여하세요.

<uses-library>

참고: 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)는 자동으로 연결되지 않는 별도의 라이브러리에 있습니다. 사용 중인 패키지의 문서에서 패키지 코드가 포함된 라이브러리를 확인하세요.

이 요소는 특정 기기에서 애플리케이션 설치 및 Google Play의 애플리케이션 가용성에도 영향을 줍니다.

설치
이 요소가 있고 요소의 android:required 속성이 true로 설정되어 있는 경우 사용자의 기기에 라이브러리가 없다면 PackageManager 프레임워크는 사용자가 애플리케이션을 설치하지 못하게 합니다.

android:required 속성은 다음 섹션에서 자세히 설명합니다.

속성
android:name
라이브러리의 이름입니다. 이름은 사용 중인 패키지의 문서에 제공됩니다. 예를 들어 Android 테스트 클래스가 포함된 패키지의 이름은 'android.test.runner'입니다.
android:required
애플리케이션에 android:name에서 지정한 라이브러리가 필요한지 여부를 나타내는 부울 값입니다.
  • "true": 이 라이브러리가 없으면 애플리케이션이 작동하지 않습니다. 시스템에서 라이브러리가 없는 기기에 애플리케이션을 허용하지 않습니다.
  • "false": 라이브러리가 있으면 애플리케이션에서 라이브러리를 사용할 수 있지만 필요한 경우 라이브러리가 없어도 작동하도록 설계되었습니다. 라이브러리가 없어도 시스템에서 애플리케이션을 설치하도록 허용합니다. "false"를 사용하면 런타임 시 라이브러리를 사용할 수 있는지 확인해야 합니다.

    라이브러리를 알아보려면 리플렉션을 사용해 특정 클래스를 사용할 수 있는지 확인할 수 있습니다.

기본값은 "true"입니다.

도입 시기: API 레벨 7

도입 시기
API 레벨 1
참고 항목