1 /*
2 * Copyright (C) 2020 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17 #include <libvts_vintf_test_common/common.h>
18
19 namespace android::vintf::testing {
20
21 // kApiLevel2FcmMap is associated with API level. There can be multiple
22 // Framework Compatibility Matrix Version (FCM Version) per API level, or
23 // multiple API levels per FCM version.
24 // kApiLevel2FcmMap is defined apart from android::vintf::Level. Level is an
25 // integer designed to be irrelevant with API level; the O / O_MR1 values are
26 // historic values for convenience, and should be removed (b/70628538). Hence
27 // these values are not used here.
28 // For example:
29 // ...
30 // // Assume devices launch with Android X must implement FCM version >= 9
31 // X = 9,
32 // // Assume devices launch with Android Y and Android Z must implement
33 // // FCM version >= 11
34 // Y = 11,
35 // Z = 11
36 static const std::map<uint64_t /* Shipping API Level */,
37 Level /* FCM Version */>
38 kApiLevel2FcmMap{{
39 // N. The test runs on devices that launch with N and
40 // become a Treble device when upgrading to O.
41 {25, Level::O},
42
43 {26, Level::O},
44 {27, Level::O_MR1},
45 {28, Level::P},
46 {29, Level::Q},
47 {30, Level::R},
48 {31, Level::S},
49 }};
50
TestTargetFcmVersion(Level shipping_fcm_version,uint64_t shipping_api_level)51 android::base::Result<void> TestTargetFcmVersion(Level shipping_fcm_version,
52 uint64_t shipping_api_level) {
53 if (shipping_api_level == 0u) {
54 return android::base::Error()
55 << "Device's shipping API level cannot be determined.";
56 }
57
58 if (shipping_fcm_version == Level::UNSPECIFIED) {
59 // O / O-MR1 vendor image doesn't have shipping FCM version declared and
60 // shipping FCM version is inferred from Shipping API level, hence it always
61 // meets the requirement.
62 return {};
63 }
64
65 if (shipping_api_level < kApiLevel2FcmMap.begin()->first /* 25 */) {
66 return android::base::Error() << "Pre-N devices should not run this test.";
67 }
68
69 auto it = kApiLevel2FcmMap.find(shipping_api_level);
70 if (it == kApiLevel2FcmMap.end()) {
71 return android::base::Error()
72 << "No launch requirement is set yet for Shipping API level "
73 << shipping_api_level << ". Please update the test.";
74 }
75
76 Level required_fcm_version = it->second;
77 if (shipping_fcm_version < required_fcm_version) {
78 return android::base::Error()
79 << "Shipping API level == " << shipping_api_level
80 << " requires Shipping FCM Version >= " << required_fcm_version
81 << " (but is " << shipping_fcm_version << ")";
82 }
83
84 return {};
85 }
86
87 } // namespace android::vintf::testing
88