scene怎么配置主题和模块？依赖组合、Scene.setTheme与排查说明

想了解 scene 怎么配置模块和页面主题，可以先看官方 GitHub：https://github.com/bytedance/scene。它是一个面向 Android 单 Activity 架构的页面导航与 UI 组合框架，README 同时列出了导航、UI、Fragment 兼容、Dialog、共享元素动画和 Kotlin 扩展等模块。本文只按官方仓库与 Wiki 的公开说明，整理依赖选择、Scene.setTheme 和排查时需要留意的上下文边界。

scene 适合希望把页面切换、页面组合和 Activity/Fragment 兼容关系集中管理的 Android 开发者；实际接入仍应以项目当前的 Android、AndroidX 与 Gradle 配置为准。

• 官方仓库定位为 Android Single Activity Framework，并兼容 Fragment。
• README 提供 navigation、ui、fragment、dialog、shared element animation、ktx 等模块入口。
• 不同 Scene 可以设置独立主题资源，官方示例使用 setTheme。
• 设置主题后，Scene 创建 View 的 Context 会是 ContextWrapper，需要按该上下文边界排查资源访问问题。

scene 的模块入口怎么选

官方仓库把 scene 描述为轻量的导航和 UI 组合框架。开发者可以根据项目需要组合基础框架、导航、UI、Fragment 兼容、Dialog、共享元素动画和 Kotlin 扩展等能力，不必把所有模块都当成必选项。选择依赖时，先确认页面是否需要导航栈，再确认是否要承接现有 Fragment 或补充特定的动画、Dialog 能力，并以仓库当前 README 的依赖写法为准。

主题配置与排查提醒

官方 Wiki 的 Theme 页面说明，每个 Scene 都可以拥有不同的主题资源，示例是在 onCreateView 中调用 setTheme 后再创建布局。Wiki 同时提醒，调用 setTheme 后，Scene 创建出来的 View 的 Context 是 ContextWrapper，而不是 Activity。遇到颜色、样式或资源解析与预期不一致时，应先检查资源是否从正确的 Scene 上下文获取，再核对主题资源本身；不要仅凭 Activity 上下文的表现推断 Scene 内部结果。

主题设置属于页面外观和资源上下文配置，不等同于导航栈、生命周期或状态保存机制。若问题发生在返回、恢复或页面切换阶段，应回到对应的 NavigationScene、Scene 生命周期和状态管理文档核对，避免把不同层次的问题混在一起。

接入时的常见问题

scene 是一个可以直接安装的 Android 应用吗？

不是。当前官方仓库将 scene 作为 Android 开源框架和依赖库介绍，使用场景是集成到 Android 工程，而不是面向普通用户的独立应用。

是不是必须一次性引入所有 scene 模块？

不必。README 展示了多个可选模块，建议按项目是否需要导航、Fragment 兼容、Dialog、动画或 Kotlin 扩展来组合，并在构建时按项目的仓库和版本配置验证。

为什么设置主题后资源读取行为变了？

官方 Wiki 明确提醒，调用 setTheme 后 Scene 创建 View 的 Context 是 ContextWrapper。排查时应优先从 Scene 提供的上下文获取主题相关资源，并检查主题资源是否确实应用到当前页面。

遇到页面返回异常，应该先查主题吗？

不一定。主题主要影响样式和资源上下文；返回异常通常还涉及导航栈或生命周期。建议先区分是外观资源问题，还是 Scene push、pop、恢复过程的问题，再查看官方 Wiki 对应章节。

使用边界

scene 的公开资料面向 Android 工程开发。本文没有把仓库中的示例、应用使用案例或版本标签扩展成对所有项目都成立的性能承诺；接入前应结合自身 Android 版本、AndroidX、Gradle 与测试设备验证。官方入口仍以 https://github.com/bytedance/scene 为准，Wiki 主题说明可查看 https://github.com/bytedance/scene/wiki/Theme。