blob: 8ba912d86f039c013cb98574e42b23429d8db2c7 [file] [log] [blame]
<html devsite>
<head>
<title>Systems Testing With VTS</title>
<meta name="project_path" value="/_project.yaml" />
<meta name="book_path" value="/_book.yaml" />
</head>
<body>
<!--
Copyright 2017 The Android Open Source Project
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<p>The Vendor Test Suite (VTS) automates HAL and OS kernel testing. To use VTS
to test an Android native system implementation, set up a testing environment
then test a patch using a VTS plan.</p>
<h2 id="establish">Establishing a test environment</h2>
<p>To set up a testing environment:</p>
<ol>
<li>Install Python development kit:
<pre class="devsite-terminal devsite-click-to-copy">
sudo apt-get install python-dev
</pre>
</li>
<li>Install Protocol Buffer tools (for Python):
<pre class="devsite-click-to-copy">
<code class="devsite-terminal">sudo apt-get install python-protobuf</code>
<code class="devsite-terminal">sudo apt-get install protobuf-compiler</code>
</pre>
</li>
<li>Install Python virtual environment-related tools:
<pre class="devsite-click-to-copy">
<code class="devsite-terminal">sudo apt-get install python-virtualenv</code>
<code class="devsite-terminal">sudo apt-get install python-pip</code>
</pre>
</li>
</ol>
<h2 id="test">Testing a patch</h2>
<p>To test a patch:</p>
<ol>
<li>Build a VTS host-side package:
<pre class="devsite-click-to-copy">
<code class="devsite-terminal">. build/envsetup.sh</code>
<code class="devsite-terminal">lunch aosp_arm64-userdebug</code>
<code class="devsite-terminal">make vts -j</code>
</pre>
</li>
<li>Run the default VTS tests:
<pre class="devsite-click-to-copy">
<code class="devsite-terminal">vts-tradefed</code>
tf&gt; run vts // where vts is the test plan name
</pre>
</li>
</ol>
<h2 id="plans">VTS plans</h2>
<p>Available VTS test plans include:</p>
<table>
<thead>
<tr>
<th>Command</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>&gt; run vts</td>
<td>For default VTS tests</td>
</tr>
<tr>
<td>&gt; run vts-hal</td>
<td>For default VTS HAL (hardware abstraction layer) tests</td>
</tr>
<tr>
<td>&gt; run vts-kernel</td>
<td>For default VTS kernel tests</td>
</tr>
</tbody>
</table>
<p>To view a list of all plans, refer to
<code><a href="https://android.googlesource.com/platform/test/vts/+/master/tools/vts-tradefed/res/config/plans.md">/test/vts/tools/vts-tradefed/res/config.md</a></code>.</p>
<h2 id="support">Support</h2>
<p>You can view a user manual at
<code><a href=" https://android.googlesource.com/platform/test/vts/+/master/README.md">/test/vts/doc</a></code>.
For questions on VTS, please join
<a href="https://groups.google.com/forum/#!forum/android-vts">android-vts@googlegroups.com</a>.</p>
</body>
</html>