开发者控制台

应用性能脚本

应用性能脚本

性能测试是测试兼容性、可靠性、速度、响应时间、稳定性等应用性能指标以及Fire平板电脑和Fire TV设备中资源使用情况的过程。该测试可以找出性能瓶颈,并通过与开发者沟通来提升性能。移动应用测试在很大程度上受关键性能指标 (KPI) 驱动,测试过程中会在亚马逊设备上执行一组特定的KPI和步骤,并使用亚马逊设备或通用设备上的日志等资源来进行指标计算。

本页介绍了针对提交至亚马逊应用商店的应用进行性能KPI测试所需的步骤和代码段。测试针对的基础KPI是延迟、准备就绪时间和内存,或视频流媒体播放。

设置

开始之前,请在开发计算机上安装以下软件程序包:

除了安装这些软件程序包之外,还需要完成以下操作:

  • 为JAVA_HOME和ANDROID_HOME文件夹设置路径。
  • 在设备上启用开发者模式,并启用USB调试。如需了解相关说明,请参阅启用开发者模式
  • 捕获设备udid或Device_Identifier。如需了解相关说明,请参阅DSN

测试策略

测试期间将使用应用启动器意图或Monkey工具多次进行应用的启动和强制停止。在各次迭代之间应执行某些必要的操作,例如捕获ADB logcat、执行导航操作(准备就绪时间和内存KPI)、从Android Vitals/ADB日志中捕获计时器值,以及在强制停止应用之前捕获内存和RAM使用情况。此循环将持续进行至达到配置的迭代次数为止。由于测试结果可能受到网络条件、系统负载和其他因素的影响,因此应采用多次迭代来抵消外部因素的干扰。对于延迟KPI,建议至少运行50次迭代;对于准备就绪时间KPI,建议至少运行10次迭代;对于内存KPI,建议运行至少5次迭代

从性能测试中捕获的日志、屏幕截图和其他工件稍后可用于调试或其他关键信息。清理工作包括强制停止Appium设备对象。

获取设备类型

以下代码示例提供了可添加到测试自动化脚本中的代表性测试方法。

