介绍

Hikage (发音 /ˈhɪkɑːɡeɪ/) 是一个由 Kotlin DSL 驱动的 Android View 实时运行时框架。

背景

这是一个由 Kotlin DSL 驱动的 Android View 运行时框架，它的设计聚焦于 实时代码构建 UI。

项目图标由 MaiTungTM在新窗口中打开设计，名称取自「BanG Dream It's MyGO!!!!!」中的原创歌曲《春日影》(Haruhikage)。

为什么要...

なんで春日影レイアウトしたの？

它的第二层寓意为「阳光下的影子」，它象征着这个框架的设计理念：Hikage 就像影子一样，能够在不干扰开发者原有习惯和项目结构的前提下，提供一套更现代、更高效的 UI 构建系统。

Hikage 专注于原生 Android View 生态系统，将 Kotlin DSL 驱动的布局体验带入经典的 View 框架，让你能够以极快的速度构建布局，并 100% 开箱即用地支持传统和标准原生组件。

Hikage 不生产 UI 组件，它只是 Android 17 年原生 View 生态的搬运工。

为什么是 Hikage？

Hikage 主要适用于专注原生 Android 平台开发的开发者，自从 Kotlin 作为主要开发语言后，依然没有一套比较完美的方案能够实现动态代码布局，所以没有使用 Jetpack Compose 的项目依然需要使用原始的 XML，虽然有着 ViewBinding 的支持，但是依然不是很友好。

Hikage 保留了 Android 原生 View 的命名方式，并吸收了 Anko在新窗口中打开、Splitties在新窗口中打开以及 Jetpack Compose DSL 的设计理念，使其既贴近原生，又拥有现代 Kotlin DSL 的开发体验。

示例如下

LinearLayout(
    lparams = LayoutParams(matchParent = true) {
        topMargin = 16.dp
    },
    init = {
        orientation = LinearLayout.VERTICAL
        gravity = Gravity.CENTER
    }
) {
    TextView {
        text = "Hello, World!"
        textSize = 16f
        gravity = Gravity.CENTER
    }
}

Hikage 能即插即用并在任何地方创建一个可被设置到父布局以及 Window 上的 View 对象。

同时它全面兼容混合式布局，你可以在 Hikage 中嵌入 XML (使用 R.layout 方案装载布局)、ViewBinding 甚至是 Jetpack Compose。

示例如下

LinearLayout(
    lparams = LayoutParams(matchParent = true),
    init = {
        orientation = LinearLayout.VERTICAL
    }
) {
    // 嵌入 XML 布局
    Layout(R.layout.my_layout)

    // 嵌入 ViewBinding 布局
    Layout<MyLayoutBinding>()

    // 嵌入 Jetpack Compose 布局
    ComposeView {
        Text("Hello, World!")
    }
}

相比于 Anko、Splitties 这种纯 DSL 的脚手架轻量依赖库，Hikage 带来的整套生态系统支持动态构建 AttributeSet，这套方案已经通过了模拟器、实机的交互测试与基准测试，稳定兼容 Android 5.0.2 (API 21) ~ 17 (API 37)，这使得不支持动态设置属性的老旧自定义组件也能通过 Hikage 重获新生。

示例如下

TextView(
    attrs = {
        android {
            // 以下内容等价于 android:text="Set text in dynamic AttributeSet"
            set("text", "Set text in dynamic AttributeSet")
            set("textSize", "16sp")
            set("gravity", "center")
            set("paddingLeft", "8dp")
            // 支持动态类型投射
            set("paddingRight", 8.dp)
        }
    }
) {
    text = "Overriden text in code"
}

更多使用方法可以前往 hikage-core → XML 属性集合以继续了解。

同时，Hikage 原生适配了 Android Studio 的布局预览功能，能够在不运行应用的情况下直接在 IDE 中预览布局效果，更多使用方法可以前往 hikage-core → 预览布局以继续了解。

从现在开始，放弃并忘记 XML、ViewBinding 甚至是 findViewById，直接来尝试使用代码布局吧！

不会 Jetpack Compose？没关系，今天 Hikage 就是你的 Kotlin DSL 版 XML，把静态 XML 的布局体验带到运行时，用 Kotlin 在运行时构建原生 Android View。

Hikage 配合我们的另一个项目 BetterAndroid在新窗口中打开使用效果更佳，同时 Hikage 自身将自动引用其 ui-extension在新窗口中打开作为核心依赖。

语言要求

推荐使用 Kotlin 作为首选开发语言，本项目完全使用 Kotlin 编写，且不再有计划兼容 Java。

文档全部的 Demo 示例代码都将使用 Kotlin 进行描述，如果你完全不会使用 Kotlin，那么你将有可能无法正常使用本项目。

功能贡献

本项目的维护离不开各位开发者的支持和贡献，目前这个项目处于初期阶段，可能依然存在一些问题或者缺少你需要的功能，如果可能，欢迎提交 PR 为此项目贡献你认为需要的功能或前往 GitHub Issues在新窗口中打开向我们提出建议。

# 介绍

# 背景

# 为什么是 Hikage？

# 语言要求

# 功能贡献

介绍

背景

为什么是 Hikage？

语言要求

功能贡献