Home | History | Annotate | Download | only in fundamentals 
      1 page.title=Systems Testing With VTS
      2 @jd:body
      3 
      4 <!--
      5     Copyright 2017 The Android Open Source Project
      6 
      7     Licensed under the Apache License, Version 2.0 (the "License");
      8     you may not use this file except in compliance with the License.
      9     You may obtain a copy of the License at
     10 
     11         http://www.apache.org/licenses/LICENSE-2.0
     12 
     13     Unless required by applicable law or agreed to in writing, software
     14     distributed under the License is distributed on an "AS IS" BASIS,
     15     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     16     See the License for the specific language governing permissions and
     17     limitations under the License.
     18 -->
     19 <div id="qv-wrapper">
     20   <div id="qv">
     21     <h2>In this document</h2>
     22     <ol id="auto-toc">
     23     </ol>
     24   </div>
     25 </div>
     26 
     27 <p>The Vendor Test Suite (VTS) automates HAL and OS kernel testing. To use VTS
     28 to test an Android native system implementation, set up a testing environment
     29 then test a patch using a VTS plan.</p>
     30 
     31 <h2 id="establish">Establishing a test environment</h2>
     32 <p>To set up a testing environment:</p>
     33 <ol>
     34 <li>Install Python development kit:
     35 <pre><code>$ sudo apt-get install python-dev</code></pre></li>
     36 <li>Install Protocol Buffer tools (for Python):
     37 <pre><code>$ sudo apt-get install python-protobuf<br>
     38 $ sudo apt-get install protobuf-compiler
     39 </code></pre></li>
     40 <li>Install Python virtual environment-related tools:
     41 <pre><code>$ sudo apt-get install python-virtualenv<br>
     42 $ sudo apt-get install python-pip
     43 </code></pre></li></ol>
     44 
     45 <h2 id="test">Testing a patch</h2>
     46 <p>To test a patch:</p>
     47 <ol>
     48 <li>Build a VTS host-side package:
     49 <pre><code>$ . build/envsetup.sh
     50 $ lunch aosp_arm64-userdebug
     51 $ make vts -j</code></pre></li>
     52 <li>Run the default VTS tests:
     53 <pre><code>$ vts-tradefed<br>
     54 &gt; run vts     // where vts is the test plan name
     55 </pre></code></li></ol>
     56 
     57 <h2 id="plans">VTS plans</h2>
     58 <p>Available VTS test plans include:</p>
     59 
     60 <table>
     61 <thead>
     62 <tr>
     63 <th>Command</th>
     64 <th>Description</th>
     65 </tr>
     66 </thead>
     67 <tbody>
     68 <tr>
     69 <td>&gt; run vts</td>
     70 <td>For default VTS tests</td>
     71 </tr>
     72 <tr>
     73 <td>&gt; run vts-hal</td>
     74 <td>For default VTS HAL (hardware abstraction layer) tests</td>
     75 </tr>
     76 <tr>
     77 <td>&gt; run vts-kernel</td>
     78 <td>For default VTS kernel tests</td>
     79 </tr>
     80 </tbody>
     81 </table>
     82 
     83 <p>To view a list of all plans, refer to
     84 <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>
     85 
     86 <h2 id="support">Support</h2>
     87 <p>You can view a user manual at
     88 <code><a href=" https://android.googlesource.com/platform/test/vts/+/master/README.md">/test/vts/doc</a></code>.
     89 For questions on VTS, please join
     90 <a href="https://groups.google.com/forum/#!forum/android-vts">android-vts (a] googlegroups.com</a>.</p>
     91