Android开发：如何在小组件面板中显示1x1尺寸的快捷方式？

针对你在Pixel 9 API 35环境下遇到的快捷方式无法在小组件面板显示的问题，按以下步骤排查解决：

1. 确认Static Shortcut配置正确性 #

Static Shortcut需在安装时被系统识别，修改后必须卸载重装应用才能生效：

• 在AndroidManifest.xml的<application>标签内添加meta-data引用快捷方式配置文件：

  <meta-data
      android:name="android.app.shortcuts"
      android:resource="@xml/shortcuts" />
  

• 在res/xml/shortcuts.xml中，确保每个<shortcut>标签包含必填字段：

  <shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
      <shortcut
          android:shortcutId="static_1"
          android:shortcutShortLabel="@string/shortcut_short"
          android:shortcutLongLabel="@string/shortcut_long"
          android:shortcutIcon="@drawable/ic_shortcut">
          <intent
              android:action="android.intent.action.VIEW"
              android:targetPackage="com.your.package"
              android:targetClass="com.your.package.TargetActivity" />
          <categories android:name="android.shortcut.conversation" />
      </shortcut>
  </shortcuts>
  

  注意：targetPackage和targetClass必须指向可直接启动的Activity，不能是Service或其他组件。

2. 修正Pinned Shortcut的调用逻辑 #

Pinned Shortcut不会直接出现在小组件面板，而是需用户确认后添加到桌面；若要在小组件面板显示，需使用Static/Dynamic Shortcut。如果是测试Pinned Shortcut，需确保：

• 调用时机为用户主动触发（如按钮点击），系统会拦截后台自动调用的请求：

  val shortcutInfo = ShortcutInfo.Builder(context, "pinned_1")
      .setShortLabel("Pinned Shortcut")
      .setIcon(Icon.createWithResource(context, R.drawable.ic_pinned))
      .setIntent(Intent(context, TargetActivity::class.java).setAction(Intent.ACTION_VIEW))
      .build()
  
  ShortcutManagerCompat.requestPinShortcut(context, shortcutInfo, null)
      .addOnCompleteListener {
          if (it.isSuccessful) {
              // 固定成功，快捷方式将出现在桌面
          }
      }
  

3. 确保Dynamic Shortcut的添加逻辑 #

Dynamic Shortcut需通过代码主动添加，且需满足系统显示规则：

• 使用ShortcutManager动态添加，设置合理的rank值（值越小优先级越高）：

  val shortcutManager = getSystemService(ShortcutManager::class.java)
  val dynamicShortcut = ShortcutInfo.Builder(this, "dynamic_1")
      .setShortLabel("Dynamic Shortcut")
      .setLongLabel("My 1x1 Dynamic Shortcut")
      .setIcon(Icon.createWithResource(this, R.drawable.ic_dynamic))
      .setIntent(Intent(Intent.ACTION_VIEW, Uri.parse("yourapp://dynamic")))
      .setRank(0)
      .build()
  shortcutManager.dynamicShortcuts = listOf(dynamicShortcut)
  

• 添加后可杀掉应用进程再重启，确保系统刷新快捷方式列表。

4. 检查系统显示设置 #

在Pixel 9 API 35中，需确认应用快捷方式未被系统隐藏：

1. 打开系统设置 → 应用 → 你的应用 → 快捷方式
2. 确保“允许快捷方式”开关处于开启状态，且对应快捷方式未被禁用

5. 虚拟设备缓存清理 #

若上述步骤无效，尝试清除应用缓存或重启模拟器：

• 在模拟器中打开设置 → 应用 → 你的应用 → 存储 → 清除数据
• 或重启模拟器，避免系统缓存导致的显示异常

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