Mavericks框架中的Mock启动器使用指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00593/article/details/148488566

Mavericks框架中的Mock启动器使用指南

mavericks Mavericks: Android on Autopilot 项目地址: https://gitcode.com/gh_mirrors/ma/mavericks

什么是Mavericks启动器

Mavericks启动器是Mavericks框架提供的一个强大工具，它能够自动收集应用中所有可Mock的Mavericks视图，并以可视化方式展示它们及其可用的Mock状态。这个功能特别适合开发阶段快速验证不同UI状态，无需手动编写大量测试代码或构建复杂导航路径。

基本使用

要使用启动器功能，首先需要添加相关依赖。然后在代码中通过简单调用即可显示启动器界面：

MavericksLauncherActivity.show(context)

启动器界面会列出所有可Mock的Fragment，开发者可以选择任意Fragment和其Mock状态，系统会将其在新的Activity中打开。这种方式让UI状态验证变得极其简单直观。

自定义启动行为

默认情况下，Fragment会在一个普通的Activity中加载。但很多情况下，我们的Fragment可能依赖于特定的宿主Activity（比如使用了特定主题或功能的Activity）。Mavericks提供了灵活的自定义方式：

// 设置自定义Activity类
MavericksLauncherMockActivity.activityToShowMock = YourCustomActivity::class.java

在自定义Activity中，需要通过以下方式显示Mock视图：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    
    if (savedInstanceState == null) {
        MavericksLauncherMockActivity.showNextMockFromActivity(
            activity = this,
            showView = { mavericksView ->
                // 自定义显示逻辑
            }
        )
    }
}

命令行操作

对于自动化测试场景，Mavericks启动器支持通过ADB命令直接调用：

adb shell am start -n com.your.package/com.airbnb.mvrx.launcher.MavericksLauncherActivity

启动器还支持两种实用的参数：

直接打开特定视图：通过viewNameToOpen参数可以指定要打开的Fragment或Mock名称
```
adb shell am start -n com.your.package/... --es viewNameToOpen MyFragment
```
批量测试视图：通过viewNamePatternToTest参数可以测试所有名称匹配的视图
```
adb shell am start -n com.your.package/... --es viewNamePatternToTest com_my_package
```

对于包含空格的参数，需要使用引号包裹：

adb shell "am start -n com.your.package/... --es viewNameToOpen 'Default state'"

Jetpack Navigation集成

如果你的应用使用了Jetpack Navigation，需要特别注意：默认启动器无法识别导航图。解决方案是创建一个自定义Activity，在其中配置你的导航图。可以参考Mavericks示例模块中的LauncherActivity实现。

自动化Mock测试

启动器提供了一个"Test All"按钮，可以自动依次打开所有Mock状态，检查是否有初始化崩溃。虽然这种测试相对基础，但它能有效捕捉明显的初始化问题。

测试默认使用MavericksLauncherTestMocksActivity，但你可以通过设置MavericksLauncherTestMocksActivity.provideIntentToTestMock来自定义测试行为。

使用限制与最佳实践

独立性要求：Mock的Fragment必须能够独立运行，不能假设其他Fragment或Activity的存在。所有依赖都应该通过依赖注入解决。
状态管理：初始化阶段会阻止网络请求等异步操作，防止它们覆盖Mock状态。初始化完成后，ViewModel会恢复正常功能。
ViewModel处理：对于existingViewModel，启动器会将其转换为activityViewModel行为，因为我们是"跳入"某个流程中间，之前的ViewModel实例并不存在。