SDK 출시 노트
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
경고: Google Play 인스턴트를 더 이상 사용할 수 없습니다. 2025년 12월부터는 Google Play를 통해 인스턴트 앱을 게시할 수 없으며 모든 Google Play 서비스 인스턴트 API가 더 이상 작동하지 않습니다. 사용자에게 더 이상 어떤 메커니즘을 통해서도 Play에서 인스턴트 앱이 제공되지 않습니다.
이 변경사항은 개발자 의견과 Google Play 인스턴트 도입 이후 생태계를 개선하기 위한 Google의 지속적인 투자를 기반으로 이루어집니다.
사용자 증가를 목표로 계속 최적화하려면 개발자가 딥 링크를 사용하여 사용자를 일반 앱 또는 게임으로 안내하는 것이 좋습니다. 이렇게 하면 관련이 있는 경우 사용자를 특정 여정이나 기능으로 리디렉션할 수 있습니다.
Google Play 인스턴트 개발 SDK v1.9.0(2019-09-05)
이 Google Play 인스턴트 개발 SDK 릴리스에는 다음과 같은 변경사항이 포함되어 있습니다.
변경사항
- 이제 인스턴트 앱 CLI가 심볼릭 링크를 통해 호출될 때 제대로 실행됩니다.
- 이전 버전의 SDK에서 minSdkVersion < 24이고 v2 서명 체계로만 서명된 앱을 시작할 경우 항상 오류가 발생합니다. 이번 변경에서
ia run과 Android 스튜디오의 실행 명령어를 모두 수정하므로 연결된 기기의 API 버전이 너무 오래되어 v2 서명을 지원할 수 없는 경우에만 오류가 발생합니다.
Google Play 인스턴트 개발 SDK v1.8.0(2019-08-05)
이 Google Play 인스턴트 개발 SDK 릴리스에는 다음과 같은 변경사항이 포함되어 있습니다.
변경사항
- 인스턴트 앱 CLI
ia run 명령어는 v2 서명 체계를 사용하여 서명된 인스턴트 앱만 배포할 수 있습니다.
- 이제 아티팩트를 배포하지 않고도 인스턴트 앱 CLI
ia run -u [url] 명령어를 사용할 수 있습니다.
Google Play 인스턴트 개발 SDK v1.7.0(2019-03-29)
이 Google Play 인스턴트 개발 SDK 릴리스에는 다음과 같은 새로운 기능 및 변경사항이 포함되어 있습니다.
새로운 기능
- 이제 인스턴트 앱 CLI에서 사용자 동의에 따라 사용량 측정항목을 수집할 수 있으므로 Google 개발자팀에서 사용자가 유용한 기능을 더욱 효과적으로 확인하고 Google 도구의 단점을 개선할 수 있습니다.
ia check 명령어는 이제 공통 업그레이드 경로의 비호환성에 관해 동일 앱의 설치 가능한 빌드를 검사하도록 지원합니다. -i 옵션을 사용하여 설치 가능한 앱 APK를 제공할 수 있습니다.
변경사항
- 이제 기기에 활성 Google 계정이 없어도 인스턴트 앱 CLI
ia run 명령어로 개발 모드에서 인스턴트 앱을 실행할 수 있습니다.
Google Play 인스턴트 개발 SDK v1.6.0(2018-11-05)
이 Google Play 인스턴트 개발 SDK 릴리스에는 다음과 같은 새로운 기능 및 변경사항이 포함되어 있습니다.
새로운 기능
- 이제 인스턴트 앱 CLI
ia check 명령어로 bundletool에서 생성한 APK 집합 파일 (.apks)의 크기를 확인할 수 있습니다.
변경사항
- Android 8.0 (API 수준 26) 이상을 실행하는 기기에서 서명 키가 기기에서 이전에 실행된 앱의 키와 일치하지 않는 인스턴트 앱을 실행해도 Android 스튜디오 또는 CLI에서 더 이상 비정상 종료가 발생하지 않습니다.
- 인스턴트 앱의 크기 제한이 4MB에서 10MB로 변경되었습니다.
4MB보다 큰 앱은 이제
ERROR 대신 WARNING을 받습니다. 10MB보다 큰 앱은 계속해서 ERROR을 받습니다.
Google Play 인스턴트 개발 SDK v1.5.0(2018-09-27)
이 Google Play 인스턴트 개발 SDK 릴리스에는 다음과 같은 새로운 기능 및 변경사항이 포함되어 있습니다.
새로운 기능
- 이제 인스턴트 앱 CLI
ia run 및 ia check 명령어로 bundletool이 생성한 APK 집합 (.apks) 파일에서 작업할 수 있습니다.
- 이제 인스턴트 앱 CLI
ia check 명령어를 APK 목록과 함께 사용할 수 있습니다.
- 인스턴트 앱 CLI
ia check 명령어는 분할 APK의 이름이 지정된 ZIP 파일 내에서 고유하게 유지되도록 합니다.
변경사항
- Android 7.1.1 (API 레벨 25) 이하를 실행하는 기기를 프로비저닝할 때 CLI가 Google Play 서비스 체크인을 감지하지 못한 경우에만 경고를 발행합니다. 이전에는 이 상황에서 CLI가 오류를 발생시키고 인스턴트 앱을 시작하려고 시도하지 않았습니다.
- 이제 인스턴트 앱 CLI
ia run으로 bundletool에서 생성한 APK 또는 aapt2를 사용하여 빌드된 APK를 정상적으로 실행할 수 있습니다. 이전에는 이러한 APK 중 일부를 실행할 때 run 작업이 타임아웃된 것으로 보일 수 있었습니다.
--no-setup 플래그는 ia run에서 지원 중단되었으며 이제는 영향을 미치지 않습니다.- 인스턴트 앱용 Google Play 서비스의 이전 버전을 적절히 업데이트합니다. 새 버전을 설치하기 전에 이전 버전을 제거해야 합니다.
Google Play 인스턴트 개발 SDK v1.4.0(2018-08-28)
이 Google Play 인스턴트 개발 SDK (이전의 인스턴트 앱 개발 SDK) 릴리스에는 다음과 같은 새로운 기능 및 변경사항이 포함되어 있습니다.
새로운 기능
- 이제 인스턴트 앱 CLI
ia check 명령어로 구성 APK를 사용하는 인스턴트 앱의 크기를 검사할 수 있습니다.
- 이제 CLI에서 최신 버전의 Google Play 서비스가 설치된 테스트 키 에뮬레이터 이미지에서 인스턴트 앱을 실행할 수 있습니다.
ia help <command>를 사용하여 명령어별 도움말 지원이 개선되었습니다.ia check 크기 오류에 관한 크기 분석을 추가했습니다.
변경사항
- SDK의 이름이 'Android 인스턴트 앱 개발 SDK'에서 'Google Play 인스턴트 개발 SDK'로 변경되었습니다.
- 런처 활동이 없는 앱을 검사하려고 할 때 더 이상 CLI에서
NullPointerException이 발생하지 않습니다.
- CLI와 Android 스튜디오에서 이제 Android 8.0(API 수준 26)을 실행하는 지원되지 않는 기기를 감지합니다. 이전에는 이러한 기기에서 앱이 실행되지 않았습니다.
- 이제
ia Bash 래퍼 스크립트가 $TERM이 설정되지 않은 파이프라인에서 호출될 때 올바로 작동합니다. 스크립트는 너비가 80열이라고 가정합니다.
- 이제
ia check 명령어는 minSdkVersion 버전이 20 이하로 설정된 인스턴트 앱에 관해 경고합니다. 빌드에서 이러한 이전 SDK 버전을 지원할 경우 인스턴트 앱을 위한 아무런 이점 없이 바이너리의 크기가 증가할 수도 있습니다.
- CLI에서 이제 Google Play 서비스가 너무 오래되어 인스턴트 앱을 실행할 수 없는 경우를 감지하고 기기에 업데이트 메시지를 표시합니다.
- 이제 CLI 또는 Android 스튜디오를 통해 Android 8.0 (API 수준 26) 이상에서 실행되는 인스턴트 앱에는
android.permission.INSTANT_APP_FOREGROUND_SERVICE 권한이 자동으로 부여됩니다.
Android 인스턴트 앱 개발 SDK v1.3.0(2018-06-04)
이 Android 인스턴트 앱 개발 SDK 릴리스에는 다음과 같은 새로운 기능 및 변경사항이 포함되어 있습니다.
새로운 기능
- Android 스튜디오 3.2에서 이제 SDK 1.3에 추가된 라이브러리를 사용하여 인스턴트 앱을 실행합니다.
이렇게 하면
ia와 스튜디오 간의 로직이 통합되고 Android 스튜디오의 URL이 없어도 인스턴트 앱을 실행할 수 있습니다.
Android 인스턴트 앱 개발 SDK v1.2.0(2018-05-07)
이 Android 인스턴트 앱 개발 SDK 릴리스에는 다음과 같은 새로운 기능 및 변경사항이 포함되어 있습니다.
새로운 기능
- 새로운 인스턴트 앱 명령줄 인터페이스
ia를 사용하면 개발 기기에서 인스턴트 앱을 실행하고 로컬에서 앱의 일반적인 오류를 확인할 수 있습니다.
- 이제 URL 진입점 없이 인스턴트 앱을 빌드하고 실행할 수 있습니다.
변경사항
- 이제 SDK와 번들된 인스턴트 앱용 Google Play 서비스 버전이 Play 스토어를 사용하여 자동 업데이트됩니다. 이전 출시에서는 패키지가 SDK와 번들된 버전으로 고정되었습니다.
- 이제 개발 모드에서 와일드 카드 문자가 포함된 호스트 이름(예:
"*.example.com")을 완전히 지원합니다.
- 개발자는 이제 다음 예와 같이
debug.aia.throttle_download_ms 시스템 속성을 설정하여 Android Lollipop, Marshmallow, Nougat에서 제한된 앱 다운로드를 시뮬레이션할 수 있습니다.
$ adb shell setprop debug.aia.throttle_download_ms 5000
Android 인스턴트 앱 개발 SDK v1.1.0
이 Android 인스턴트 앱 개발 SDK 릴리스에는 다음과 같은 새로운 기능 및 변경사항이 포함되어 있습니다.
새로운 기능
- 인스턴트 앱에서 설치된 앱으로 데이터를 전송합니다.
- Android 8.0 (API 수준 26) 이상을 실행하는 기기에서 시스템이 앱 설치 시 자동으로 데이터를 전송합니다. Android 7.1 (API 수준 25) 이하를 실행하는 기기에서는 설치된 앱에서
getInstantAppData()를 호출하여 인스턴트 앱의 저장소 데이터를 설치된 앱으로 전송할 수 있습니다.
- 새로운 기기별 APK 지원 기능을 사용하여 APK의 크기를 줄일 수 있습니다. 구성 APK의 빌드 설정에 관한 자세한 내용은 구성 APK의 빌드 설정을 참고하세요.
변경사항
- 에뮬레이터.
- 앞으로 인스턴트 앱을 테스트하려면 Play 스토어 및 최신 Google Play 서비스를 실행하는 에뮬레이터가 필요합니다. 에뮬레이터 설정 방법은 인스턴트 앱 실행을 참고하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[null,null,["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# SDK release notes\n\n**Warning:** Google Play Instant will no longer be available. Starting December 2025,\nInstant Apps cannot be published through Google Play, and all\n[Google Play services Instant APIs](https://developers.google.com/android/reference/com/google/android/gms/instantapps/package-summary)\nwill no longer work. Users will no longer be served Instant Apps by Play using any\nmechanism.\n\nWe're making this change based on developer feedback and our continuous investments\nto improve the ecosystem since the introduction of Google Play Instant.\n\nTo continue optimizing for user growth, we encourage developers to refer users to\ntheir regular app or game, using [deeplinks](https://support.google.com/googleplay/android-developer/answer/12463044)\nto redirect them to specific journeys or features when relevant.\n\nGoogle Play Instant Development SDK v1.9.0 (2019-09-05)\n-------------------------------------------------------\n\nThis release of the Google Play Instant Development SDK contains the following\nchanges.\n\n### Changes\n\n- The instant apps CLI will now run properly when invoked through a symbolic link.\n- In the previous version of the SDK, launching an app with minSdkVersion \\\u003c 24 and signed only with the v2 signature scheme would always cause an error. This change fixes both `ia run` and Android Studio's run command so that an error will only occur if the connected device's API version is too old to support v2 signatures.\n\nGoogle Play Instant Development SDK v1.8.0 (2019-08-05)\n-------------------------------------------------------\n\nThis release of the Google Play Instant Development SDK contains the following\nchanges.\n\n### Changes\n\n- The instant apps CLI `ia run` command can deploy instant apps that are only signed using a v2 signature scheme.\n- The instant apps CLI `ia run -u [url]` command now works without deploying an artifact.\n\nGoogle Play Instant Development SDK v1.7.0 (2019-03-29)\n-------------------------------------------------------\n\nThis release of the Google Play Instant Development SDK contains the following\nnew features and changes.\n\n### New features\n\n- The instant apps CLI can now collect usage metrics with your consent, allowing Google's developer team to better understand what features you find useful and improve shortcomings in our tooling.\n- The `ia check` command now supports checking against an installable build of the same app for common upgrade path incompatibilities. You can provide the installable app APK using the `-i` option.\n\n### Changes\n\n- The instant apps CLI `ia run` command no longer requires an active Google account on the device to launch instant apps in development mode.\n\nGoogle Play Instant Development SDK v1.6.0 (2018-11-05)\n-------------------------------------------------------\n\nThis release of the Google Play Instant Development SDK contains the following\nnew features and changes.\n\n### New features\n\n- The instant apps CLI `ia check` command now supports size checking on APK set files (`.apks`) generated from [`bundletool`](/studio/command-line/bundletool#generate_apks).\n\n### Changes\n\n- On devices running Android 8.0 (API level 26) or higher, running an instant app whose signing key doesn't match the key from any previously-launched app on the device no longer causes a crash in Android Studio or the CLI.\n- Changed the size limitation of instant apps from 4 MB to 10 MB. An app larger than 4 MB now receives a `WARNING` instead of an `ERROR`. An app larger than 10 MB continues to receive an `ERROR`.\n\nGoogle Play Instant Development SDK v1.5.0 (2018-09-27)\n-------------------------------------------------------\n\nThis release of the Google Play Instant Development SDK contains the following\nnew features and changes.\n\n### New features\n\n- The instant apps CLI `ia run` and `ia check` commands now support operating on APK set (.apks) files generated by [`bundletool`](/studio/command-line/bundletool#generate_apks).\n- The instant apps CLI `ia check` command now works with a list of APKs.\n- The instant apps CLI `ia check` command ensures that names of split APKs are unique within a given ZIP file.\n\n### Changes\n\n- When provisioning a device running Android 7.1.1 (API level 25) or lower, the CLI issues a warning only if it fails to detect a successful Google Play services check-in. When encountering this situation previously, the CLI would throw an error and not attempt to launch the instant app.\n- The instant apps CLI `ia run` can now successfully launch APKs generated by `bundletool` or APKs built using `aapt2`. Previously, the `run` operation might have appeared to time out when launching some of these APKs.\n- The `--no-setup` flag has been deprecated for `ia run` and now has no effect.\n- Properly updates older versions of Google Play services for Instant Apps, which need to be uninstalled first before installing a new version.\n\nGoogle Play Instant Development SDK v1.4.0 (2018-08-28)\n-------------------------------------------------------\n\nThis release of the Google Play Instant Development SDK (formerly Instant Apps\nDevelopment SDK) contains the following new features and changes.\n\n### New features\n\n- The instant apps CLI `ia check` command now supports size validation on instant apps using configuration APKs.\n- The CLI now supports running instant apps on test-keys emulator images with a recent version of Google Play services installed.\n- Improved support for command-specific help with `ia help \u003ccommand\u003e`.\n- Added size breakdown to `ia check` size errors.\n\n### Changes\n\n- The SDK has been renamed from \"Android Instant Apps Development SDK\" to \"Google Play Instant Development SDK\".\n- The CLI no longer throws a `NullPointerException` when trying to check an app with no launcher activity.\n- The CLI and Android Studio now detect unsupported devices running Android 8.0 (API level 26). Previously, these devices wouldn't launch the app.\n- The `ia` Bash wrapper script now works correctly when invoked in a pipeline where `$TERM` isn't set. The script assumes a width of 80 columns.\n- The `ia check` command now warns about instant apps whose `minSdkVersion` version is set to `20` or lower. By supporting these older SDK versions in your build, your binary's size might increase with no benefit for your instant apps.\n- The CLI now detects when your version of Google Play services is too old to run instant apps and prompts for an update on the device.\n- Instant apps launched on Android 8.0 (API level 26) and higher through the CLI or Android Studio now automatically have the `android.permission.INSTANT_APP_FOREGROUND_SERVICE` permission granted.\n\nAndroid Instant Apps Development SDK v1.3.0 (2018-06-04)\n--------------------------------------------------------\n\nThis release of the Android Instant Apps Development SDK\ncontains the following new features and changes.\n\n### New features\n\n- Android Studio 3.2 now uses a library added in SDK 1.3 to run instant apps. This unifies the logic between `ia` and Studio and allows you to run instant apps without URLs from Android Studio.\n\nAndroid Instant Apps Development SDK v1.2.0 (2018-05-07)\n--------------------------------------------------------\n\nThis release of the Android Instant Apps Development SDK\ncontains the following new features and changes.\n\n### New features\n\n- The new Instant Apps Command Line Interface, `ia`, allows you to launch instant apps on your development device and check them locally for common errors.\n- You can now build and launch instant apps [without a URL entry\n point](/topic/google-play-instant/getting-started/convert-to-instant-app#enable-try-now).\n\n### Changes\n\n- The version of Google Play Services for Instant Apps that's bundled with the SDK can now auto-update itself using the Play Store. In previous releases, that package was locked to the version bundled with the SDK.\n- Hostnames containing wildcard characters, such as `\"*.example.com\"`, are now fully supported in development mode.\n- Developers can now simulate throttled app downloads in Android Lollipop, Marshmallow, and Nougat by setting the `debug.aia.throttle_download_ms` system property, as shown in the following example: \n\n ```\n $ adb shell setprop debug.aia.throttle_download_ms 5000\n ```\n\nAndroid Instant Apps Development SDK v1.1.0\n-------------------------------------------\n\nThis release of the Android Instant Apps Development SDK contains the following\nnew features and changes.\n\n### New features\n\n- Transfer of data from Instant App to installed app.\n - On devices running Android 8.0 (API level 26) and above, the system automatically performs this transfer on app installation. On devices running Android 7.1 (API level 25) and lower, you can transfer your Instant App's storage data to your installed app by calling [`getInstantAppData()`](https://developers.google.com/android/reference/com/google/android/gms/instantapps/InstantAppsClient.html#getInstantAppData()) in your installed app.\n- You can decrease the size of your APK by using the new support for device-specific APKs. For information on setting up your build for configuration APKs, see [Set up your build for configuration APKs](/topic/google-play-instant/guides/config-splits).\n\n### Changes\n\n- Emulator.\n - Emulators running Play Store and the latest Google Play Services are required to test Instant Apps moving forward. For information about how to set up your emulator, see [Run your instant\n app](/topic/google-play-instant/getting-started/first-instant-app#run)."]]
