Scene：字节跳动的轻量级导航和UI组合框架-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00377/article/details/146720619

Scene：字节跳动的轻量级导航和UI组合框架

scene Android Single Activity Applications framework without Fragment. 项目地址: https://gitcode.com/gh_mirrors/scene/scene

1. 项目介绍

Scene 是由字节跳动开源的一个轻量级导航和 UI 组合框架，旨在解决传统 Android 开发中 Activity 和 Fragment 的诸多问题。它提供了一个简单、可靠且可扩展的 API，帮助开发者实现轻量级的导航和页面分割。

Scene 的主要特点包括：

简化导航栈管理，支持多导航栈
改进生命周期管理和分发
方便实现复杂的跨页面和共享元素动画
支持修改和自动恢复 Activity 和 Window 属性
支持在 Scene 之间交换数据，以及在 Scene 中请求和授予权限
支持保存和恢复 Scene 的 Parcelable 状态
无需 R8/Proguard 配置

2. 项目快速启动

添加依赖

首先，在项目的 build.gradle 文件中添加以下依赖：

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

dependencies {
    implementation 'com.github.bytedance:scene:latest_version'
    implementation 'com.github.bytedance.scene:scene_navigation:latest_version'
    implementation 'com.github.bytedance.scene:scene_ui:latest_version'
    implementation 'com.github.bytedance.scene:scene_dialog:latest_version'
    implementation 'com.github.bytedance.scene:scene_shared_element_animation:latest_version'
    implementation 'com.github.bytedance.scene:scene_ktx:latest_version'
}

创建 SceneActivity

然后，创建一个继承自 SceneActivity 的 MainActivity：

class MainActivity : SceneActivity() {
    override fun getHomeSceneClass(): Class<out Scene> {
        return MainScene::class.java
    }

    override fun supportRestore(): Boolean {
        return false
    }
}

创建 Scene

接下来，创建一个继承自 AppCompatScene 的 MainScene：

class MainScene : AppCompatScene() {
    private lateinit var mButton: Button

    override fun onCreateContentView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
        val frameLayout = FrameLayout(requireSceneContext())
        mButton = Button(requireSceneContext())
        mButton.text = "Click"
        frameLayout.addView(mButton, FrameLayout.LayoutParams(ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT))
        return frameLayout
    }

    override fun onActivityCreated(savedInstanceState: Bundle?) {
        super.onActivityCreated(savedInstanceState)
        setTitle("Main")
        toolbar?.navigationIcon = null
        mButton.setOnClickListener {
            navigationScene?.push(SecondScene())
        }
    }
}

创建另一个 SecondScene 类似：

class SecondScene : AppCompatScene() {
    private val mId: Int by lazy { View.generateViewId() }

    override fun onCreateContentView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
        val frameLayout = FrameLayout(requireSceneContext())
        frameLayout.id = mId
        return frameLayout
    }

    override fun onActivityCreated(savedInstanceState: Bundle?) {
        super.onActivityCreated(savedInstanceState)
        setTitle("Second")
        add(mId, ChildScene(), "TAG")
    }
}

最后，创建一个简单的 ChildScene：

class ChildScene : Scene() {
    override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View {
        val view = View(requireSceneContext())
        view.setBackgroundColor(Color.GREEN)
        return view
    }
}