1<!--
2  Copyright (C) 2021 The Android Open Source Project
3
4  Licensed under the Apache License, Version 2.0 (the "License");
5  you may not use this file except in compliance with the License.
6  You may obtain a copy of the License at
7
8       http://www.apache.org/licenses/LICENSE-2.0
9
10  Unless required by applicable law or agreed to in writing, software
11  distributed under the License is distributed on an "AS IS" BASIS,
12  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  See the License for the specific language governing permissions and
14  limitations under the License
15  -->
16
17# Car Services Tests and Test Apps
18
19This directory contains unit tests, instrumentation tests and sample apps.
20
21## Structure
22
23```
24android_car_api_test/        - Car API instrumentation tests, they use the real services
25CarSecurityPermissionTest/   - Car API permission tests
26carservice_test/             - Car API instrumentation tests, mocks VHAL
27carservice_unit_test/        - Car services instrumented unit tests
28common_utils/                - Shared utility library
29
30# The following test directories are located relative to $ANDROID_BUILD_TOP
31cts/hostsidetests/car/                      - Host-driven CTS tests
32cts/tests/tests/car/                        - CTS tests (prefer this over hostsidetests)
33frameworks/hardware/interfaces/automotive/  - Contains `vts/` folders for tests
34hardware/interfaces/automotive/             - Contains `vts/` folders for tests
35test/vts-testcase/hal/automotive/           - Host-side VTS tests
36```
37
38## Where to add tests
39
40Add necessary tests to all the test suits, and also don't forget to add ATS/CTS/VTS. See
41https://source.android.com/compatibility/tests to learn more about CTS/VTS.
42
43Try not to repeat the same test in multiple suits, as it creates unnecessary test maintenance.
44
45Add tests using these priorities:
46
471. CTS/VTS
482. `CarSecurityPermissionTest`
493. `android_car_api_test` - if CTS doesn't cover
504. `carservice_test` - if CTS doesn't cover
515. `carservice_unit_test`
52