Android Studio自定义View无法XML预览渲染问题求助

核心原因 #

XML预览时，Android Studio的预览进程不会初始化App的Koin容器，若自定义View在构造阶段直接调用Koin注入依赖，就会触发java.lang.IllegalStateException: No Koin Context configured异常。

可行解决方案 #

方案1：添加预览安全的构造逻辑 #

利用View自带的isInEditMode方法区分预览/运行环境，预览时使用模拟依赖替代Koin注入：

class CustomView @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null,
    defStyleAttr: Int = 0
) : View(context, attrs, defStyleAttr) {

    private val dependency: YourDependency by lazy {
        if (isInEditMode) {
            // 返回模拟依赖实例，保证预览渲染正常
            MockYourDependency()
        } else {
            // 运行时正常使用Koin注入
            get()
        }
    }

    // 自定义View其他逻辑...
}

方案2：为预览进程单独初始化Koin #

在自定义View的初始化块中，针对预览环境初始化极简Koin容器，仅提供当前View所需依赖：

class CustomView @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null,
    defStyleAttr: Int = 0
) : View(context, attrs, defStyleAttr) {

    init {
        if (isInEditMode) {
            startKoin {
                modules(module {
                    single<YourDependency> { MockYourDependency() }
                })
            }
        }
    }

    private val dependency: YourDependency by inject()

    // 自定义View其他逻辑...
}

注：预览进程独立于App运行进程，此初始化不会与正式环境的Koin配置冲突。

方案3：延迟依赖注入到View附着阶段 #

若项目使用ViewBinding/DataBinding，将依赖注入逻辑移至onAttachedToWindow()方法，避免在构造阶段触发Koin调用：

class CustomView @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null,
    defStyleAttr: Int = 0
) : View(context, attrs, defStyleAttr) {

    private lateinit var dependency: YourDependency

    override fun onAttachedToWindow() {
        super.onAttachedToWindow()
        dependency = if (isInEditMode) {
            MockYourDependency()
        } else {
            get()
        }
    }

    // 自定义View其他逻辑...
}

验证提示 #

修改完成后，点击XML预览面板的「Refresh」按钮重新渲染；若仍有问题，检查模拟依赖的实现是否完整，避免因未初始化属性导致二次崩溃。

内容的提问来源于stack exchange，提问作者Priyanka