1 page.title=Integrating with Android CTS 2 @jd:body 3 4 <!-- 5 Copyright 2015 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 20 <div id="qv-wrapper"> 21 <div id="qv"> 22 <h2>In this document</h2> 23 <ol id="auto-toc"> 24 </ol> 25 </div> 26 </div> 27 28 <h2 id=deqp_tests_in_android_cts>Deqp tests in Android CTS</h2> 29 30 <p>Deqp tests have been part of Android CTS since the Android 5.0 release.</p> 31 32 <p>Android CTS requires a certain subset of tests, called the <code>mustpass</code> list, to pass. The <code>mustpass</code> list includes OpenGL ES 3.0, OpenGL ES 3.1, and the Android Extension Pack tests. If a device doesn't support a target API or extension, tests are skipped and reported as passing. 33 The <code>mustpass</code> files can be found under the <code>android/cts</code> directory in the deqp source tree.</p> 34 35 <p>Deqp tests are included in the Android CTS release packages, available on the <a href="{@docRoot}compatibility/downloads.html">Android Compatibility Downloads</a> page. </p> 36 37 <p>You can run deqp tests through the <code>cts-tradefed</code> utility with the following command:</p> 38 39 <pre> 40 cts-tradefed run cts --plan CTS-DEQP 41 </pre> 42 43 <h2 id=duplicating_runs_without_cts>Duplicating runs without CTS</h2> 44 45 <p>To replicate the CTS run, install the deqp APK of the CTS package and use the 46 following command:</p> 47 48 <pre> 49 adb -d shell am start -n com.drawelements.deqp/android.app.NativeActivity -e 50 cmdLine "deqp --deqp-case=dEQP-GLES3.some_group.* 51 --deqp-gl-config-name=rgba8888d24s8 --deqp-log-filename=/sdcard/dEQP-Log.qpa 52 </pre> 53 54 <p>The important part of that command is the following:</p> 55 <pre> 56 --deqp-gl-config-name=rgba8888d24s8 57 </pre> 58 59 <p>This argument requests the tests be run on an RGBA 8888 on-screen surface 60 with a 24-bit depth buffer and an 8-bit stencil buffer. Also remember to set 61 the desired tests, e.g. using the <code>--deqp-case</code> argument.</p> 62 63 <h2 id=mapping_of_the_cts_results>Mapping of the CTS results</h2> 64 65 <p>In the Android CTS, a test case can end up in three states: passed, failed, or 66 not executed.</p> 67 68 <p>The deqp has more result codes available. A mapping is automatically performed 69 by the CTS. The following deqp result codes are mapped to a CTS pass: <code>Pass</code>, <code>NotSupported</code>, <code>QualityWarning</code>, and <code>CompatibilityWarning</code> </p> 70 71 <p>The following results are interpreted as a CTS failure: 72 <code>Fail</code>, <code>ResourceError</code>, <code>Crash</code>, <code>Timeout</code>, and <code>InternalError</code></p> 73