adb shell am instrument 命令详解

官网关于该命令的详解:https://developer.android.com/studio/command-line/adb.html?hl=zh-cn

1 Instrument是什么?

instrument为am命令的一个子命令。用于启动一个Instrumentation测试。首先连接手机或者模拟器,通过adb shell命令,进入shell层进行操作。

2 命令格式及参数解读(来自官网)

格式:instrument [optionscomponent

目标 component 是表单 test_package/runner_class,在UiAutomator2.0中,目标 component为:测试包名/android.support.test.runner.AndroidJUnitRunner(即运行器固定:AndroidJUnitRunner类是一个JUnit测试运行器,允许运行JUnit 3或JUnit 4测试类在 Android 设备上,包括那些使用Espresso和UI Automator框架。)

各项参数:

  • -r:以原始形式输出测试结果;该选项通常是在性能测试时与[-e perf true]一起使用。
  • -e name value:提供了以键值对形式存在的过滤器和参数。例如:-e testFile <filePath>(运行文件中指定的用例);-e package <packageName>(运行这个包中的所有用例)……  有十几种。
  • -p file:将分析数据写入 file
  • -w:测试运行器需要使用此选项。-w <test_package_name>/<runner_class> :<test_package_name>和<runner_class>在测试工程的AndroidManifest.xml中查找,作用是保持adb shell打开直至测试完成。
  • --no-window-animation:运行时关闭窗口动画。
  • --user user_id | current:指定仪器在哪个用户中运行;如果未指定,则在当前用户中运行。

3  怎么运行手机中现有的instrumentation, 并输出详细结果,同时将profiling性能数据写到本地文件中?

  • 先列出手机中已安装的instrumentation:adb shell pm list instrumentation
  • adb shell am instrument  XXX

4  命令的具体使用,比如com.le.tcauto.uitest.test是包含所有测试代码的应用的包名:(来自:http://blog.csdn.net/swordgirl2011/article/details/50881390)

  •   运行所有的用例: adb shell am instrument -w com.le.tcauto.uitest.test/android.support.test.runner.AndroidJUnitRunner
  •   运行一个类中的所有用例:

          adb shell am instrument -w -r -e class com.letv.leview.setproxy com.le.tcauto.uitest.test/android.support.test.runner.AndroidJUnitRunner

  •   运行类中的某个方法:adb shell am instrument -w -r   -e debug false -e class com.letv.leview.setproxy#testDemo com.le.tcauto.uitest.test/android.support.test.runner.AndroidJUnitRunner
  •   运行多个类的所有用例:adb shell am instrument -w -r   -e debug false -e class com.letv.leview.setproxy,com.letv.leview.resetdate com.le.tcauto.uitest.test/android.support.test.runner.AndroidJUnitRunner
  •   运行所有测试用例除了指定的类:adb shell am instrument -w -r -e notClass com.letv.leview.setproxy com.le.tcauto.uitest.test/android.support.test.runner.AndroidJUnitRunner
  •   运行所有测试除了指定的用例:adb shell am instrument -w -r   -e debug false -e class com.letv.leview.setproxy#testDemo com.le.tcauto.uitest.test/android.support.test.runner.AndroidJUnitRunner
  •   运行文件中的所列的用例:adb shell am instrument -w -e testFile /sdcard/tmp/testFile.txt com.android.foo/com.android.test.runner.AndroidJUnitRunner   文件制定的 格式为:com.android.foo.FooClaseName#testMethodName
  •  运行指定测试切片的用例:adb shell am instrument -w -e numShards 4 -e shardIndex 1 com.android.foo/android.support.test.runner.AndroidJUnitRunner
  • 运行指定注解的测试用例:adb shell am instrument -w -e annotation com.android.foo.MyAnnotation com.android.foo/android.support.test.runner.AndroidJUnitRunner。如果使用多个选项,则运行的用例为两者的交集,比如:“-e size large -e annotation com.android.foo.MyAnnotation”,将只运行同时含LargeTest和MyAnnotation注解的用例。
  • 运行没有指定注解的用例:adb shell am instrument -w -e notAnnotation com.android.foo.MyAnnotation com.android.foo/android.support.test.runner.AndroidJUnitRunner,指定多个注解,用“,”隔开,e.g. adb shell am instrument -w -e notAnnotation com.android.foo.MyAnnotation,com.android.foo.AnotherAnnotation com.android.foo/android.support.test.runner.AndroidJUnitRunner
  • 以上所有参数也可以通过<meta-data>标签配置在AndroidManifest文件,比如 <meta-data android:name="listener" android:value="com.foo.Listener"/>,通过shell命令 传入的参数将覆盖AndroidManifest文件中配置的参数。

5  开始容易写错?

AS ——Select Run/Debug —— Configuration ——Edit Configuration ——配置 ——OK

运行完成,下方会显示该命令,然后copy过来。




获取包名、资源文件id

假设已经有一个待测试APK,将其安装到安卓设备上。通过adb指令、Android Studio的Device Monitor可以获取其页面的包名、控件的id等信息。

用adb查看当前的Activity

 
  1. adb shell dumpsys activity activities | sed -En -e '/Running activities/,/Run #0/p'
  2. Running activities (most recent first):
  3. TaskRecord{5323d558 #32 A com.jzj1993.unittest U 0}
  4. Run #1: ActivityRecord{5311cd60 u0 com.jzj1993.unittest/.MainActivity}
  5. TaskRecord{5309f8c8 #2 A com.android.launcher U 0}
  6. Run #0: ActivityRecord{52fc9ac0 u0 com.android.launcher/com.android.launcher2.Launcher}

签名的统一

如果有待测试APK的签名源文件,则直接配置给测试工程即可。如果没有,可以通过工具对待测试APK进行重新签名,使其与TestRunner的签名一致即可。

测试项目的实现

用Android Studio创建一个Android项目,包名和被测试APK一致,签名与待测APK保持一致。
按照白盒测试一样的方式进行配置。可参考本系列文章的第三篇。
代码主目录main中不用写任何代码(写了也不影响)。
在androidTest目录下编写黑盒测试代码。

TestRunner的编译和执行

前面创建好的项目,如果直接使用Android Studio进行测试运行,实际上Android Studio会执行以下操作:

  • gradle assembleDebug,打包主目录main中的待测试APK
  • gradle assembleDebugAndroidTest,打包测试目录androidTest中的TestRunner
  • adb install -r app/build/outputs/apk/app-debug.apk,安装build目录生成的待测试APK
  • adb install -r app/build/outputs/apk/app-debug-androidTest-unaligned.apk,安装build目录生成的TestRunner
  • adb shell am instrument -w com.jzj1993.test_instrumentation.test/android.test.InstrumentationTestRunner,运行TestRunner

现在只需要手动执行其中的部分操作即可,即:打包TestRunner、安装TestRunner、运行TestRunner,最终命令行输出测试成功的信息,同时可以看到安卓设备中进行黑盒测试的APK已经按照测试代码执行。

 
  1. gradle clean
  2. gradle assembleDebugAndroidTest
  3. adb install -r app/build/outputs/apk/app-debug-androidTest-unaligned.apk
  4. adb shell am instrument -w com.jzj1993.test_instrumentation.test/android.test.InstrumentationTestRunner
  5. com.jzj1993.test_instrumentation.ApplicationTest:..
  6. com.jzj1993.test_instrumentation.ToastTest:.
  7. Test results for InstrumentationTestRunner=...
  8. Time: 5.311
  9. OK (3 tests)

在adb shell am instrument命令中,还可以指定-e参数,只运行TestRunner中指定的类。例如我可以在测试代码中写一个ToastTest和一个DialogTest,编译后如果不指定-e参数,则默认每个Test都会先后被执行,而如果指定-e参数,可以只运行ToastTest。

 
  1. adb shell am instrument -e class com.jzj1993.test_instrumentation.ToastTest -w com.jzj1993.test_instrumentation.test/android.test.InstrumentationTestRunner


运行测试时的一些报错

找不到TestRunner

 
  1. adb shell am instrument -w com.jzj1993.black.test/android.test.InstrumentationTestRunner
  2. INSTRUMENTATION_STATUS: id=ActivityManagerService
  3. INSTRUMENTATION_STATUS: Error=Unable to find instrumentation info for: ComponentInfo{com.jzj1993.black.test/android.test.InstrumentationTestRunner}
  4. INSTRUMENTATION_STATUS_CODE: -1
  5. android.util.AndroidException: INSTRUMENTATION_FAILED: com.jzj1993.black.test/android.test.InstrumentationTestRunner
  6. at com.android.commands.am.Am.runInstrument(Am.java:802)
  7. at com.android.commands.am.Am.onRun(Am.java:242)
  8. at com.android.internal.os.BaseCommand.run(BaseCommand.java:47)
  9. at com.android.commands.am.Am.main(Am.java:75)
  10. at com.android.internal.os.RuntimeInit.nativeFinishInit(Native Method)
  11. at com.android.internal.os.RuntimeInit.main(RuntimeInit.java:235)
  12. at dalvik.system.NativeStart.main(Native Method)

一般是因为TestRunner没有安装成功,或者在命令中写错包名等,可以用adb shell pm list instrumentation查看已经安装的TestRunner。

找不到被测试包 Target Package

 
  1. adb shell am instrument -w com.jzj1993.test_instrumentation.test/android.test.InstrumentationTestRunner
  2. INSTRUMENTATION_STATUS: id=ActivityManagerService
  3. INSTRUMENTATION_STATUS: Error=Unable to find instrumentation target package: com.jzj1993.test_instrumentation
  4. INSTRUMENTATION_STATUS_CODE: -1
  5. android.util.AndroidException: INSTRUMENTATION_FAILED: com.jzj1993.test_instrumentation.test/android.test.InstrumentationTestRunner
  6. at com.android.commands.am.Am.runInstrument(Am.java:802)
  7. at com.android.commands.am.Am.onRun(Am.java:242)
  8. at com.android.internal.os.BaseCommand.run(BaseCommand.java:47)
  9. at com.android.commands.am.Am.main(Am.java:75)
  10. at com.android.internal.os.RuntimeInit.nativeFinishInit(Native Method)
  11. at com.android.internal.os.RuntimeInit.main(RuntimeInit.java:235)
  12. at dalvik.system.NativeStart.main(Native Method)

一般是因为待测试包没有安装成功,或者TestRunner的Target和安装的包不一致。

找不到目标类 ClassNotFound

 
  1. adb shell am instrument -w com.jzj1993.black.test.test/android.test.InstrumentationTestRunner
  2. android.test.suitebuilder.TestSuiteBuilder$FailedToCreateTests:
  3. Error in testSuiteConstructionFailed:
  4. java.lang.RuntimeException: Exception during suite construction
  5. at android.test.suitebuilder.TestSuiteBuilder$FailedToCreateTests.testSuiteConstructionFailed(TestSuiteBuilder.java:238)
  6. at java.lang.reflect.Method.invokeNative(Native Method)
  7. at android.test.AndroidTestRunner.runTest(AndroidTestRunner.java:191)
  8. at android.test.AndroidTestRunner.runTest(AndroidTestRunner.java:176)
  9. at android.test.InstrumentationTestRunner.onStart(InstrumentationTestRunner.java:554)
  10. at android.app.Instrumentation$InstrumentationThread.run(Instrumentation.java:1701)
  11. Caused by: java.lang.reflect.InvocationTargetException
  12. at java.lang.reflect.Constructor.constructNative(Native Method)
  13. at java.lang.reflect.Constructor.newInstance(Constructor.java:417)
  14. at android.test.suitebuilder.TestMethod.instantiateTest(TestMethod.java:87)
  15. at android.test.suitebuilder.TestMethod.createTest(TestMethod.java:73)
  16. at android.test.suitebuilder.TestSuiteBuilder.addTest(TestSuiteBuilder.java:262)
  17. at android.test.suitebuilder.TestSuiteBuilder.build(TestSuiteBuilder.java:184)
  18. at android.test.InstrumentationTestRunner.onCreate(InstrumentationTestRunner.java:379)
  19. at android.app.ActivityThread.handleBindApplication(ActivityThread.java:4435)
  20. at android.app.ActivityThread.access$1300(ActivityThread.java:141)
  21. at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1316)
  22. at android.os.Handler.dispatchMessage(Handler.java:99)
  23. at android.os.Looper.loop(Looper.java:137)
  24. at android.app.ActivityThread.main(ActivityThread.java:5103)
  25. at java.lang.reflect.Method.invokeNative(Native Method)
  26. at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:737)
  27. at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:553)
  28. at dalvik.system.NativeStart.main(Native Method)
  29. Caused by: java.lang.ClassNotFoundException: com.jzj1993.black.MainActivity
  30. at java.lang.Class.classForName(Native Method)
  31. at java.lang.Class.forName(Class.java:204)
  32. at java.lang.Class.forName(Class.java:169)
  33. at com.jzj1993.black.test.BlackBoxTest.<init>(BlackBoxTest.java:17)
  34. ... 18 more
  35. Caused by: java.lang.NoClassDefFoundError: com/jzj1993/black/MainActivity
  36. ... 22 more
  37. Caused by: java.lang.ClassNotFoundException: Didn't find class "com.jzj1993.black.MainActivity" on path: DexPathList[[zip file "/system/framework/android.test.runner.jar", zip file "/data/app/com.jzj1993.black.test.test-1.apk", zip file "/data/app/com.jzj1993.black.test-2.apk"],nativeLibraryDirectories=[/data/app-lib/com.jzj1993.black.test.test-1, /data/app-lib/com.jzj1993.black.test-2, /system/lib]]
  38. at dalvik.system.BaseDexClassLoader.findClass(BaseDexClassLoader.java:53)
  39. at java.lang.ClassLoader.loadClass(ClassLoader.java:501)
  40. at java.lang.ClassLoader.loadClass(ClassLoader.java:461)
  41. ... 22 more
  42. Test results for InstrumentationTestRunner=.E
  43. Time: 0.008
  44. FAILURES!!!
  45. Tests run: 1, Failures: 0, Errors: 1

这个错误是TestRunner抛出的异常。常见有几种可能:

  • 测试代码中的目标包名、类名,和实际安装在设备上的APK包名、类名不一致;
  • TestRunner的包名和被测试包名不匹配(一般情况下,例如被测试APK包名为com.example.target,则TestRunner包名应为com.example.target.test);
  • 其他

签名不一致

 
  1. adb shell am instrument -w com.jzj1993.test_instrumentation.test/android.test.InstrumentationTestRunner
  2. INSTRUMENTATION_STATUS: id=ActivityManagerService
  3. INSTRUMENTATION_STATUS: Error=Permission Denial: starting instrumentation ComponentInfo{com.jzj1993.test_instrumentation.test/android.test.InstrumentationTestRunner} from pid=9230, uid=9230 not allowed because package com.jzj1993.test_instrumentation.test does not have a signature matching the target com.jzj1993.test_instrumentation
  4. INSTRUMENTATION_STATUS_CODE: -1
  5. java.lang.SecurityException: Permission Denial: starting instrumentation ComponentInfo{com.jzj1993.test_instrumentation.test/android.test.InstrumentationTestRunner} from pid=9230, uid=9230 not allowed because package com.jzj1993.test_instrumentation.test does not have a signature matching the target com.jzj1993.test_instrumentation
  6. at android.os.Parcel.readException(Parcel.java:1431)
  7. at android.os.Parcel.readException(Parcel.java:1385)
  8. at android.app.ActivityManagerProxy.startInstrumentation(ActivityManagerNative.java:2938)
  9. at com.android.commands.am.Am.runInstrument(Am.java:801)
  10. at com.android.commands.am.Am.onRun(Am.java:242)
  11. at com.android.internal.os.BaseCommand.run(BaseCommand.java:47)
  12. at com.android.commands.am.Am.main(Am.java:75)
  13. at com.android.internal.os.RuntimeInit.nativeFinishInit(Native Method)
  14. at com.android.internal.os.RuntimeInit.main(RuntimeInit.java:235)
  15. at dalvik.system.NativeStart.main(Native Method)原网址

原网址:http://www.paincker.com/android-test-7

             https://www.cnblogs.com/insist8089/p/6897037.html


  • 3
    点赞
  • 18
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值