Skip to content

Latest commit

 

History

History
321 lines (252 loc) · 11.9 KB

README_CN.md

File metadata and controls

321 lines (252 loc) · 11.9 KB
Raw

weiV

English

我开发了世界上最快的通用排序算法，它平均比快速排序快 3 倍，最多快 20 倍，ChenSort

wave.webp

weiV（发音同 wave），一个基于 Android View 系统的全新声明式 UI 开发框架。核心源文件只有 35 KB。

下载 weiV Counter apk 构建 counter release 混淆包只用了 4 秒，大小只有 41 KB。 weiV_Counter_effect.webp

if ("weiV" == "View".reversed()) {
    Log.d(
        "weiV",
        "它意味着控制反转，你始终应该直接操作 UI 的描述 Widget 而不是直接操作 View。"
    )
}

它具有以下优势：

  1. 声明式的 UI 写法让原生开发效率翻倍
  2. 达到或超越 View 系统的性能
    1. 我将我的 Flutter ConstraintLayout 移植到 Android，依托它先进的布局算法，在不引入固有特性测量的情况下，让 View 树中的子元素在任何情况都只会被 layout 一次，使得任意嵌套不会引起性能问题。即便 View 树中的每个层级宽高都是 wrap_content 和 match_parent 混用
    2. xml 将被抛弃
  3. 你所有的现有 View 系统的经验都将得到保留
  4. 所有的现有 UI 组件都将得以复用
  5. 它使用 Kotlin 编写，但友好的支持 Java
  6. 目前已经开始初步支持实时生效的动态化。你可以下发 JS，使用 JS 来写页面逻辑，并生成描述 Widget 树的 JSON 传递给原生，原生使用非反射的方式将其转为真正的 Widget 树并渲染。后面可能会考虑在 JS 中实现声明式 API

为什么 weiV 基于 View 系统却能在性能上有超越 View 系统的可能？

  1. 抛弃了 xml，首帧总是渲染更快
  2. 增强版的约束布局解决了嵌套导致的性能问题，对于复杂布局，非首帧渲染也可能更快
  3. 增强版的约束布局使得布局层次更加扁平化，对于一般布局，非首帧渲染也可能更快
  4. 其它情况性能相当接近

体验 Flutter 版本的增强约束布局在线示例

没有人愿意推翻自己过去在 View 系统的经验，Compose 的设计太过糟糕。

进展

目前完成了 DSL 的定义，可以解析成 Widget 树了，DSL 风格如下：

Kotlin 风格：

class WeiVCounterKotlinActivity : WeiVActivity() {
    private var count = 0
    private val maxCount = 10
    private val minCount = 0

    override fun build() = WeiV {
        Flex {
            it.orientation = FlexDirection.VERTICAL

            Button(text = "Add count", enable = count < maxCount, onClick = {
                setState {
                    count++
                }
            })

            Button(text = "Sub count", enable = count > minCount, onClick = {
                setState {
                    count--
                }
            })

            Text(text = "count = $count")
        }
    }
}

Java 风格：

public class WeiVCounterJavaActivity extends BaseWeiVJavaActivity {
    private int count = 0;
    private int maxCount = 10;
    private int minCount = 0;

    @Override
    public WeiV build() {
        return WeiV(() -> {
            Flex((it) -> {
                it.wOrientation(FlexDirection.VERTICAL);

                Button().wText("Add count").wEnable(count < maxCount).wOnClick(v -> {
                    setState(() -> {
                        count++;
                    });
                });

                Button().wText("Sub count").wEnable(count > minCount).wOnClick(v -> {
                    setState(() -> {
                        count--;
                    });
                });

                Text().wText("count = " + count);
            });
        });
    }
}

effect.gif

目前已实现以下功能，并还在快速迭代中

  1. 可扩展
    1. 轻松适配第三方控件以实现声明式 API
    2. 内部的实现可替换，比如 Text 默认使用 TextView 渲染，你可以替换成 AppCompatTextView
  2. 基于 WebView 提供了 JsContext，配合 WeiVParser 可实现简易的动态化，后面会继续增强
  3. 友好的、完整的支持 Java
  4. 提供了 XmlViewWidget 让你无需写扩展即可内嵌所有现有 View 并实现声明式 API
  5. 提供了 StatefulWidget 以实现子树状态的单独管理，有了它你不再需要 Fragment
  6. 提供了 WeiVView、WeiVJavaView 来把 weiV 嵌入到任何地方
  7. 提供了 ConstWidget 达到了和 Flutter const Widget 同样的效果

Kotlin：

class WeiVCounterKotlinActivity : WeiVActivity() {
    override fun build(buildCount: Int) = WeiV {
        // 使用 Const 包裹的子树不会得到更新，Lambda 只会执行一次
        Const(buildCount = buildCount) {
            Text(text = "Widgets wrapped by Const will not be updated, count = $count")
        }
    }
}

Java：

class WeiVCounterJavaActivity extends WeiVJavaActivity {
    public WeiV build(int buildCount) {
        // 使用 Const 包裹的子树不会得到更新，Lambda 只会执行一次
        Const(buildCount, () -> {
            Text().wText("Widgets wrapped by Const will not be updated, count = " + count);
        });
    }
}
  1. 提供了全局 Widget 创建和更新的 Hook，可轻松实现换肤、夜间模式
  2. 提供了 UI 模块化方案
  3. 已完善声明式架构的核心逻辑，Diff 算法复杂度为 O(2n) 或 O(4n)，代码经过极致优化

