高德地图 SDK 接口测试接入（AndroidTest 上手）

学习资料

官方文档

在 Android 平台上测试应用 | Android 开发者 | Android Developers

测试了解

【玩转Test】开篇-Android test 介绍

Android单元测试全解_android 单元测试_一代小强的博客-CSDN博客

Android单元测试-对Activity的测试_activitytestrule_许佳佳233的博客-CSDN博客

单元测试注解相关

ActivityScenarioRule懒加载_airgreen的博客-CSDN博客

学习资料可以了解一下，不用进行深入，重点需要的准备在下面。

前置准备

按照 Android 项目导入高德 SDK 使用（从小白到入门）这篇文档，把高德地图 SDK 环境给部署在自己的空项目中，然后能够正常的调用基本高德地图SDK
学习SDK这部分看到什么程度，了解即可。不熟悉可以照着文档控件交互-与地图交互-开发指南-Android 地图SDK | 高德地图API 调用SDK接口写几个简单的功能能够正常运行展示即可）
了解 Junit 框架的一些注解和断言方法就没问题，不用深入

步骤记录

简单上手 AndroidTest 来测试验证高德地图SDK的接口,简单记录一下操作过程

0、首先我们有一个部署好高德 SDK 环境的项目，能够正常显示一个地图 MapView 。

1、把下列配置代码贴到模块的 build.gradle 文件里面，在 dependencies 闭包中

testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.3'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'

    //测试添加
    implementation 'androidx.recyclerview:recyclerview:1.1.0'
    implementation 'androidx.appcompat:appcompat:1.1.0'
    implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
//    implementation 'pub.devrel:easypermissions:2.0.1'
    implementation 'com.google.code.gson:gson:2.8.5'
    androidTestImplementation 'com.android.support.test:runner:1.0.2'
//    androidTestImplementation 'com.android.support.test:rules:1.0.2'
    androidTestImplementation 'androidx.test:rules:1.1.0'
    androidTestImplementation 'com.android.support:support-annotations:28.0.0'
    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
    androidTestImplementation 'com.android.support.test.uiautomator:uiautomator-v18:2.1.3'

2、我们在 AndroidTest 的 test 测试类中默认就能看到有下列代码，之后我们就会在 androidTest 目录下的类中写测试用例代码。

[图片]

3、我们在 layout 建一个页面视图activity_exercise.xml，添加一个 mapView 标签即可，在对应的 Java类 ExerciseActivity 显示地图，这里可以设置一个默认显示的地图中心点，方便后面进行测试验证。


public class ExerciseActivity extends AppCompatActivity {

    public MapView mapView;

    public static final LatLng SHANGHAI = new LatLng(31.238068, 121.501654);

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_exercise);

        mapView = findViewById(R.id.map);// findViewByid()得到mapView一定要在onCreate里面

        mapView.onCreate(savedInstanceState);// 显示地图
        changeToCenter();// 改变地图的中心点

    }

    /**
     * 获取到该页面的 map控制对象
     * @return
     */
    public AMap getMap(){// 测试类可以通过 activity 拿到这个AMap对象进行 验证 高德地图对象 的其他接口
        return ((MapView)findViewById(R.id.map)).getMap();
    }

// 改变地图默认显示的中心点
    public void changeToCenter(){
        AMap aMap = mapView.getMap();
        aMap.moveCamera(CameraUpdateFactory.newCameraPosition(new CameraPosition(SHANGHAI,10.0f,10.0f,10.0f)));
    }

}

可以运行一下这个App代码，看在手机上是否运行成功，显示上海为中心点

[图片]

5、在 AndroidTest 测试类中加入 ActivityTestRule @Rule，表明这个测试类对哪个 activity 进行测试（之后在每次测试用例代码执行前然后进行 Activity 初始化，进行 Activity 启动等操作）

- ActivityTestRule - Android中文版 - API参考文档
- JUnit单元测试6—@Rule注解

这个类和注解的作用可以看一下文档了解一下，在测试方法执行之前对Activity初始化

[图片]


@Rule
public ActivityTestRule<被测试类> activityTestRule = new ActivityTestRule<>(被测试类.class);

6、拿到 Activity页面中的 AMap对象，对其进行测试。

被测试的 activity 类中的方法，都可以通过 activityTestRule.getActivity() 的方法进行拿到

注意：最好记住，线程睡眠几秒，有时候set之后直接get，测试的程序执行太快，在手机Map上有些元素还没加载，所以在 get 之前可以强制线程等待几秒


  /**
     * 设置一个中心点，对于中心点的坐标进行测试
     */
    @Test
    public void testCase2(){

        Log.i("START TESTCASE1","测试 中心点坐标 的用例开始执行！！！");

        LatLng SHANGHAI = new LatLng(31.238068, 121.501654);
        AMap aMap = activityTestRule.getActivity().getMap();
//        aMap.moveCamera(CameraUpdateFactory.newCameraPosition(CameraPosition.builder().target(SHANGHAI).bearing(10.0f).tilt(10.0f).zoom(10.0f ).build()));

        try {
            Thread.sleep(3000);
        } catch (InterruptedException e) {
            throw new RuntimeException(e);
        }

        Assert.assertEquals(SHANGHAI.latitude,aMap.getCameraPosition().target.latitude,0.1);// 第三个参数dalt是误差，float、double比较都需要写一个误差值，精度有时候设置的不一样，造成误差

    }

7、点击执行，查看用例执行的结果。

[图片]

8、之后我们就可以在其他的 testcase 方法中对高德 aMap 对象的其他接口方法进行验证，查看断言结果，来熟悉测试用例编写的过程。

/**
 * 验证 设置map_type 的方法是否正常
 */
public void testCase3(){

    Log.i("START TESTCASE1","测试 MAP_TYPE的用例开始执行！！！");

    AMap aMap = activityTestRule.getActivity().getMap();
    aMap.setMapType(AMap.MAP_TYPE_NIGHT);

    try {
        Thread.sleep(3000);
    } catch (InterruptedException e) {
        throw new RuntimeException(e);
    }

    Assert.assertEquals("测试case3未通过！",AMap.MAP_TYPE_NIGHT,aMap.getMapType());

}

/**
 * 验证 地图 控件显示 是否符合 预期
 */
@Test
public void testCase4() throws InterruptedException {
    Log.i("START TESTCASE2", "测试 地图的UI控件是否按照预期显示");

    AMap aMap = activityTestRule.getActivity().getMap();
    UiSettings settings = aMap.getUiSettings();

    // 显示指南针，预期结果为true

    boolean expect = true;
    settings.setCompassEnabled(expect);

    // 等待 3s
    try {
        Thread.sleep(3000);
    } catch (InterruptedException e) {
        throw new RuntimeException(e);
    }

    boolean actual = settings.isCompassEnabled();

    // 然后断言
    Assert.assertEquals("未通过测试用例！！",expect,actual);
}