SDK 版本说明
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
警告：Google Play 免安装体验将不再可用。自 2025 年 12 月起，将无法再通过 Google Play 发布免安装应用，并且所有 Google Play 服务免安装体验 API 将停止运行。Play 将不再通过任何机制向用户提供免安装应用。
自推出 Google Play Instant 以来，我们一直在不断投资改进生态系统，因此决定根据开发者的反馈做出此项变更。
若要继续优化以促进用户增长，我们建议开发者使用深层链接将用户引导至其常规应用或游戏，并在适当的时候将用户重定向到特定历程或功能。
Google Play 免安装体验开发 SDK v1.9.0 (2019-09-05)
此版本的 Google Play 免安装体验开发 SDK 包含以下变更。
变更
- 免安装应用 CLI 现在通过符号链接调用时会正常运行。
- 在早期版本的 SDK 中，启动 minSdkVersion < 24 并且仅使用 v2 签名方案签名的应用总是会导致错误。此变更同时修复了
ia run 和 Android Studio 的运行命令，这样仅在所连接设备的 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 的开发者团队能够更好地了解您认为有用的功能并改进我们工具中的缺点。
ia check 命令现在支持针对相同应用的可安装 build 检查常见的升级路径不兼容性。您可以使用 -i 选项提供可安装应用 APK。
变更
- 免安装应用 CLI
ia run 命令在设备上不再需要活跃的 Google 账号即可在开发模式中启动免安装应用。
Google Play 免安装体验开发 SDK v1.6.0 (2018-11-05)
此版本的 Google Play 免安装体验开发 SDK 包含以下新功能和变更。
新功能
- 免安装应用 CLI
ia check 命令现在支持对从 bundletool 生成的 APK 集文件 (.apks) 进行大小检查。
变更
- 在搭载 Android 8.0（API 级别 26）或更高版本的设备上，在所运行免安装应用的签名密钥与设备上之前启动的任何应用中的密钥不相符时，将不再导致 Android Studio 或 CLI 崩溃。
- 已将免安装应用的大小限制从 4 MB 更改为 10 MB。大于 4 MB 的应用现在收到
WARNING 而不是 ERROR。大于 10 MB 的应用继续收到 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。以前，run 操作在启动其中一些 APK 时可能看似超时。
- 针对
ia run 的 --no-setup 标记已弃用，现在没有任何作用。
- 正确更新 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”。
- 在尝试检查没有启动器 activity 的应用时，CLI 不再抛出
NullPointerException。
- CLI 和 Android Studio 现在会检测搭载 Android 8.0（API 级别 26）的不受支持设备。以前，这些设备不会启动应用。
- 在未设置
$TERM 的管道中被调用时，ia Bash 封装容器脚本现在工作正常。该脚本假定宽度为 80 列。
ia check 命令现在会针对 minSdkVersion 版本设为 20 或更低版本的免安装应用发出警告。通过在您的 build 中支持这些较早的 SDK 版本，您的二进制文件大小可能会增加，但对您的免安装应用没有好处。- CLI 现在会检测到您的 Google Play 服务版本太旧而无法运行免安装应用并在设备上提示更新。
- 在 Android 8.0（API 级别 26）及更高版本上通过 CLI 或 Android Studio 启动的免安装应用现在自动被授予
android.permission.INSTANT_APP_FOREGROUND_SERVICE 权限。
Android 免安装应用开发 SDK v1.3.0 (2018-06-04)
此版本的 Android 免安装应用开发 SDK 包含以下新功能和变更。
新功能
- Android Studio 3.2 现在使用 SDK 1.3 中添加的库来运行免安装应用。这将统一
ia 和 Studio 之间的逻辑，并允许通过 Android Studio 运行没有网址的免安装应用。
Android 免安装应用开发 SDK v1.2.0 (2018-05-07)
此版本的 Android 免安装应用开发 SDK 包含以下新功能和变更。
新功能
- 新的免安装应用命令行接口
ia 允许您在开发设备上启动免安装应用，并在本地检查它们是否出现常见错误。
- 现在无需 网址 入口点即可构建并启动免安装应用。
变更
- 与 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 设置 build，请参阅为配置 APK 设置 build。
变更
- 模拟器。
- 以后要测试免安装应用，需要运行 Play 商店和最新 Google Play 服务的模拟器。如需了解如何设置模拟器，请参阅运行免安装应用。
本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-27。
[null,null,["最后更新时间 (UTC)：2025-07-27。"],[],[],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)."]]
