Merge "Docs: Adding VTS page and nav, feedback Test: make online-sac-docs - tested on staging instance 18 Bug: 35322572"

2 files changed, 91 insertions, 0 deletions

diff --git a/src/devices/devices_toc.cs b/src/devices/devices_toc.cs
index bc9320b4..3d5df3eb 100644
--- a/src/devices/devices_toc.cs
+++ b/src/devices/devices_toc.cs
@@ -462,6 +462,7 @@
           <li><a href="<?cs var:toroot ?>devices/tech/test_infra/tradefed/fundamentals/lifecycle.html">Test Lifecycle</a></li>
           <li><a href="<?cs var:toroot ?>devices/tech/test_infra/tradefed/fundamentals/options.html">Option Handling</a></li>
           <li><a href="<?cs var:toroot ?>devices/tech/test_infra/tradefed/full_example.html">An End-to-End Example</a></li>
+          <li><a href="<?cs var:toroot ?>devices/tech/test_infra/tradefed/vts.html">Systems Testing With VTS</a></li>
           <li id="tradefed-tree-list" class="nav-section">
             <div class="nav-section-header">
               <a href="<?cs var:toroot ?>reference/packages.html">
diff --git a/src/devices/tech/test_infra/tradefed/vts.jd b/src/devices/tech/test_infra/tradefed/vts.jd
new file mode 100644
index 00000000..76b0f1b2
--- /dev/null
+++ b/src/devices/tech/test_infra/tradefed/vts.jd
@@ -0,0 +1,90 @@
+page.title=Systems Testing With VTS
+@jd: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.
+-->
+<div id="qv-wrapper">
+  <div id="qv">
+    <h2>In this document</h2>
+    <ol id="auto-toc">
+    </ol>
+  </div>
+</div>
+
+<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><code>$ sudo apt-get install python-dev</code></pre></li>
+<li>Install Protocol Buffer tools (for Python):
+<pre><code>$ sudo apt-get install python-protobuf<br>
+$ sudo apt-get install protobuf-compiler
+</code></pre></li>
+<li>Install Python virtual environment-related tools:
+<pre><code>$ sudo apt-get install python-virtualenv<br>
+$ 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><code>$ . build/envsetup.sh
+$ lunch aosp_arm64-userdebug
+$ make vts -j</code></pre></li>
+<li>Run the default VTS tests:
+<pre><code>$ vts-tradefed<br>
+&gt; run vts     // where vts is the test plan name
+</pre></code></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, contact
+<a href="mailto:android-vts@google.com">android-vts@google.com</a>.</p>