Google Play는 <uses-sdk>를 사용합니다.
앱 매니페스트에 선언된 속성을 사용하여 기기에서 앱을 필터링합니다.
플랫폼 버전 요구사항을 충족하지 않는 앱 이러한 속성을 설정하기 전에 Google Play 필터를 이해해야 합니다.
- 구문:
<uses-sdk android:minSdkVersion="integer" android:targetSdkVersion="integer" android:maxSdkVersion="integer" />
- 포함된 위치:
<manifest>- 설명:
하나 이상의 Android 플랫폼 버전과의 애플리케이션 호환성을 표시할 수 있습니다. API 수준 정수로 표현됩니다. 애플리케이션이 표현한 API 레벨은 특정 Android 시스템의 API 수준이며 Android 기기마다 다를 수 있습니다.
이름에도 불구하고 이 요소는 API 수준을 지정하는 데 사용되며 이 요소는 아닙니다. 소프트웨어 개발 키트 (SDK) 또는 Android 플랫폼의 버전 번호 API 수준은 항상 단일 정수입니다. 다음에서 API 수준을 도출할 수 없음 연결된 Android 버전 번호가 표시됩니다. 예를 들어 또는 주 버전과 부 버전의 합계에 불과합니다.
다음 문서도 읽어 보세요. 애플리케이션 버전 관리에 대해 자세히 알아보세요.
- 속성:
-
android:minSdkVersion- 필요한 최소 API 수준을 지정하는 정수입니다.
가장 적합합니다 Android 시스템에서 사용자가
시스템의 API 레벨이
이 속성에 적용됩니다. 항상 이 속성을 선언해야 합니다.
주의: 선언하지 않는 경우 속성을 사용하면 시스템은 기본값 '1'을 가정하는데, 이는 Android의 모든 버전과 호환됩니다. 만약 isn이 아닌데 적절한
minSdkVersion를 선언하지 않은 경우 API 레벨이 호환되지 않는 시스템에 설치되면 애플리케이션이 사용할 수 없는 API에 액세스하려고 하면 런타임 중에 비정상 종료됩니다. 대상 따라서minSdkVersion속성 android:targetSdkVersion- 애플리케이션이 대상으로 하는 API 수준을 지정하는 정수입니다. 설정하지 않을 경우 기본값은
minSdkVersion에 주어진 값과 동일합니다.이 속성은 개발자가 타겟 버전에 대해 테스트했음을 시스템에 알리고 시스템이 앱의 이후 버전과의 호환성을 유지하기 위해 호환성 동작을 사용 설정하지 않음 확인할 수 있습니다 애플리케이션을 더 낮은 버전 (
minSdkVersion까지)에서 계속 실행할 수 있습니다.Android의 새 버전이 나올 때마다 일부 동작은 물론, 심지어 모양까지 변경될 수 있습니다. 그러나 플랫폼의 API 수준이 앱의
targetSdkVersion에서 선언된 버전보다 높은 경우 시스템이 호환성 동작을 사용 설정할 수 있으므로 앱이 계속 정상적으로 작동합니다. 실행 중인 플랫폼의 API 수준과 일치하는targetSdkVersion을 지정하면 이러한 호환성 동작을 사용 중지할 수 있습니다.예를 들어 이 값을 '11'로 설정하면 이상 Android 3.0 또는 더 높고 화면을 사용 중지합니다. 큰 화면에서 실행될 때 호환성 모드를 사용해야 합니다. 이는 API 수준 11에 대한 지원이 암시적으로 있기 때문입니다. 더 큰 화면을 지원합니다.
설정한 값에 따라 시스템에서 사용 설정할 수 있는 호환성 동작이 많이 있습니다. 이 속성에 적용됩니다. 이러한 일부 동작은
Build.VERSION_CODES참조에서 플랫폼 버전별로 설명합니다.각 Android 버전과 함께 애플리케이션을 유지관리하려면 해당 값을 최신 API 레벨에 일치시킨 다음 확인할 수 있습니다
도입된 위치: API 수준 4
- 애플리케이션의 최대 API 수준을 지정하는 정수입니다.
실행할 수 있도록 설계되었습니다
Android 1.5, 1.6, 2.0, 2.0.1에서 애플리케이션을 설치할 때와 시스템 업데이트 후에 애플리케이션 유효성을 다시 검사할 때 시스템이 이 속성 값을 확인합니다. 두 경우 모두 애플리케이션의
maxSdkVersion속성이 사용되는 API 수준보다 낮습니다. 그 경우 시스템은 응용 프로그램을 설치하지 못하게 합니다. 시스템 업데이트 후에 유효성을 다시 검사하는 경우 실질적으로 기기에서 애플리케이션이 삭제됩니다.시스템 업데이트 후에 이 속성이 애플리케이션에 어떻게 영향을 미치는지 다음의 예로 알아보겠습니다.
매니페스트에
maxSdkVersion="5"를 선언하는 애플리케이션이 Google Play에 게시되어 있습니다. Android를 실행하는 기기의 사용자 1.6 (API 수준 4)이 앱을 다운로드하고 설치합니다. 몇 주 후 사용자는 Android 2.0 (API 수준 5)으로 무선 시스템 업데이트를 받습니다. 업데이트 설치 후에 시스템이 애플리케이션의maxSdkVersion을 확인하고 유효성 검사를 성공적으로 마칩니다.애플리케이션이 정상 작동합니다. 그러나 얼마 후에 장치는 이번에는 Android 2.0.1 (API 수준 6)으로 업데이트합니다. 그런 다음 다시 검사하면 시스템이 애플리케이션의 유효성을 다시 검사할 수 없기 때문에 자체 API 수준 (6)이 애플리케이션에서 지원하는 최대 수준보다 높습니다. (5). 시스템은 애플리케이션이 사용자에게 보이지 않게 하여 실질적으로 기기에서 애플리케이션을 삭제합니다.
경고: 선언하지 않는 것이 좋습니다. 속성의 값을 제공합니다. 첫째, 속성을 차단하려는 수단으로 새 버전의 Android 플랫폼에 애플리케이션을 배포하는 것은 출시됩니다 플랫폼의 새 버전은 이전 버전과 완전히 호환되도록 설계되었습니다. 애플리케이션이 새 버전에서 제대로 작동합니다. 단, 표준 API만 사용하고 개발 권장사항을 따라야 합니다. 둘째, 속성을 선언하면 애플리케이션이 사용자에게서 몇 초 안에 더 높은 API 수준으로 업데이트해야 합니다 애플리케이션이 실행되는 대부분의 기기 무선으로 주기적인 시스템 업데이트를 받도록 설치될 가능성이 높으므로 애플리케이션에 미치는 영향을 검토한 후에 속성의 값을 제공합니다.
도입된 위치: API 수준 4
일부 Android 버전 (Android 2.0.1 이상)에서maxSdkVersion속성 확인 또는 적용 재검증할 수 있습니다 Google Play에서는 계속해서 하지만 사용자가 애플리케이션을 전환할 때 사용 가능한 애플리케이션을 제시할 때는 다운로드.
- 도입 수준:
- API 수준 1
API 수준이란 무엇인가요?
API 수준은 프레임워크 API를 고유하게 식별하는 정수 값입니다. 버전 1.4.1의 최신 버전을 포함합니다.
Android 플랫폼은 애플리케이션이 기본 Android 시스템과 상호작용하는 데 사용할 수 있는 프레임워크 API를 제공합니다. 프레임워크 API는 다음 요소로 구성되어 있습니다.
- 핵심 패키지 및 클래스 집합
- 매니페스트 파일을 선언하는 데 사용되는 XML 요소 및 속성 집합
- 리소스를 선언 및 액세스하는 데 사용되는 XML 요소 및 속성 집합
- 인텐트 집합
- 애플리케이션이 요청할 수 있는 권한 및 시스템에 포함된 권한 적용 집합
연속된 각 Android 플랫폼 버전은 제공하는 Android 애플리케이션 프레임워크 API 업데이트를 포함할 수 있습니다.
프레임워크 API 업데이트는 새 API가 이전 API 버전과의 호환성을 유지하도록 설계되었습니다. 즉, 대부분의 API 변경사항은 추가된 것이며 새 기능 또는 대체 기능을 소개합니다. API의 일부로 제공 업그레이드되고 교체된 이전 부품은 지원 중단되었지만 삭제되지는 않으므로 기존 애플리케이션에서 계속 사용할 수 있습니다
극소수의 경우에, API의 일부는 수정되거나 삭제되지만 일반적으로 이러한 변경사항은 API 견고성과 애플리케이션 또는 시스템 보안을 지원하기 위해서만 필요합니다. 이전 버전의 모든 기타 API 요소는 수정 없이 새 버전에 제공됩니다.
Android 플랫폼이 제공하는 프레임워크 API는 정수 식별자(API 수준)를 사용합니다. 각 Android 플랫폼 버전은 정확히 하나의 API 수준(모든 이전 API 수준은 암시적으로 지원) (API 수준 1까지) Android 플랫폼의 최초 릴리스는 API 수준 1과 이후 출시 버전에서는 API 수준이 증가했습니다.
다음 표에서는 Android 플랫폼입니다. Google 모바일 광고 SDK가 지원하는 기기의 자세한 내용은 배포 대시보드를 참고하세요.
Android에서 API 수준 사용
API 수준 식별자는 경험을 제공할 수 있습니다.
- 이를 통해 Android 플랫폼이 프레임워크 API 수정의 최대 버전을 설명할 수 있습니다. 살펴보겠습니다
- 이를 통해 애플리케이션이 프레임워크 API 수정 버전을 설명할 수 있습니다. 살펴봤습니다
- 시스템이 사용자 컴퓨터에 있는 애플리케이션 설치를 협상할 수 있게 합니다. 버전 비호환 애플리케이션이 설치되지 않도록 할 수 있습니다.
각 Android 플랫폼 버전은 API 수준 식별자를 내부적으로 안드로이드 시스템 자체에 있습니다.
애플리케이션은 프레임워크에서 제공하는 매니페스트 요소를 사용할 수 있음
API: <uses-sdk>: 최소 및 최대 API를 설명합니다.
실행할 수 있는 기본 API 레벨과
이러한 포드는
지원하도록 설계되어 있습니다 이 요소는 다음과 같은 3가지 주요 속성을 제공합니다.
android:minSdkVersion: 최소 API 수준 애플리케이션을 실행할 수 있는 리소스입니다 기본값은 '1'입니다.android:targetSdkVersion: API 수준 애플리케이션 실행을 위해 설계된 애플리케이션입니다. 경우에 따라 이렇게 하면 애플리케이션이 대상에서 정의된 매니페스트 요소 또는 동작을 사용함 정의된 것만 사용하도록 제한하기보다는 API 수준에서 최소 API 레벨을 제공합니다.android:maxSdkVersion: 최대 API 수준 애플리케이션을 실행할 수 있는 리소스입니다 중요: 다음을 읽어 보세요. 이 속성에 대한 정보를 확인하세요.
예를 들어 애플리케이션이 생성할 최소 시스템 API 수준을
애플리케이션은 해당 애플리케이션의 매니페스트에
android:minSdkVersion가 포함된 <uses-sdk> 요소
속성의 값을 제공합니다. android:minSdkVersion의 값은 정수입니다.
가장 초기에 Android 플랫폼 버전의 API 수준에 상응함
지정할 수 있습니다
사용자가 애플리케이션을 설치하려고 할 때 또는
Android 시스템은 먼저
<uses-sdk> 속성을 설정하는 방법
값을 자체 내부 API 수준과 비교합니다. 시스템에서
다음 조건이 충족되는 경우에만 설치가 시작됩니다.
android:minSdkVersion속성이 선언된 경우 그 값은 시스템의 API 수준 정수보다 작거나 같아야 합니다. 선언하지 않은 경우 시스템은 애플리케이션이 API 레벨 1을 필요로 한다고 가정합니다.android:maxSdkVersion속성이 선언된 경우 그 값은 시스템의 API 수준 정수 이상이어야 합니다. 선언하지 않으면 시스템은 애플리케이션이 에는 최대 API 수준이 없습니다. 자세한 내용은 이 속성에 대한 설명을 참조하세요. 시스템이 그것을 처리하는 방법을 배웁니다.
애플리케이션의 매니페스트에 선언한 경우 <uses-sdk> 요소는 다음과 같은 형태일 수 있습니다.
<manifest> <uses-sdk android:minSdkVersion="5" /> ... </manifest>
애플리케이션이 API 수준을 선언하는 주요 이유
android:minSdkVersion는 Android 시스템에
지정된 API 수준에서 도입된 API 사용
만약 애플리케이션이 더 낮은 API 수준의 플랫폼에 설치되는 경우 런타임 시 존재하지 않는 API에 액세스하려고 하면 비정상 종료됩니다. 시스템은 애플리케이션이 가장 낮은 API 레벨이 대상 기기의 플랫폼 버전을 지정합니다.
개발 고려 사항
다음 섹션에서는 필요한 API 수준과 관련된 정보를 제공합니다. 고려해야 합니다
애플리케이션의 향후 호환성
Android 애플리케이션은 일반적으로 Android 플랫폼의 새 버전과 호환됩니다.
프레임워크 API에 대한 거의 모든 변경사항은 추가적이기 때문에 Android는 API의 특정 버전을 사용하여 개발된 애플리케이션을 API 수준은 Android 플랫폼 최신 버전과 호환되며 지원하고자 합니다. 애플리케이션은 이후 모든 버전에서 실행될 수 있습니다. 애플리케이션이 실행되어야 하는 격리된 경우가 아니면 나중에 어떤 이유로든 삭제되는 API의 일부일 수 있습니다.
이후 버전과의 호환성은 대부분의 Android 기기가 무선 시스템 업데이트(OTA)를 수신하므로 중요합니다. 사용자는 사용하고 나면 나중에 새 클라이언트 ID에 대한 OTA 업데이트를 Android 플랫폼 버전입니다. 업데이트가 설치되면 애플리케이션은 환경의 새 런타임 버전에서 실행되지만 여전히 API가 있는 버전 시스템 기능을 결정하는 데 도움이 됩니다
API 하위 변경사항(예: 기본 새 애플리케이션에서 실행될 때 애플리케이션에 영향을 미칠 수 있으므로 환경입니다 애플리케이션은 사용자 인증 정보를 각 시스템에서 애플리케이션이 어떻게 보이고 동작하는지 이해하기 위해 환경입니다
다양한 Android 플랫폼 버전에서 애플리케이션을 테스트하는 데 도움이 되도록 Android SDK에는 다운로드할 수 있는 여러 플랫폼이 포함되어 있습니다. 각 플랫폼에는 AVD에서 실행할 수 있는 호환되는 시스템 이미지가 포함되어 있어 애플리케이션을 테스트할 수 있습니다
애플리케이션의 하위 호환성
Android 애플리케이션이 컴파일된 버전보다 오래된 Android 플랫폼을 사용하는 것입니다.
각 새 Android 플랫폼 버전은 애플리케이션에 새 플랫폼 기능의 액세스 권한을 제공하거나 기존 API 요소를 대체하는 프레임워크 API와 같은 새 프레임워크 API를 포함할 수 있습니다. 새 API는 최신 버전의 플랫폼에서 실행할 때도 플랫폼에 지정해야 합니다 하지만 이전 버전의 플랫폼에 새 API가 포함되지 않으면 새 API를 사용하는 애플리케이션은 실행할 수 있습니다
Android 기기가 이전 버전의 플랫폼을 사용했다면 아마도 Android 10, iOS 1.0에서 이전 버전의 있습니다. 무선 업데이트를 수신하는 기기 중에서도 일부는 상당한 시간 동안 지연되고 업데이트를 수신하지 못할 수 있습니다.
플랫폼 버전 및 API 수준 선택
애플리케이션을 개발할 때 애플리케이션을 컴파일하는 대상 플랫폼 버전 포함 일반적으로 최대한 낮은 가용성과 성능을 기준으로 애플리케이션이 지원할 수 있는 플랫폼 버전입니다.
연속 하위 빌드 타겟을 대상으로 애플리케이션을 컴파일하여 가능한 최소 플랫폼 버전을 결정할 수 있습니다.
가장 낮은 버전의 경우 해당 플랫폼을 사용하여 AVD를 생성
버전 및 API 수준을 점검하고 애플리케이션을 완전히 테스트합니다. 모든 포드의
android:minSdkVersion 속성을 설정하는 방법
값을 플랫폼 버전의 API 수준으로 설정합니다.
최소 API 수준 선언
Google Cloud Platform에서 소개된 API 또는 시스템 기능을 사용하는 애플리케이션을
앱을 최신 버전으로 업데이트하고 싶다면
android:minSdkVersion 속성을 최신 API 수준
플랫폼 버전입니다 따라서 사용자는
호환되는 Android 버전을 실행하고 있다면
있습니다. 이렇게 하면 애플리케이션이 기본 서버에서 제대로 작동할 수 있도록
제어할 수 있습니다.
애플리케이션이 최신 플랫폼 버전에 도입된 API를 사용하지만
android:minSdkVersion 속성을 선언하지 않는 경우
최신 버전의 플랫폼을 실행 중인 장치에서 제대로 실행되지만
않습니다. 후자의 경우
그렇지 않은 API를 사용하려고 하면 애플리케이션이 런타임에
존재한다는 것입니다
상위 API 수준 테스트
애플리케이션을 컴파일한 후에는
애플리케이션의 android:minSdkVersion에 지정된 플랫폼
속성의 값을 제공합니다. 이렇게 하려면 애플리케이션이 필요로 하는 플랫폼 버전을 사용하는 AVD를 만들어야 합니다. 또한 이후 버전과의 호환성을 확인하려면
이보다 높은 API 레벨을 사용하는 모든 플랫폼에서 애플리케이션을 테스트합니다.
지정할 수도 있습니다
Android SDK는 최신 버전을 비롯하여 사용할 수 있는 여러 플랫폼 버전을 포함하고 있으며, 필요한 경우 다른 플랫폼 버전을 다운로드할 수 있는 업데이트 프로그램 도구를 제공합니다.
업데이트 프로그램에 액세스하려면 <sdk>/tools 디렉터리에 있는 android 명령줄 도구를 사용하세요. android sdk를 실행하여 SDK 업데이트 프로그램을 시작할 수 있습니다. 다음과 같은 작업을 할 수 있습니다.
android.bat (Windows) 또는 android (OS X/Linux) 파일을 더블클릭합니다.
에뮬레이터에서 여러 플랫폼 버전에 관해 애플리케이션을 실행하려면 테스트할 각 플랫폼 버전용 AVD를 생성합니다. 자세한 내용은 AVD에 관한 자세한 내용은 가상 기기 만들기 및 관리를 참고하세요. 만약 테스트용 실제 기기를 사용하는 경우 애플리케이션의 API 수준을 알고 있어야 합니다 Android 플랫폼을 빌드할 수 있어야 합니다 이 문서의 표에서 플랫폼 버전 및 해당 API 수준의 목록입니다.
API 수준별로 참조 문서 필터링
Android 플랫폼 참조 문서 페이지는
'API 수준' 컨트롤을 클릭합니다. 이
API에서 실제로 사용 중인 부분에 대한 문서만
애플리케이션에 액세스할 수 있어야 합니다.
매니페스트 파일의 android:minSdkVersion 속성입니다.
필터링을 사용하려면 API를 선택하세요. 선택합니다. 나중에 도입된 API는 그러면 API 수준이 비활성화되고 콘텐츠가 마스킹됩니다. 액세스할 수 있습니다
문서에서 API 수준별로 필터링하면 뷰가 제공되지 않음 를 자세히 살펴보세요. 이를 통해 특정 API 수준과 연결된 전체 API 보기(API 제외) 요소가 있습니다.
전체 문서 보기로 돌아가려면 API 수준 메뉴 상단에서 REL을 선택합니다. 기본적으로 API 수준 필터링은 사용 중지되므로 API 수준에 관계없이 전체 프레임워크 API를 볼 수 있습니다.
개별 API 요소에 대한 참조 문서 는 각 요소가 도입되는 API 수준을 지정합니다. API 수준 'API 수준에서 추가됨'으로 지정됩니다. , 오른쪽 상단 모서리에 표시됩니다. API 수준 자세한 설명 헤더에 명시되므로 오른쪽 여백에 가깝게 배치하세요.