1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
/*
* Copyright (C) 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.
*/
package android.os;
import android.annotation.NonNull;
import android.annotation.TestApi;
import android.util.Slog;
import java.util.Map;
/**
* Java API for libvintf.
*
* @hide
*/
@TestApi
public class VintfObject {
private static final String LOG_TAG = "VintfObject";
/**
* Slurps all device information (both manifests and both matrices)
* and report them.
* If any error in getting one of the manifests, it is not included in
* the list.
*
* @hide
*/
@TestApi
public static native String[] report();
/**
* Verify that the given metadata for an OTA package is compatible with
* this device.
*
* @param packageInfo a list of serialized form of HalManifest's /
* CompatibilityMatri'ces (XML).
* @return = 0 if success (compatible)
* > 0 if incompatible
* < 0 if any error (mount partition fails, illformed XML, etc.)
*
* @deprecated Checking compatibility against an OTA package is no longer
* supported because the format of VINTF metadata in the OTA package may not
* be recognized by the current system.
*
* <p>
* <ul>
* <li>This function always returns 0 for non-empty {@code packageInfo}.
* </li>
* <li>This function returns the result of {@link #verifyWithoutAvb} for
* null or empty {@code packageInfo}.</li>
* </ul>
*
* @hide
*/
@Deprecated
public static int verify(String[] packageInfo) {
if (packageInfo != null && packageInfo.length > 0) {
Slog.w(LOG_TAG, "VintfObject.verify() with non-empty packageInfo is deprecated. "
+ "Skipping compatibility checks for update package.");
return 0;
}
Slog.w(LOG_TAG, "VintfObject.verify() is deprecated. Call verifyWithoutAvb() instead.");
return verifyWithoutAvb();
}
/**
* Verify Vintf compatibility on the device without checking AVB
* (Android Verified Boot). It is useful to verify a running system
* image where AVB check is irrelevant.
*
* @return = 0 if success (compatible)
* > 0 if incompatible
* < 0 if any error (mount partition fails, illformed XML, etc.)
*
* @hide
*/
public static native int verifyWithoutAvb();
/**
* @return a list of HAL names and versions that is supported by this
* device as stated in device and framework manifests. For example,
* ["android.hidl.manager@1.0", "android.hardware.camera.device@1.0",
* "android.hardware.camera.device@3.2"]. There are no duplicates.
*
* For AIDL HALs, the version is a single number
* (e.g. "android.hardware.light@1"). Historically, this API strips the
* version number for AIDL HALs (e.g. "android.hardware.light"). Users
* of this API must be able to handle both for backwards compatibility.
*
* @hide
*/
@TestApi
public static native String[] getHalNamesAndVersions();
/**
* @return the BOARD_SEPOLICY_VERS build flag available in device manifest.
*
* @hide
*/
@TestApi
public static native String getSepolicyVersion();
/**
* @return the PLATFORM_SEPOLICY_VERSION build flag available in framework
* compatibility matrix.
*
* @hide
*/
@TestApi
public static native @NonNull String getPlatformSepolicyVersion();
/**
* @return a list of VNDK snapshots supported by the framework, as
* specified in framework manifest. For example,
* [("27", ["libjpeg.so", "libbase.so"]),
* ("28", ["libjpeg.so", "libbase.so"])]
*
* @hide
*/
@TestApi
public static native Map<String, String[]> getVndkSnapshots();
/**
* @return Target Framework Compatibility Matrix (FCM) version, a number
* specified in the device manifest indicating the FCM version that the
* device manifest implements. Null if device manifest doesn't specify this
* number (for legacy devices).
*
* @hide
*/
@TestApi
public static native Long getTargetFrameworkCompatibilityMatrixVersion();
private VintfObject() {}
}
|
