Glance的actionStartActivity无法启动Activity问题求助

API 探路者

2026-4-8

最近在用Glance开发App Widget的时候卡壳了——我用actionStartActivity设置点击事件，想跳转到Main Activity，但不管怎么点都没反应，我写的代码片段大概是这样的：

@Composable
private fun MyContent(glanceModifier: GlanceModifier = GlanceModifier, widgetData: WidgetData) {
    InfoPanel(
        glanceModifier = glanceModifier
            .padding(top = 2.dp)
            .fillMaxSize()
            .background(imageProvider = ImageProvider(R.drawable.widget_background))
            .appWidgetBackground()
            .clickable {
                actionStartActivity<Main>() // 这里就是启动无响应的代码
            }
    )
}

折腾了好一会儿，总结了几个可能的排查方向，你也可以试试看：

先检查Activity的注册是否正确：一定要确保你的Main Activity在AndroidManifest.xml里正确注册，而且从Widget启动的话，android:exported属性必须设为true；如果是主入口页面，还要有对应的intent-filter，示例如下：

<activity
    android:name=".MainActivity"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

检查泛型参数是否正确：我代码里写的actionStartActivity<Main>会不会是类名写错了？是不是应该对应MainActivity::class.java的泛型，也就是写成actionStartActivity<MainActivity>()？这种细节拼写错误很容易踩坑。
排查Glance版本兼容性：如果用的是较旧的Glance版本，说不定存在actionStartActivity的已知bug，可以试试升级到最新的稳定版依赖。
查看日志找线索：用adb logcat过滤相关日志，看看点击Widget时有没有报错信息，比如“Activity not found”或者权限相关的错误，这些日志能直接定位问题根源。
确认点击事件的作用域：有没有可能是glanceModifier的顺序有问题？比如clickable被后面的修饰符覆盖了？可以调整修饰符顺序，把clickable放在靠后的位置试试。

希望这些方法能帮你解决问题，我也是踩了好几个坑才总结出来的。

内容来源于stack exchange