InstantApps.showInstallPrompt报错“Item not found(含重试选项)”求助

我之前帮不少开发者排查过这类Instant App的跳转故障，这个“Item not found”弹窗大概率是配置或API使用环节出了疏漏，咱们逐一排查：

1. 先确认Play Console的关联配置 #

这是最常见的根源：你必须在Play Console里把Instant App和对应的完整应用正确绑定。操作路径是：

• 打开完整应用的Play Console页面
• 找到「Instant apps」选项卡
• 确认已经添加了你的Instant App模块，且状态显示正常（没有报错或未审核状态）
  如果这里没关联好，系统根本找不到对应的完整应用，自然会弹出“Item not found”。

2. 核对跳转API的使用是否符合minSdk要求 #

你提到文档里说minSdkVersion 26+可以用特定方法，这里一定要注意：

• 若你的Instant App minSdk是26及以上，必须使用InstallManager和InstallRequest来发起下载请求，不要用旧的Intent跳转方式。示例代码如下：

// Kotlin示例
val installManager = getSystemService(InstallManager::class.java)
val installIntent = InstallRequest.createIntent()
    .setPackage("com.your.full.app.package") // 这里填完整应用的包名！
startActivity(installIntent)

// Java示例
InstallManager installManager = (InstallManager) getSystemService(Context.INSTALL_SERVICE);
Intent installIntent = InstallRequest.createIntent()
        .setPackage("com.your.full.app.package");
startActivity(installIntent);

如果误用了旧的ACTION_INSTALL_PACKAGE Intent，在高版本系统上不仅会失效，还会导致找不到应用的问题。

3. 检查跳转时的包名是否正确 #

很多开发者在这里踩坑：必须填写完整应用的正式包名，而不是Instant App的包名。比如你的Instant App包名是com.your.app.instant，但完整应用包名是com.your.app，代码里一定要填后者，填错包名直接会触发“Item not found”。

4. 验证测试环境的有效性 #

• 确保测试设备上的Play商店是最新版本，且登录的账号是你在Play Console里的开发者账号（或已加入测试名单的账号）
• 尽量用带Google Play服务的官方模拟器或实体设备测试，普通第三方模拟器可能无法正常连接Play商店服务

5. 确认完整应用的发布状态 #

如果你的完整应用还处于内部测试/封闭测试阶段，只有被添加到测试名单的账号才能访问。如果测试设备的账号不在名单里，也会出现“Item not found”。可以先把完整应用发布到内部测试，再将测试账号加入列表后重试。

内容的提问来源于stack exchange，提问作者hermt2