2ed8bfa7fd
Fabricated Runtime Resource Overlays are overlays that are generated at runtime and are stored in the data/ partition. The system can fabricate RROs at runtime to dynamically theme the device. Idmaps can now be created from APK RROs and fabricated RROs. Rather than operating on ApkAssets, libidmap2 now operates on abstract resource "containers" that supply resource values. Target resource containers implement methods needed to query overlayable and target overlay information. Currently only APKs can be loaded as target resource containers. Overlay resource containers implement methods to supply the mapping of target resource to overlay value and other overlay information. The format of a fabricated RRO is as follows: 0x00 - 0x04 : fabricated overlay magic (always FRRO) 0x04 - 0x08 : file format version 0x08 - 0x0c : crc of version + proto data 0x0c - EOF : proto fabricated overlay data The magic is used to quickly detect if the file is a fabricated overlay. The version is incremented whenever backwards incompatible changes are made to the proto file format. Idmap must always be able to upgrade fabricated overlays from previous versions to new versions, so all previous versions must be checked into the tree. Bug: 172471315 Test: libidmap2_tests && libandroidfw_tests Change-Id: I4c9f29da278672e5695fb57d131a44c11a835180
56 lines
1.5 KiB
Protocol Buffer
56 lines
1.5 KiB
Protocol Buffer
/*
|
|
* Copyright (C) 2021 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.
|
|
*/
|
|
|
|
syntax = "proto3";
|
|
|
|
package android.idmap2.pb;
|
|
|
|
option optimize_for = LITE_RUNTIME;
|
|
|
|
// All changes to the proto messages in this file MUST be backwards compatible. Backwards
|
|
// incompatible changes will cause previously fabricated overlays to be considered corrupt by the
|
|
// new proto message specification.
|
|
message FabricatedOverlay {
|
|
repeated ResourcePackage packages = 1;
|
|
string name = 2;
|
|
string package_name = 3;
|
|
string target_package_name = 4;
|
|
string target_overlayable = 5;
|
|
}
|
|
|
|
message ResourcePackage {
|
|
string name = 1;
|
|
repeated ResourceType types = 2;
|
|
}
|
|
|
|
message ResourceType {
|
|
string name = 1;
|
|
repeated ResourceEntry entries = 2;
|
|
}
|
|
|
|
message ResourceEntry {
|
|
string name = 1;
|
|
oneof value {
|
|
ResourceValue res_value = 2;
|
|
}
|
|
}
|
|
|
|
message ResourceValue {
|
|
// Corresponds with android::Res_value::dataType
|
|
uint32 data_type = 1;
|
|
// Corresponds with android::Res_value::data
|
|
uint32 data_value = 2;
|
|
} |