近期计划：

  1. 移植 Flutter ConstraintLayout 以实现上述性能目标，并带来前所未有的开发效率和体验，Compose 提供的 ConstraintLayout 还没摆脱命令式思维，用起来实在是低效
  2. 重写 RecyclerView、ViewPager2 等常用核心控件以实现声明式 API
  3. 对所有系统内置常用组件进行包装以实现声明式 API，部分可能会重写
  4. 以极其简单的方式支持动画，属性动画在声明式体系下已不合适
  5. 开发布局预览，这个可能有点麻烦
  6. 移植 Flutter PVState，提供在声明式 UI 下更轻量好用的状态管理方案
  7. 内置轻量级的 QuickJS 引擎，使用纯 JS（抛弃 HTML、CSS）来开发跨平台 App，摆脱对 WebView 的依赖并实现原生和 JS 之间互相高性能的同步调用
  8. 为 Android 实现带状态的热重载。通过开发一个 Android Studio 插件，当你更改了代码以后，插件根据最新代码生成 Widget 树的 JSON 并通过 ADB 发送到 App，App 将 JSON 还原成真实的 Widget 树并重新渲染 UI。整个过程应用的状态得以保留。这将进一步提升 Android 开发的效率

预计所有的代码写完，代码量在 3 万行左右。

终极目标：Java 下的唯一声明式 UI 开发框架，Kotlin 下比 Compose 更好的声明式 UI 开发框架。

有人可能会说 Compose 支持跨平台，我想跨平台你应该首选 Flutter 而不是 Compose。

在任何时候都应该优先考虑使用 Flutter 来开发 UI 部分。即便没有跨端的需求，在性能不成问题的时，它带给你的效率是成倍的。未来也许 80% 的 UI 将采用 Flutter 构建。如果你因为嵌套地狱放弃了 Flutter，那么现在是时候重新捡起来了，因为我的 Flutter ConstraintLayout 已经根治了嵌套地狱。

weiV 是可扩展的。它会内置所有常用的 Widget，这些 Widget 都是对系统 View 的包装。但对于第三方库，就需要写扩展，写起来也极其简单，比如给 Button 的扩展如下：

class weiVButton(
    key: Key? = null,
    var text: String = "",
    var textSize: Float = TextConst.defaultTextSize,
    var textColor: Int = TextConst.defaultTextColor,
    var onClick: View.OnClickListener? = null,
    var enable: Boolean = true
) :
    LeafRenderWidget<Button>(key), IWeiVExtension {

    override fun createView(context: Context): Button = Button(context)

    override fun doParameter(view: Button, first: Boolean): Button {
        if (view.text != text) {
            view.text = text
        }
        if (view.currentTextColor != textColor) {
            view.setTextColor(textColor)
        }
        if (view.textSize != textSize) {
            view.textSize = textSize
        }
        view.setOnClickListener(onClick)
        if (view.isEnabled != enable) {
            view.isEnabled = enable
        }
        return view
    }

    @JavaOnly
    fun wKey(key: Key? = null): weiVButton {
        this.key = key
        return this
    }

    @JavaOnly
    fun wText(text: String = ""): weiVButton {
        this.text = text
        return this
    }

    @JavaOnly
    fun wTextSize(textSize: Float = TextConst.defaultTextSize): weiVButton {
        this.textSize = textSize
        return this
    }

    @JavaOnly
    fun wTextColor(textColor: Int = TextConst.defaultTextColor): weiVButton {
        this.textColor = textColor
        return this
    }

    @JavaOnly
    fun wOnClick(onClick: View.OnClickListener?): weiVButton {
        this.onClick = onClick
        return this
    }

    @JavaOnly
    fun wEnable(enable: Boolean = true): weiVButton {
        this.enable = enable
        return this
    }

    override fun toString(): String {
        return "weiVButton(text = $text, enable = $enable)"
    }
}

@KotlinOnly
fun WeiV.Button(
    key: Key? = null,
    text: String = "",
    textSize: Float = TextConst.defaultTextSize,
    textColor: Int = TextConst.defaultTextColor,
    onClick: View.OnClickListener? = null,
    enable: Boolean = true
) {
    addLeafRenderWidget(
        weiVButton(
            key = key,
            text = text,
            textSize = textSize,
            textColor = textColor,
            onClick = onClick,
            enable = enable
        )
    )
}

weiV 基于 View 系统，因此它可以嵌入到 View 树的任何地方。你可以在 weiV 中嵌入 Flutter、Compose，也可以在 Compose、Flutter 里嵌入 weiV。推荐在 Compose 顶层嵌入 weiV 以改善 Compose 的性能。😀

订阅我的微信公众号以及时获取 weiV 的最新动态。后续也会分享一些高质量的、独特的、有思想的 Flutter 和 Android 技术文章。

official_account.webp

支持我

如果它对你帮助很大，可以考虑赞助我一杯奶茶，或者给个 star。你的支持是我继续维护的动力。

Paypal

sponsorship.webp

感谢以下网友的赞助，我们一起让 weiV 越来越好。

  1. 庸人自扰 2022.06.06
  2. 杨永安 2022.07.02

联系方式

[email protected]

协议

MIT License

Copyright (c) 2022 hackware1993

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
associated documentation files (the "Software"), to deal in the Software without restriction,
including without limitation the rights to use, copy, modify, merge, publish, distribute,
sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial
portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES
OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.