SDK 版本資訊
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
警告:Google Play 免安裝應用程式將停止提供服務。2025 年 12 月起,您無法透過 Google Play 發布免安裝應用程式,且所有 Google Play 服務免安裝 API 都將停止運作。Play 不會再透過任何機制向使用者提供免安裝應用程式。
我們根據開發人員的意見,並持續投入資源改善 Google Play Instant 推出後的生態系統,做出這項變更。
如要持續促進使用人數成長,建議開發人員使用深層連結,將使用者導向標準版應用程式或遊戲,並在適當情況下將他們重新導向至特定路徑或功能。
Google Play 免安裝應用程式開發 SDK 1.9.0 版 (2019 年 9 月 5 日)
這個版本的 Google Play 免安裝應用程式開發 SDK 包含下列變更。
變更內容
- 透過符號連結叫用時,即時應用程式 CLI 現在可正常執行。
- 在舊版 SDK 中,如果啟動的應用程式 minSdkVersion < 24,且僅透過 v2 簽署配置簽署,一律會導致錯誤。這項變更修正了
ia run
和 Android Studio 的執行指令,因此只有在連線裝置的 API 版本太舊,無法支援 v2 簽章時,才會發生錯誤。
Google Play 免安裝開發 SDK 1.8.0 版 (2019 年 8 月 5 日)
這個版本的 Google Play 免安裝應用程式開發 SDK 包含下列變更。
變更內容
- 即時應用程式 CLI
ia run
指令只能部署使用 v2 簽署配置簽署的即時應用程式。
- 免安裝應用程式 CLI
ia run -u [url]
指令現在不需部署構件即可運作。
Google Play 免安裝應用程式開發 SDK v1.7.0 (2019 年 3 月 29 日)
這個版本的 Google Play 免安裝應用程式開發 SDK 包含下列新功能和變更。
新功能
- 現在,只要您同意,即時應用程式 CLI 就能收集使用情況指標,讓 Google 開發團隊進一步瞭解您覺得實用的功能,並改善工具的缺點。
ia check
指令現在支援針對相同應用程式的可安裝版本進行檢查,找出常見的升級路徑不相容問題。您可以使用 -i
選項提供可安裝的應用程式 APK。
變更內容
- 現在,免安裝應用程式 CLI
ia run
指令不需要裝置上的有效 Google 帳戶,就能以開發模式啟動免安裝應用程式。
Google Play 免安裝開發 SDK v1.6.0 (2018 年 11 月 5 日)
這個版本的 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 1.5.0 版 (2018 年 9 月 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 Studio 現在會偵測搭載 Android 8.0 (API 級別 26) 的不支援裝置。先前這些裝置無法啟動應用程式。
- 在未設定
$TERM
的管道中叫用時,ia
Bash 包裝函式指令碼現在可正常運作。指令碼假設寬度為 80 欄。
ia check
指令現在會針對版本設為 20
以下的即時應用程式發出警告。minSdkVersion
在建構作業中支援這些舊版 SDK,可能會導致二進位檔大小增加,但對即時應用程式沒有任何好處。
- CLI 現在會偵測 Google Play 服務版本是否過舊,無法執行免安裝應用程式,並提示在裝置上更新。
- 透過 CLI 或 Android Studio 在 Android 8.0 (API 級別 26) 以上版本啟動的免安裝應用程式,現在會自動取得
android.permission.INSTANT_APP_FOREGROUND_SERVICE
權限。
Android 免安裝應用程式開發 SDK 1.3.0 版 (2018 年 6 月 4 日)
這個版本的 Android 免安裝應用程式開發 SDK 包含下列新功能和變更。
新功能
- Android Studio 3.2 現在會使用 SDK 1.3 中新增的程式庫執行免安裝應用程式。這項功能可統一
ia
和 Studio 之間的邏輯,讓您從 Android Studio 執行沒有網址的免安裝應用程式。
Android Instant Apps Development SDK v1.2.0 (2018-05-07)
這個版本的 Android 免安裝應用程式開發 SDK 包含下列新功能和變更。
新功能
- 新的 Instant Apps 指令列介面
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 1.1.0 版
這個版本的 Android 免安裝應用程式開發 SDK 包含下列新功能和變更。
新功能
- 將資料從免安裝應用程式轉移至已安裝的應用程式。
- 在搭載 Android 8.0 (API 級別 26) 以上版本的裝置上,系統會在安裝應用程式時自動執行這項轉移作業。在搭載 Android 7.1 (API 級別 25) 以下版本的裝置上,您可以呼叫已安裝應用程式中的
getInstantAppData()
,將即時應用程式的儲存空間資料轉移至已安裝的應用程式。
- 您可以使用裝置專用 APK 的新支援功能,縮減 APK 大小。如要瞭解如何為設定 APK 設定版本,請參閱「為設定 APK 設定版本」。
變更內容
- 模擬器。
- 如要測試免安裝應用程式,必須使用執行 Play 商店和最新版 Google Play 服務的模擬器。如要瞭解如何設定模擬器,請參閱「執行免安裝應用程式」。
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間:2025-07-27 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間: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)."]]