xref: /aosp_15_r20/frameworks/native/include/android/obb.h (revision 38e8c45f13ce32b0dcecb25141ffecaf386fa17f)
1*38e8c45fSAndroid Build Coastguard Worker /*
2*38e8c45fSAndroid Build Coastguard Worker  * Copyright (C) 2010 The Android Open Source Project
3*38e8c45fSAndroid Build Coastguard Worker  *
4*38e8c45fSAndroid Build Coastguard Worker  * Licensed under the Apache License, Version 2.0 (the "License");
5*38e8c45fSAndroid Build Coastguard Worker  * you may not use this file except in compliance with the License.
6*38e8c45fSAndroid Build Coastguard Worker  * You may obtain a copy of the License at
7*38e8c45fSAndroid Build Coastguard Worker  *
8*38e8c45fSAndroid Build Coastguard Worker  *      http://www.apache.org/licenses/LICENSE-2.0
9*38e8c45fSAndroid Build Coastguard Worker  *
10*38e8c45fSAndroid Build Coastguard Worker  * Unless required by applicable law or agreed to in writing, software
11*38e8c45fSAndroid Build Coastguard Worker  * distributed under the License is distributed on an "AS IS" BASIS,
12*38e8c45fSAndroid Build Coastguard Worker  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13*38e8c45fSAndroid Build Coastguard Worker  * See the License for the specific language governing permissions and
14*38e8c45fSAndroid Build Coastguard Worker  * limitations under the License.
15*38e8c45fSAndroid Build Coastguard Worker  */
16*38e8c45fSAndroid Build Coastguard Worker 
17*38e8c45fSAndroid Build Coastguard Worker /**
18*38e8c45fSAndroid Build Coastguard Worker  * @addtogroup Storage
19*38e8c45fSAndroid Build Coastguard Worker  * @{
20*38e8c45fSAndroid Build Coastguard Worker  */
21*38e8c45fSAndroid Build Coastguard Worker 
22*38e8c45fSAndroid Build Coastguard Worker /**
23*38e8c45fSAndroid Build Coastguard Worker  * @file obb.h
24*38e8c45fSAndroid Build Coastguard Worker  */
25*38e8c45fSAndroid Build Coastguard Worker 
26*38e8c45fSAndroid Build Coastguard Worker #ifndef ANDROID_OBB_H
27*38e8c45fSAndroid Build Coastguard Worker #define ANDROID_OBB_H
28*38e8c45fSAndroid Build Coastguard Worker 
29*38e8c45fSAndroid Build Coastguard Worker #include <sys/types.h>
30*38e8c45fSAndroid Build Coastguard Worker 
31*38e8c45fSAndroid Build Coastguard Worker #ifdef __cplusplus
32*38e8c45fSAndroid Build Coastguard Worker extern "C" {
33*38e8c45fSAndroid Build Coastguard Worker #endif
34*38e8c45fSAndroid Build Coastguard Worker 
35*38e8c45fSAndroid Build Coastguard Worker struct AObbInfo;
36*38e8c45fSAndroid Build Coastguard Worker /** {@link AObbInfo} is an opaque type representing information for obb storage. */
37*38e8c45fSAndroid Build Coastguard Worker typedef struct AObbInfo AObbInfo;
38*38e8c45fSAndroid Build Coastguard Worker 
39*38e8c45fSAndroid Build Coastguard Worker /** Flag for an obb file, returned by AObbInfo_getFlags(). */
40*38e8c45fSAndroid Build Coastguard Worker enum {
41*38e8c45fSAndroid Build Coastguard Worker     /** overlay */
42*38e8c45fSAndroid Build Coastguard Worker     AOBBINFO_OVERLAY = 0x0001,
43*38e8c45fSAndroid Build Coastguard Worker };
44*38e8c45fSAndroid Build Coastguard Worker 
45*38e8c45fSAndroid Build Coastguard Worker /**
46*38e8c45fSAndroid Build Coastguard Worker  * Scan an OBB and get information about it.
47*38e8c45fSAndroid Build Coastguard Worker  */
48*38e8c45fSAndroid Build Coastguard Worker AObbInfo* AObbScanner_getObbInfo(const char* filename);
49*38e8c45fSAndroid Build Coastguard Worker 
50*38e8c45fSAndroid Build Coastguard Worker /**
51*38e8c45fSAndroid Build Coastguard Worker  * Destroy the AObbInfo object. You must call this when finished with the object.
52*38e8c45fSAndroid Build Coastguard Worker  */
53*38e8c45fSAndroid Build Coastguard Worker void AObbInfo_delete(AObbInfo* obbInfo);
54*38e8c45fSAndroid Build Coastguard Worker 
55*38e8c45fSAndroid Build Coastguard Worker /**
56*38e8c45fSAndroid Build Coastguard Worker  * Get the package name for the OBB.
57*38e8c45fSAndroid Build Coastguard Worker  */
58*38e8c45fSAndroid Build Coastguard Worker const char* AObbInfo_getPackageName(AObbInfo* obbInfo);
59*38e8c45fSAndroid Build Coastguard Worker 
60*38e8c45fSAndroid Build Coastguard Worker /**
61*38e8c45fSAndroid Build Coastguard Worker  * Get the version of an OBB file.
62*38e8c45fSAndroid Build Coastguard Worker  */
63*38e8c45fSAndroid Build Coastguard Worker int32_t AObbInfo_getVersion(AObbInfo* obbInfo);
64*38e8c45fSAndroid Build Coastguard Worker 
65*38e8c45fSAndroid Build Coastguard Worker /**
66*38e8c45fSAndroid Build Coastguard Worker  * Get the flags of an OBB file.
67*38e8c45fSAndroid Build Coastguard Worker  */
68*38e8c45fSAndroid Build Coastguard Worker int32_t AObbInfo_getFlags(AObbInfo* obbInfo);
69*38e8c45fSAndroid Build Coastguard Worker 
70*38e8c45fSAndroid Build Coastguard Worker #ifdef __cplusplus
71*38e8c45fSAndroid Build Coastguard Worker };
72*38e8c45fSAndroid Build Coastguard Worker #endif
73*38e8c45fSAndroid Build Coastguard Worker 
74*38e8c45fSAndroid Build Coastguard Worker #endif      // ANDROID_OBB_H
75*38e8c45fSAndroid Build Coastguard Worker 
76*38e8c45fSAndroid Build Coastguard Worker /** @} */
77