Java
public String get_device_type() {
  String deviceType = null;
  try (BufferedReader read = new BufferedReader(new InputStreamReader
                    (Runtime.getRuntime().exec
                    ("adb -s "+ DSN +" shell getprop ro.build.configuration")
                    .getInputStream()))) 
  {
            String outputLines = read.readLine();
            switch (outputLines) {
                case "tv":
                    deviceType = "FTV";
                    break;
                case "tablet":
                    deviceType = "Tablet";
                    break;
  }
  catch (Exception e) {
     System.***out***.println("Exception while getting device type info: " + e); 
  }
  return deviceType;
}
Kotlin
import java.io.BufferedReader
import java.io.InputStreamReader

fun getDeviceType(): String? {
    var deviceType: String? = null
    try {
        BufferedReader(InputStreamReader(Runtime.getRuntime().exec("adb -s $DSN shell getprop ro.build.configuration").inputStream)).use { read ->
            val outputLines = read.readLine()
            when (outputLines) {
                "tv" -> deviceType = "FTV"
                "tablet" -> deviceType = "Tablet"
            }
        }
    } catch (e: Exception) {
        println("获取设备类型信息时出现异常:$e")
    }
    return deviceType
}

生成应用的主启动器活动

使用以下代码示例生成主启动器活动。此方法可以提取在测应用的主活动,然后将应用程序包和主活动相结合,生成主启动器活动。

Java
try (BufferedReader read = new BufferedReader(new InputStreamReader
                    (Runtime.getRuntime().exec("adb -s "+ DSN +" shell pm dump"+ appPackage +" | grep -A 1 MAIN").getInputStream()))) {
            String outputLine = null;
            while ((line = read.readLine()) != null) {
                if (line.contains(appPackage + "/")) {
                    break;
                }
            }
            
            outputLine = outputLine.split("/")[1];
            outputLine = outputLine.split(" ")[0];
            String appLauncherIntent = appPackage + "/" + outputLine;
            return appLauncherIntent
}
catch (Exception e) {
        System.out.println("生成应用主活动时出现异常" + e);
}            
Kotlin
import java.io.BufferedReader
import java.io.InputStreamReader

try {
    val process = Runtime.getRuntime().exec("adb -s $DSN shell pm dump $appPackage | grep -A 1 MAIN")
    val inputStream = process.inputStream
    val reader = BufferedReader(InputStreamReader(inputStream))
    var line: String? = null
    var outputLine: String? = null
    while (reader.readLine().also { line = it } != null) {
        if (line!!.contains("$appPackage/")) {
            break
        }
    }
    outputLine = outputLine!!.split("/")[1]
    outputLine = outputLine!!.split(" ")[0]
    val appLauncherIntent = "$appPackage/$outputLine"
    appLauncherIntent
} catch (e: Exception) {
    println("生成应用主活动时出现异常:$e")
}

使用主启动器活动(应用意图)启动应用

使用以下代码示例,通过应用意图或是应用程序包和主活动启动应用。

Java
try (BufferedReader read = new BufferedReader(new InputStreamReader
                    (Runtime.getRuntime().exec("adb -s "+ DSN +" shell am start -n " + appActivity).getInputStream()))) {
            String deviceName = getDeviceName(DSN);
            String line;
            while ((line = read.readLine()) != null) {
                if (line.startsWith("Starting: Intent")) {
                    System.out.println("使用以下应用意图成功启动应用 - " + appIntent);
                    break;
                } else if (line.contains("Error")) {
                    System.out.println("应用启动错误");
                }
            }
        } catch (Exception e) {
            System.out.println("使用应用意图启动应用时出现异常" + e);
        }
Kotlin
import java.io.BufferedReader
import java.io.InputStreamReader

val process = Runtime.getRuntime().exec("adb -s $DSN shell am start -n $appActivity")
val inputStream = process.inputStream
val reader = BufferedReader(InputStreamReader(inputStream))

try {
    val deviceName = getDeviceName(DSN)
    var line: String?
    while (reader.readLine().also { line = it } != null) {
        if (line!!.startsWith("Starting: Intent")) {
            println("使用应用意图成功启动应用 - $appIntent")
            break
        } else if (line!!.contains("Error")) {
            println("启动应用时出现错误")
        }
    }
} catch (e: Exception) {
    println("使用应用意图启动应用时出现异常:$e")
}

使用Monkey工具启动应用

使用以下代码,通过Monkey工具启动应用。

Java
try {
     String monkeyCommand = null;
     if (DEVICE_TYPE.equals(FTV)) {
          monkeyCommand = " shell monkey --pct-syskeys 0 -p "
     }
     else {
          monkeyCommand = " shell monkey -p "
     }
     
     BufferedReader launchRead = new BufferedReader(new InputStreamReader
            (Runtime.getRuntime().exec("adb -s "+ DSN + monkeyCommand + appPackage +" -c android.intent.category.LAUNCHER 1").getInputStream()));
      
     String line;
     while ((line = launchRead.readLine()) != null) {
         if (line.contains("Events injected")) {
             System.out.println("使用Monkey工具成功启动应用 - " + appPackage);
             launchRead.close();
             return true;
         } 
         else if (line.contains("Error") || line.contains("No activities found")) {
             System.out.println("通过Monkey工具使用意图启动应用时出现错误”);
             launchRead.close();
             return false;
         }
     }
}
catch (Exception e) {
     System.out.println("使用Monkey启动应用时出现异常" + e);
     return false;
}  
Kotlin
try {
     val monkeyCommand: String?
     if (DEVICE_TYPE == FTV) {
          monkeyCommand = " shell monkey --pct-syskeys 0 -p "
     }
     else {
          monkeyCommand = " shell monkey -p "
     }
     val launchRead = BufferedReader(InputStreamReader(
            Runtime.getRuntime().exec("adb -s $DSN $monkeyCommand $appPackage -c android.intent.category.LAUNCHER 1").inputStream))
     var line: String?
     while (launchRead.readLine().also { line = it } != null) {
         if (line!!.contains("Events injected")) {
             println("使用Monkey工具成功启动应用 - $appPackage")
             launchRead.close()
             return true
         } 
         else if (line!!.contains("Error") || line!!.contains("No activities found")) {
             println("通过Monkey工具使用意图启动应用时出现错误")
             launchRead.close()
             return false
         }
     }
}
catch (e: Exception) {
     println("使用Monkey启动应用时出现异常:$e")
     return false
}

强制停止应用

使用以下代码示例强制停止应用。

Java
try {
       Runtime.getRuntime().exec("adb -s "+ DSN +" shell am force-stop " + appPackage);
       System.out.println("已强制停止应用 - " + appPackage);
} 
catch (Exception e) {
       System.out.println("强制停止应用时出现异常" + e);
}
Kotlin
try {
    Runtime.getRuntime().exec("adb -s ${DSN} shell am force-stop ${appPackage}")
    println("已强制停止应用 - $appPackage")
} catch (e: Exception) {
    println("强制停止应用时出现异常:$e")
}

延迟KPI

显示第一帧之前的延迟是指应用从启动到绘制出第一帧所花费的时间。该指标用于衡量以不同方式启动应用时的性能。此KPI用于再现用户行为和改善用户体验。

在以编程方式启动应用之前,您需要一些基本参数,例如应用的程序包名称、main_activity或其他详情。

日志中使用的常见缩写

Java
public String COOL_APP = "cool_app_launch_time";
public String COOL_ACTIVITY = "cool_activity_launch_time";
public String WARM_APP_WARM = "warm_app_warm_transition_launch_time";
public String WARM_APP_COOL = "warm_app_cool_transition_launch_time";
public String AM_ACTIVITY_LAUNCH_TIME = "am_activity_launch_time:";
public String WM_ACTIVITY_LAUNCH_TIME = "wm_activity_launch_time:";
public String WARM_ACTIVITY_LAUNCH_TIME = "performance:warm_activity_launch_time:";
public String AM_FULLY_DRAWN = "am_activity_fully_drawn_time:";
public String WM_FULLY_DRAWN = "wm_activity_fully_drawn_time:";
Kotlin
const val COOL_APP: String = "cool_app_launch_time"
const val COOL_ACTIVITY: String = "cool_activity_launch_time"
const val WARM_APP_WARM: String = "warm_app_warm_transition_launch_time"
const val WARM_APP_COOL: String = "warm_app_cool_transition_launch_time"
const val AM_ACTIVITY_LAUNCH_TIME: String = "am_activity_launch_time:"
const val WM_ACTIVITY_LAUNCH_TIME: String = "wm_activity_launch_time:"
const val WARM_ACTIVITY_LAUNCH_TIME: String = "performance:warm_activity_launch_time:"
const val AM_FULLY_DRAWN: String = "am_activity_fully_drawn_time:"
const val WM_FULLY_DRAWN: String = "wm_activity_fully_drawn_time:"

使用的常规ADB logcat命令

使用以下代码示例捕获带有线程时间的ADB日志,以获取应用的性能延迟指标。

Java
public String ADB_LOGCAT_DUMP = "adb shell logcat -v threadtime -b all -d";
public String ADB_LOGCAT_CLEAR = "adb shell logcat -v threadtime -b all -c";


//下面的方法用于将ADB命令附加到设备的DSN值
public Process adb(String DSN, String message) {
 Process process = null;
  try {
      process = Runtime.getRuntime().exec("adb -s " + DSN + message);
    } 
  catch (Exception e) {
      System.out.println("执行ADB命令时出现错误" + e);
  }
  return process;
}
Kotlin
public const val ADB_LOGCAT_DUMP: String = "adb shell logcat -v threadtime -b all -d"
public const val ADB_LOGCAT_CLEAR: String = "adb shell logcat -v threadtime -b all -c"

//下面的函数用于将ADB命令附加到设备的DSN值

fun adb(DSN: String, message: String): Process? {
    return try {
        Runtime.getRuntime().exec("adb -s $DSN$message")
    }
    catch (e: Exception) {
        println("Exception while executing adb commands$e")
        null
    }
}

从Android Vitals缓冲区日志捕获计时器值

使用以下代码示例从Android Vitals缓冲区中筛选出性能延迟计时器值。

Java
public int get_vitals_timer(File logFile, String appPackage, String metricSearch) {
   BufferedReader reader = null;
   String line_Metric;
   int timer = 0;
   
   try {
       reader = new BufferedReader(new FileReader(logFile))
        while ((line_Metric = reader.readLine()) != null) {
                if (line_Metric.contains("performance:" + metricSearch) 
                && line_Metric.contains("key=" + appPackage)) {
                    timer = splitToTimer(line_Metric);
            }
    }
    catch (Exception e) {
        System.out.println(e);
    } 
    finally {
        reader.close();
    }
   return timer;     
} 
Kotlin
import java.io.File

fun getVitalsTimer(logFile: File, appPackage: String, metricSearch: String): Int {
    var reader: BufferedReader? = null
    var lineMetric: String
    var timer = 0
    try {
        reader = logFile.bufferedReader()
        while (reader.readLine().also { lineMetric = it } != null) {
            if (lineMetric.contains("performance:$metricSearch") && lineMetric.contains("key=$appPackage")) {
                timer = splitToTimer(lineMetric)
            }
        }
    } catch (e: Exception) {
        println(e)
    } finally {
        reader?.close()
    }
    return timer
}

从活动管理器缓冲区日志捕获计时器值

以下代码将通过活动或窗口管理器缓冲区筛选出应用的计时器值。

Java
public int get_displayed_timer(File adb_log_file, String appPackage) {
        BufferedReader br = null;
        int timer = 0;
        String displayedMarker = null;
        
        try {
            br = new BufferedReader(new FileReader(adb_log_file));

            while ((displayedMarker = br.readLine()) != null) {
                if ((displayedMarker.contains(AM_ACTIVITY_LAUNCH_TIME) || 
                    displayedMarker.contains(WM_ACTIVITY_LAUNCH_TIME) ||
                    displayedMarker.contains(WARM_ACTIVITY_LAUNCH_TIME)) && 
                    displayedMarker.contains(appPackage))
                        break;
            }

            if (displayedMarker != null) {
                displayedMarker = displayedMarker.split("]")[0].split("\\[")[1];
                ffValue = Integer.parseInt(displayedMarker);
            } 
        } catch (Exception e) {
            System.out.println(e);
        } finally {
            br.close();
        }
        return timer;
    }
Kotlin
fun getDisplayedTimer(adbLogFile: File, appPackage: String): Int {
    var br: BufferedReader? = null
    var timer: Int = 0
    var displayedMarker: String? = null

    try {
        br = BufferedReader(FileReader(adbLogFile))

        while (displayedMarker != null) {
            if (displayedMarker.contains(AM_ACTIVITY_LAUNCH_TIME) ||
                    displayedMarker.contains(WM_ACTIVITY_LAUNCH_TIME) ||
                    displayedMarker.contains(WARM_ACTIVITY_LAUNCH_TIME)) &&
                    displayedMarker.contains(appPackage)) {
                break
            } else {
                displayedMarker = br.readLine()
            }
        }

        if (displayedMarker != null) {
            displayedMarker = displayedMarker.split("]")[0].split("\\[")[1]
            timer = Integer.parseInt(displayedMarker)
        }
    } catch (e: Exception) {
        println(e)
    } finally {
        br?.close()
    }

    return timer
}

显示第一帧之前的冷启动

显示第一帧之前的冷启动延迟是指从主屏幕启动应用,或者在强制停止后启动应用,然后测量绘制应用的第一帧所花费的时间。该指标可以衡量应用在此类启动中的性能,因为在强制停止后启动应用通常会花费更多时间来加载服务并将其保留在缓存中。

要测量显示第一帧之前的冷启动延迟,请执行以下操作:

  1. 运行logcat清除命令:adb shell logcat -v threadtime -b all -c
  2. 启动应用:adb shell am start <app_pkg>/<app_main_activity>
  3. 运行logcat命令:adb shell logcat -v threadtime -b all -d并捕获cool_app_launch_time计时器值。
  4. 完全启动应用后,强制停止应用:adb shell am force-stop <app_pkg>
  5. 重复这些步骤,达到所需的迭代次数。

冷启动迭代

使用以下代码示例执行延迟冷启动测试并打印所请求迭代的延迟值。

Java
for (int i = 0; i < iterations; i++) {
   if (!launchAppUsingMonkey(DSN, appPackage)) 
       launchAppUsingIntent(DSN, appIntent);
   Thread.sleep(10);
                
   BufferedReader read = new BufferedReader
       (new InputStreamReader(Runtime.getRuntime()
        .exec("adb -s "+ DSN +" shell logcat -v threadtime -b all -d")
        .getInputStream()));
                
   String line_CoolApp;
   String line_CoolActivity;

    log_file_writer(read);
   File adb_log_file = new File( kpi_log_file_path + "/KPI_Log.txt");
   
   if (deviceType == "Tablet") {
       timer = get_vitals_timer(adb_log_file, appPackage, COOL_APP); 
       
   } else if (deviceType == "FTV") {
      timer = get_displayed_timer(adb_log_file, appPackage);
      
      if (timer == 0) {
        timer = get_vitals_timer(adb_log_file, appPackage, COOL_APP);
      }
   }
   
   if (timer == 0) {
      timer = get_vitals_timer(adb_log_file, appPackage, COOL_ACTIVITY); 
   }

   forceStopApp(DSN, appPackage);
   Thread.sleep(10);
   Runtime.getRuntime().exec("adb -s "+ DSN +" shell logcat -b all -c");
}
Kotlin
for (int i = 0; i < iterations; i++) {
    if (!launchAppUsingMonkey(DSN, appPackage)) {
        launchAppUsingIntent(DSN, appIntent)
    }
    Thread.sleep(10)

    val read = BufferedReader(InputStreamReader(Runtime.getRuntime().exec("adb -s ${DSN} shell logcat -v threadtime -b all -d").getInputStream()))

    val line_CoolApp = read.readLine()
    val line_CoolActivity = read.readLine()

    log_file_writer(read)
    val adb_log_file = File(kpi_log_file_path + "/KPI_Log.txt")

    when (deviceType) {
        "Tablet" -> timer = get_vitals_timer(adb_log_file, appPackage, COOL_APP)
        "FTV" -> timer = get_displayed_timer(adb_log_file, appPackage)
                .takeIf { it != 0 }
                ?: get_vitals_timer(adb_log_file, appPackage, COOL_APP)
    }

    if (timer == 0) {
        timer = get_vitals_timer(adb_log_file, appPackage, COOL_ACTIVITY)
    }

    forceStopApp(DSN, appPackage)
    Thread.sleep(10)
    Runtime.getRuntime().exec("adb -s ${DSN} shell logcat -b all -c")
}

设备冷启动Android Vitals日志

以下显示了设备冷启动Android Vitals日志输出实例:

03-03 12:42:32.589   892   992 I Vlog    : PhoneWindowManager:ScreenTime:fgtracking=false;DV;1,Timer=1.0;TI;1,unit=count;DV;1,metadata=!{"d"#{"groupId"#"<APP_PACKAGE_NAME>"$"schemaId"#"123"$"startTimeMs"#"1.677827544773E12"$"packageName"#"<APP_PACKAGE_NAME>"$"endTimeMs"#"1.677827552587E12"$"durationMs"#"7813.0"}};DV;1:HI
03-03 12:42:33.657   892  1092 I Vlog    : performance:cool_app_launch_time:fgtracking=false;DV;1,key=<APP_PACKAGE_NAME>;DV;1,**Timer****=****1333.0**;TI;1,unit=ms;DV;1,metadata=App_Metadata!{"d"#{"groupId"#"abc"$"schemaId"#"abc"$"app_version"#"123"$"isChild"#"false"}$"m"#{"prev"#"<APP_PACKAGE_NAME>"$"context"#"abc"}};DV;1:HI
03-03 12:42:33.661   892  1092 I Vlog    : performance:user_app_launch_cool:fgtracking=false;DV;1,key=<APP_PACKAGE_NAME>;DV;1,Counter=1;CT;1,unit=count;DV;1,metadata=App_Metadata!{"d"#{"groupId"#"abc"$"schemaId"#"abc"$"isChild"#"false"}};DV;1:HI
03-03 12:49:20.880   892  1092 I Vlog    : performance:cool_app_launch_time:fgtracking=false;DV;1,key=<APP_PACKAGE_NAME>;DV;1,**Timer****=****1225.0**;TI;1,unit=ms;DV;1,metadata=App_Metadata!{"d"#{"groupId"#"abc"$"schemaId"#"abc"$"app_version"#"123"$"isChild"#"false"}$"m"#{"prev"#"<APP_PACKAGE_NAME>"$"context"#"abc"}};DV;1:HI
03-03 12:49:20.918   892  1092 I Vlog    : performance:user_app_launch_cool:fgtracking=false;DV;1,key=<APP_PACKAGE_NAME>;DV;1,Counter=1;CT;1,unit=count;DV;1,metadata=App_Metadata!{"d"#{"groupId"#"abc"$"schemaId"#"abc"$"isChild"#"false"}};DV;1:HI

显示第一帧之前的热启动

第一帧之前的热启动延迟包括从后台启动应用或从最近使用的应用中启动,以及测量绘制第一帧所花费的时间。该指标用于衡量应用从后台启动时的性能。由于缓存中已经提供了所需的服务,因此从后台启动应用时通常花费时间较短。

要测量显示第一帧之前的热启动延迟,请执行以下操作:

  1. 请确保应用在后台运行。
  2. 运行logcat清除命令:adb shell logcat -v threadtime -b all -c
  3. 启动应用:adb shell am start <app_pkg>/<app_main_activity>
  4. 运行logcat命令:adb shell logcat -v threadtime -b all -d并捕获warm_app_warm_transition_launch_time计时器值
  5. 完全启动应用后,运行:adb shell input keyevent KEYCODE_HOME
  6. 重复这些步骤,达到所需的迭代次数。

热启动迭代

使用以下代码示例运行延迟热启动测试并打印所请求迭代的延迟值。

Java
for (int i = 0; i < iterations; i++) {
   if (!launchAppUsingMonkey(DSN, appPackage)) 
       launchAppUsingIntent(DSN, appIntent);
   Thread.sleep(10);
                
   BufferedReader read = new BufferedReader
       (new InputStreamReader(Runtime.getRuntime()
        .exec("adb -s "+ DSN +" shell logcat -v threadtime -b all -d")
        .getInputStream()));
                
   String line_CoolApp;
   String line_CoolActivity;

   log_file_writer(read);
   String adb_log_file = kpi_log_file_path + "/KPI_Log.txt";
   
   if (deviceType == "Tablet") {
       timer = get_vitals_timer(adb_log_file, appPackage, WARM_APP_WARM); 
       
   } else if (deviceType == "FTV") {
      timer = get_displayed_timer(adb_log_file, appPackage);
      
      if (timer == 0) {
        timer = get_vitals_timer(adb_log_file, appPackage, WARM_APP_WARM);
      }
   }
   
   if (timer == 0) {
      timer = get_vitals_timer(adb_log_file, appPackage, WARM_APP_COOL); 
   }

   Runtime.getRuntime().exec("adb -s "+ DSN +" shell input keyevent KEYCODE_HOME");
   Thread.sleep(10);
   Runtime.getRuntime().exec("adb -s "+ DSN +" shell logcat -b all -c");
}
Kotlin
for (int i = 0; i < iterations; i++) {
    if (!launchAppUsingMonkey(DSN, appPackage)) 
        launchAppUsingIntent(DSN, appIntent)
    Thread.sleep(10)

    val read = BufferedReader(InputStreamReader(Runtime.getRuntime().exec("adb -s ${DSN} shell logcat -v threadtime -b all -d").getInputStream()))

    val line_CoolApp = read.readLine()
    val line_CoolActivity = read.readLine()

    log_file_writer(read)
    val adb_log_file = kpi_log_file_path + "/KPI_Log.txt"

    when (deviceType) {
        "Tablet" -> timer = get_vitals_timer(adb_log_file, appPackage, WARM_APP_WARM)
        "FTV" -> timer = get_displayed_timer(adb_log_file, appPackage)
            .takeIf { it != 0 } ?: get_vitals_timer(adb_log_file, appPackage, WARM_APP_WARM)
    }

    if (timer == 0) {
        timer = get_vitals_timer(adb_log_file, appPackage, WARM_APP_COOL)
    }

    Runtime.getRuntime().exec("adb -s ${DSN} shell input keyevent KEYCODE_HOME")
    Thread.sleep(10)
    Runtime.getRuntime().exec("adb -s ${DSN} shell logcat -b all -c")
}

设备热启动Android Vitals日志

以下显示了设备热启动Android Vitals日志输出实例:

03-03 12:51:16.367   892  1066 I Vlog    : Thermal:ScreenOn_SensorThrottling_P2P_Off:fgtracking=false;DV;1,key=0;DV;1,Timer=8.072222222222222E-4;TI;1,unit=hours;DV;1,metadata=<APP_PACKAGE_NAME>!{"d"#{"groupId"#"123"$"schemaId"#"123"$"zone"#"soc"}};DV;1:HI
03-03 12:51:16.367   892  1066 I Vlog    : Thermal:ScreenOn_SensorThrottling_P2P_Off:fgtracking=false;DV;1,key=0;DV;1,Timer=8.072222222222222E-4;TI;1,unit=hours;DV;1,metadata=<APP_PACKAGE_NAME>!{"d"#{"groupId"#"123"$"schemaId"#"123"$"zone"#"bottom"}};DV;1:HI
03-03 12:51:16.367   892  1066 I Vlog    : Thermal:ScreenOn_SensorThrottling_P2P_Off:fgtracking=false;DV;1,key=0;DV;1,Timer=8.072222222222222E-4;TI;1,unit=hours;DV;1,metadata=<APP_PACKAGE_NAME>!{"d"#{"groupId"#"123"$"schemaId"#"123"$"zone"#"side"}};DV;1:HI
03-03 12:51:16.368   892  1066 I Vlog    : Thermal:Screen_On_Thermal_Throttling_P2P_Off:fgtracking=false;DV;1,key=0;DV;1,Timer=8.075E-4;TI;1,unit=hours;DV;1,metadata=<APP_PACKAGE_NAME>!{"d"#{"groupId"#"123"$"schemaId"#"abc"}};DV;1:HI
03-03 12:51:16.384   892  1092 I Vlog    : performance:warm_app_warm_transition_launch_time:fgtracking=false;DV;1,key=<APP_PACKAGE_NAME>;DV;1,**Timer****=****191.0**;TI;1,unit=ms;DV;1,metadata=<APP_PACKAGE_NAME>!{"d"#{"groupId"#"123"$"schemaId"#"abc"$"app_version"#"123"$"isChild"#"false"}$"m"#{"prev"#"<APP_PACKAGE_NAME>"$"context"#"1234"}};DV;1:HI
03-03 12:51:16.395   892  1092 I Vlog    : performance:user_app_launch_warm:fgtracking=false;DV;1,key=<APP_PACKAGE_NAME>;DV;1,Counter=1;CT;1,unit=count;DV;1,metadata=<APP_PACKAGE_NAME>!{"d"#{"groupId"#"123"$"schemaId"#"abc"$"isChild"#"false"}};DV;1:HI

准备就绪时间

准备就绪时间 (RTU) KPI是按应用从启动到进入准备好可供使用的状态(例如显示应用的登录页面或主页)所花费的时间来衡量的。RTU用于衡量应用在启动时的性能,并且有助于找出应用存在的问题。此KPI可以再现用户用例,并为最终用户提供最佳体验。

  • 登录前RTU是指在登录前测量RTU屏幕。执行登录前冷启动或热启动时,请确保未登录应用。
  • 登录后RTU是指在登录后测量RTU屏幕。执行登录后冷启动或热启动时,请确保使用测试用凭证登录应用。

测量登录前冷启动RTU的步骤

登录前冷启动RTU是从主屏幕启动应用或在强制停止后启动应用,然后测量绘制应用的RTU状态或绘制应用登录页面所花费的时间。

  1. 运行logcat清除命令:adb shell logcat -v threadtime -b all -c
  2. 启动应用:adb shell am start <app_pkg>/<app_main_activity>
  3. 运行logcat命令:adb shell logcat -v threadtime -b all -d并捕获fully_drawn计时器值
  4. 完全启动应用并捕获计时器值后,使用以下命令来强制停止应用:adb shell am force-stop <app_pkg>
  5. 重复这些步骤,达到所需的迭代次数。

测量登录前热启动RTU的步骤

登录前热启动RTU是从后台启动应用或从最近使用的应用中启动,然后测量绘制应用的RTU状态或绘制应用登录页面所花费的时间。

  1. 确保应用程序在后台运行。
  2. 运行logcat清除命令:adb shell logcat -v threadtime -b all -c
  3. 启动应用:adb shell am start <app_pkg>/<app_main_activity>
  4. 运行logcat命令:adb shell logcat -v threadtime -b all -d并捕获fully_drawn计时器值
  5. 完全启动应用后,使用以下命令将应用移到后台:adb shell input keyevent KEYCODE_HOME
  6. 重复这些步骤,达到所需的迭代次数。

测量登录后冷启动RTU的步骤

登录后冷启动RTU是从主页启动应用或在强制停止后启动应用,然后测量在登录后绘制应用的RTU状态或绘制应用主页所花费的时间。

  1. 确保使用测试用凭证登录应用。
  2. 运行logcat清除命令:adb shell logcat -v threadtime -b all -c
  3. 启动应用:adb shell am start <app_pkg>/<app_main_activity>
  4. 运行logcat命令并捕获完全绘制的计时器值:adb shell logcat -v threadtime -b all -d
  5. 完全启动应用并捕获计时器值后,运行以下命令来强制停止应用:adb shell am force-stop <app_pkg>
  6. 重复这些步骤,达到所需的迭代次数。

测量登录后热启动RTU的步骤

登录后热启动RTU是从后台启动应用或从最近使用的应用中启动,然后测量在登录后绘制应用的RTU状态或绘制应用主页所花费的时间。

  1. 确保应用程序在后台运行,并且已使用测试用凭证登录应用。
  2. 运行logcat清除命令:adb shell logcat -v threadtime -b all -c
  3. 启动应用:adb shell am start <app_pkg>/<app_main_activity>
  4. 运行logcat命令并捕获完全绘制的计时器值:adb shell logcat -v threadtime -b all -d
  5. 完全启动应用后,运行以下命令将应用移到后台:adb shell input keyevent KEYCODE_HOME
  6. 重复这些步骤,达到所需的迭代次数。

RTU ADB日志

亚马逊Fire平板电脑设备上Monster Strike应用的fully_drawn活动日志行:

**`10`****`-`****`06`****` `****`10`****`:`****`28`****`:`****`03.932`****` `****`678`****` `****`703`****` I `****`ActivityTaskManager`****`:`****` `****`Fully`****` drawn `****`<APP_PACKAGE_NAME`****`>`****`:`****` `****`+`****`5s36ms`**

亚马逊Fire TV设备上Peacock TV应用的fully_drawn活动日志行:

03-27 13:19:26.362   527   537 I am_activity_fully_drawn_time: [0,180804427,<APP_MAIN_ACTIVITY>,7949,7859]
**03****-****27** **** **13****:****19****:****26.362** **** **527** **** **537** **I** **ActivityManager****:** **** **Fully** **drawn** **<****APP_MAIN_ACTIVITY****>****:** **** **+****7s949ms** **** **(****total** **+****7s859ms****)**
03-27 13:19:26.362   527   537 I sysui_multi_action: [324,0,757,1090,758,12,806,<APP_PACKAGE_NAME>,871,<APP_MAIN_ACTIVITY>,1091,7998]

亚马逊Fire TV设备上Max应用的fully_drawn活动日志行:

03-27 14:26:57.063   527  1134 I am_activity_fully_drawn_time: [0,170114187,<APP_PACKAGE_NAME>,3588,3462]
**03****-****27** **** **14****:****26****:****57.063** **** **527** **** **1134** **I** **ActivityManager****:** **** **Fully** **drawn <APP_MAIN_ACTIVITY>****:** **** **+****3s588ms** **** **(****total** **+****3s462ms****)**

内存KPI

内存KPI提供了详细的内存消耗情况概览,表示应用的前台活动以及后台活动的内存消耗或是内存消耗连同其他内存值。除了内存值之外,此KPI还可以衡量前台或后台CPU使用情况、RAM使用情况、RAM空闲情况和其他详情。

前台内存

前台内存KPI可以捕获应用在前台消耗的内存,为此需要使用应用在前台播放视频或玩游戏15分钟,然后提取和计算应用的内存消耗。

计算前台内存消耗:

  1. 运行logcat清除命令:adb shell logcat -v threadtime -b all -c
  2. 启动应用:adb shell am start <app_pkg>/<app_main_activity>
  3. 登录应用并使用应用的核心内容(游戏或视频)。
  4. 运行dumpsys命令并捕获total_pss内存值:adb shell dumpsys meminfo -a <app_pkg>
  5. 捕获内存值后,运行以下命令来强制停止应用:adb shell am force-stop <app_pkg>
  6. 重复这些步骤,达到所需的迭代次数。

后台内存

后台内存KPI可以捕获应用在后台消耗的内存,为此需要使用应用在前台播放视频或玩游戏15分钟,再将应用移到后台,然后提取和计算应用的内存消耗。

计算后台内存消耗:

  1. 运行logcat清除命令:adb shell logcat -v threadtime -b all -c
  2. 启动应用:adb shell am start <app_pkg>/<app_main_activity>
  3. 登录应用并使用应用的核心内容(游戏或视频)。
  4. 完成应用导航后,运行以下命令将应用移到后台:adb shell input keyevent KEYCODE_HOME
  5. 等待10到15秒钟,让应用在后台稳定运行。
  6. 运行dumpsys命令并捕获total_pss内存值:adb shell dumpsys meminfo -a <app_pkg>
  7. 重复这些步骤,达到所需的迭代次数。

内存ADB转储日志

总计比例集大小 (PSS) 是指应用在设备上消耗的内存量。总计PSS用于计算应用位于前台或后台时的内存消耗。

                 Pss      Pss   Shared  Private   Shared  Private  SwapPss     Heap     Heap     Heap
                Total    Clean    Dirty    Dirty    Clean    Clean    Dirty     Size    Alloc     Free
                                   
 Native Heap   115268        0      384   115020      100      208       22   151552   119143    32408
 Dalvik Heap    15846        0      264    15124      140      676       11    21026    14882     6144
Dalvik Other     8864        0       40     8864        0        0        0                           
       Stack      136        0        4      136        0        0        0                           
      Ashmem      132        0      264        0       12        0        0                           
   Other dev       48        0      156        0        0       48        0                           
    .so mmap    15819     9796      656      596    26112     9796       20                           
   .apk mmap     2103      432        0        0    26868      432        0                           
   .dex mmap    39396    37468        0        4    17052    37468        0                           
   .oat mmap     1592      452        0        0    13724      452        0                           
   .art mmap     2699      304      808     1956    12044      304        0                           
  Other mmap      274        0       12        4      636      244        0                           
   GL mtrack    42152        0        0    42152        0        0        0                           
     Unknown     2695        0       92     2684       60        0        0                           
       TOTAL   **247077**    48452     2680   186540    96748    49628       53   172578   134025    38552

如需了解更多实用ADB命令,请参阅ADB命令列表。有关更多信息,请参阅测试标准组2: Fire TV设备上的应用行为

写入KPI日志文件

使用以下代码示例写入一次迭代的KPI日志文件。

Java
public void log_file_writer(BufferedReader bf_read) {
 File adb_log_file = new File(kpi_log_file_path + "/KPI_Log.txt");
 FileWriter fileWriter = new FileWriter(adb_log_file);
 try {
    String reader = null;
     while ((reader = bf_read.readLine()) != null) {
            fileWriter.write(reader.trim() + "\n");
     }
  }
  catch (Exception e) {
     System.out.println(e);
  } 
  finally {
     fileWriter.flush();
     fileWriter.close();
     bf_read.close();
  }   
}
Kotlin
import java.io.File
import java.io.FileWriter
import java.io.BufferedReader


fun logFileWriter(bfRead: BufferedReader) {
    val adbLogFile = File("$kpi_log_file_path/KPI_Log.txt")
    val fileWriter = FileWriter(adbLogFile)
    try {
        var reader: String?
        while (bfRead.readLine().also { reader = it } != null) {
            fileWriter.write(reader?.trim() + "\n")
        }
    } catch (e: Exception) {
        println(e)
    } finally {
        fileWriter.flush()
        fileWriter.close()
        bfRead.close()
    }
}

Last updated: 2023年12月11日