xref: /aosp_15_r20/tools/aadevtools/validation/README.md (revision b32fbb6340ee6fe4a25d7b39d84085c084465677)
1*b32fbb63SXin Li# Validation Tools
2*b32fbb63SXin LiThis is a collection of validation tools for better development & integration
3*b32fbb63SXin Liproductivity for AAOS devices.
4*b32fbb63SXin Li
5*b32fbb63SXin Li## Validating new app releases
6*b32fbb63SXin LiIncoming quality control is an important practice to prevent new technical debts
7*b32fbb63SXin Liadded to risk the device development. These scripts illustrate a basic check for
8*b32fbb63SXin Lia new app bundle release against a known good virtual or physical device build.
9*b32fbb63SXin LiSo that, you know what changed better & if they break any basic use cases.
10*b32fbb63SXin Li
11*b32fbb63SXin Li1. Prepare a new app release in a directory, a device under test reachable
12*b32fbb63SXin Livia adb & aapt is available in the shell environment.
13*b32fbb63SXin Li```
14*b32fbb63SXin LiappDir="/path/to/appDir"
15*b32fbb63SXin LirenameCsv="/path/to/renameCsvFile"
16*b32fbb63SXin Li```
17*b32fbb63SXin Li
18*b32fbb63SXin Li- As sometime mk file change the file name when copying XML files to the device at the build time, you can supply a CSV file to guide the script. The format is as:
19*b32fbb63SXin Li```
20*b32fbb63SXin Liname,newName
21*b32fbb63SXin Liprivapp-permissions-in-app-release.xml,privapp-permissions-on-device.xml
22*b32fbb63SXin Li```
23*b32fbb63SXin Li
24*b32fbb63SXin Li2. batch_install_app.sh: find & install all APKs in a given directory to
25*b32fbb63SXin Lia device via adb. Launch their launchable activities if any & capture
26*b32fbb63SXin Liscreenshots. To use:
27*b32fbb63SXin Li
28*b32fbb63SXin Li```
29*b32fbb63SXin Li./batch_install_app.sh ${appDir}
30*b32fbb63SXin Li```
31*b32fbb63SXin Li
32*b32fbb63SXin Li3. batch_check_permission.sh: find & diff permissions XML files in a given
33*b32fbb63SXin Lidirectory against those on a device via adb. To use:
34*b32fbb63SXin Li
35*b32fbb63SXin Li```
36*b32fbb63SXin Li./batch_check_permission.sh ${appDir} ${renameCsv}
37*b32fbb63SXin Li```
38*b32fbb63SXin Li
39*b32fbb63SXin Li4. test.sh has all the commands above to make is easier to use.
40