xref: /aosp_15_r20/cts/tests/signature/api-check/system-api/DynamicConfig.xml (revision b7c941bb3fa97aba169d73cee0bed2de8ac964bf)
1*b7c941bbSAndroid Build Coastguard Worker<?xml version="1.0" encoding="utf-8"?>
2*b7c941bbSAndroid Build Coastguard Worker<!-- Copyright (C) 2021 Google Inc.
3*b7c941bbSAndroid Build Coastguard Worker
4*b7c941bbSAndroid Build Coastguard Worker     Licensed under the Apache License, Version 2.0 (the "License");
5*b7c941bbSAndroid Build Coastguard Worker     you may not use this file except in compliance with the License.
6*b7c941bbSAndroid Build Coastguard Worker     You may obtain a copy of the License at
7*b7c941bbSAndroid Build Coastguard Worker
8*b7c941bbSAndroid Build Coastguard Worker          http://www.apache.org/licenses/LICENSE-2.0
9*b7c941bbSAndroid Build Coastguard Worker
10*b7c941bbSAndroid Build Coastguard Worker     Unless required by applicable law or agreed to in writing, software
11*b7c941bbSAndroid Build Coastguard Worker     distributed under the License is distributed on an "AS IS" BASIS,
12*b7c941bbSAndroid Build Coastguard Worker     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13*b7c941bbSAndroid Build Coastguard Worker     See the License for the specific language governing permissions and
14*b7c941bbSAndroid Build Coastguard Worker     limitations under the License.
15*b7c941bbSAndroid Build Coastguard Worker-->
16*b7c941bbSAndroid Build Coastguard Worker<dynamicConfig>
17*b7c941bbSAndroid Build Coastguard Worker    <entry key ="expected_failures">
18*b7c941bbSAndroid Build Coastguard Worker        <!--
19*b7c941bbSAndroid Build Coastguard Worker         ! Each value in this section identifies an expected failure and is of the
20*b7c941bbSAndroid Build Coastguard Worker         ! form:
21*b7c941bbSAndroid Build Coastguard Worker         !    <failure-type>:<signature of class/member>
22*b7c941bbSAndroid Build Coastguard Worker         !
23*b7c941bbSAndroid Build Coastguard Worker         ! These entries are loaded by AnnotationTest which uses them to construct
24*b7c941bbSAndroid Build Coastguard Worker         ! an ExpectedFailuresFilter which discards them.
25*b7c941bbSAndroid Build Coastguard Worker         !
26*b7c941bbSAndroid Build Coastguard Worker         ! e.g. If the test fails with the following error message:
27*b7c941bbSAndroid Build Coastguard Worker         ! junit.framework.AssertionFailedError:
28*b7c941bbSAndroid Build Coastguard Worker         ! extra_class:	android.media.MediaParceledListSlice	Error: Class annotated with android.annotation.SystemApi does not exist in the documented API
29*b7c941bbSAndroid Build Coastguard Worker         ! extra_class:	android.media.MediaFrameworkInitializer	Error: Class annotated with android.annotation.SystemApi does not exist in the documented API
30*b7c941bbSAndroid Build Coastguard Worker         ! extra_interface:	android.media.MediaCommunicationManager$SessionCallback	Error: Class annotated with android.annotation.SystemApi does not exist in the documented API
31*b7c941bbSAndroid Build Coastguard Worker         ! extra_class:	android.media.MediaTranscodingManager	Error: Class annotated with android.annotation.SystemApi does not exist in the documented API
32*b7c941bbSAndroid Build Coastguard Worker         ! ClassLoader hierarchy
33*b7c941bbSAndroid Build Coastguard Worker         !
34*b7c941bbSAndroid Build Coastguard Worker         ! The first step is to check that the extra classes are expected (e.g.
35*b7c941bbSAndroid Build Coastguard Worker         ! because they have been annotated with the @SystemApi since this version
36*b7c941bbSAndroid Build Coastguard Worker         ! of the CTS tests were released and the tests are being run on an
37*b7c941bbSAndroid Build Coastguard Worker         ! Android system with a version of the mainline modules that includes
38*b7c941bbSAndroid Build Coastguard Worker         ! those changes.
39*b7c941bbSAndroid Build Coastguard Worker         !
40*b7c941bbSAndroid Build Coastguard Worker         ! If they are not expected then this must be caused by a partner
41*b7c941bbSAndroid Build Coastguard Worker         ! inadvertently adding something to the @SystemApi so the correct
42*b7c941bbSAndroid Build Coastguard Worker         ! response is for them to stop doing that.
43*b7c941bbSAndroid Build Coastguard Worker         !
44*b7c941bbSAndroid Build Coastguard Worker         ! If they are expected then additional entries should be added to this
45*b7c941bbSAndroid Build Coastguard Worker         ! section. That simply requires copying each error message into their own
46*b7c941bbSAndroid Build Coastguard Worker         ! <value></value> element and then removing the whitespace after the
47*b7c941bbSAndroid Build Coastguard Worker         ! first : and also removing the trailing " Error: ..." part (including
48*b7c941bbSAndroid Build Coastguard Worker         ! the leading white space).
49*b7c941bbSAndroid Build Coastguard Worker         !
50*b7c941bbSAndroid Build Coastguard Worker         ! See below for some examples.
51*b7c941bbSAndroid Build Coastguard Worker         !-->
52*b7c941bbSAndroid Build Coastguard Worker        <!-- Bug: 209335798 -->
53*b7c941bbSAndroid Build Coastguard Worker        <value>missing_method:android.bluetooth.BluetoothHeadset#setPriority(android.bluetooth.BluetoothDevice, int)</value>
54*b7c941bbSAndroid Build Coastguard Worker    </entry>
55*b7c941bbSAndroid Build Coastguard Worker</dynamicConfig>
56