1* Copyright (C) 2016 The Android Open Source Project
2*
3* Licensed under the Apache License, Version 2.0 (the "License");
4* you may not use this file except in compliance with the License.
5* You may obtain a copy of the License at
6*
7*      http://www.apache.org/licenses/LICENSE-2.0
8*
9* Unless required by applicable law or agreed to in writing, software
10* distributed under the License is distributed on an "AS IS" BASIS,
11* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12* See the License for the specific language governing permissions and
13* limitations under the License.
14
15
16INTRODUCTION
17
18The Android platform core tests (APCT) consist of unit tests for core platform
19functionality. These differ from CTS in that they are not necessarily testing
20public APIs and are not guaranteed to work outside of AOSP builds.
21
22
23INSTRUCTIONS
24
25To run a test or set of tests, first build the FrameworksCoreTests package:
26
27  make FrameworksCoreTests
28
29Next, install the resulting APK and run tests as you would normal JUnit tests:
30
31  adb install -r ${ANDROID_PRODUCT_OUT}/data/app/FrameworksCoreTests/FrameworksCoreTests.apk
32  adb shell am instrument -w \
33    com.android.frameworks.coretests/android.support.test.runner.AndroidJUnitRunner
34
35To run a tests within a specific package, add the following argument AFTER -w:
36
37    -e package android.content.pm
38
39To run a specific test or method within a test:
40
41    -e class android.content.pm.PackageParserTest
42    -e class android.content.pm.PackageParserTest#testComputeMinSdkVersion
43
44To run tests in debug mode:
45
46    -e debug true
47
48To uninstall the package:
49
50  adb shell pm uninstall -k com.android.frameworks.coretests
51
52For more arguments, see the guide to command=line testing:
53
54  https://developer.android.com/studio/test/command-line.html
55