单元测试中TextUtils.isDigitsOnly()始终返回false的处理方案咨询

原因分析 #

单元测试默认运行在JVM环境下，而非Android设备/模拟器环境，Android SDK中的TextUtils.isDigitsOnly()方法在纯JVM测试场景中没有被正确模拟，导致无论输入合法数字串还是非数字串，都返回false。

解决方案 #

方案1：使用Robolectric框架模拟Android环境 #

Robolectric可以在JVM上模拟完整的Android运行环境，让你正常调用Android SDK方法：

1. 在模块的build.gradle（或build.gradle.kts）中添加适配SDK33的Robolectric依赖：

testImplementation 'org.robolectric:robolectric:4.12.1'

2. 在JUnit4测试类上添加注解配置：

import android.text.TextUtils;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.robolectric.RobolectricTestRunner;
import org.robolectric.annotation.Config;
import static org.junit.Assert.*;

@RunWith(RobolectricTestRunner.class)
@Config(sdk = 33) // 指定与项目匹配的SDK版本
public class YourTestClass {
    @Test
    public void testDigitsOnly() {
        assertTrue(TextUtils.isDigitsOnly("111"));
        assertFalse(TextUtils.isDigitsOnly("aaa"));
    }
}

如果使用JUnit5，需配置Robolectric扩展，具体可参考Robolectric官方文档的JUnit5适配说明。

方案2：改用Android Instrumented测试 #

如果需要在真实设备或模拟器上验证方法行为，将测试代码移至androidTest目录（而非test目录），直接运行Instrumented测试：

import android.text.TextUtils;
import androidx.test.ext.junit.runners.AndroidJUnit4;
import org.junit.Test;
import org.junit.runner.RunWith;
import static org.junit.Assert.*;

@RunWith(AndroidJUnit4.class)
public class YourInstrumentedTest {
    @Test
    public void testDigitsOnly() {
        assertTrue(TextUtils.isDigitsOnly("111"));
        assertFalse(TextUtils.isDigitsOnly("aaa"));
    }
}

方案3：手动模拟方法行为（临时应急） #

若不想引入第三方框架，可使用PowerMock手动模拟TextUtils.isDigitsOnly()的返回值：

1. 添加PowerMock依赖到build.gradle：

testImplementation 'org.powermock:powermock-module-junit4:2.0.9'
testImplementation 'org.powermock:powermock-api-mockito2:2.0.9'

2. 在测试类中实现模拟：

import android.text.TextUtils;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.powermock.core.classloader.annotations.PrepareForTest;
import org.powermock.modules.junit4.PowerMockRunner;
import static org.junit.Assert.*;
import static org.powermock.api.mockito.PowerMockito.*;

@RunWith(PowerMockRunner.class)
@PrepareForTest(TextUtils.class)
public class YourTestClass {
    @Test
    public void testDigitsOnly() {
        mockStatic(TextUtils.class);
        when(TextUtils.isDigitsOnly("111")).thenReturn(true);
        when(TextUtils.isDigitsOnly("aaa")).thenReturn(false);
        
        assertTrue(TextUtils.isDigitsOnly("111"));
        assertFalse(TextUtils.isDigitsOnly("aaa"));
    }
}

推荐方案 #

优先选择方案1（Robolectric），它能在JVM上快速执行测试，同时完整模拟Android SDK行为；若需要验证真实设备上的表现，再使用方案2（Instrumented测试）。方案3仅作为临时 workaround，长期维护成本较高。

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