1 /* 2 * Copyright (C) 2016 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 #ifndef AAPT_FORMAT_PROTO_PROTOSERIALIZE_H 18 #define AAPT_FORMAT_PROTO_PROTOSERIALIZE_H 19 20 #include "android-base/macros.h" 21 #include "androidfw/ConfigDescription.h" 22 23 #include "Configuration.pb.h" 24 #include "ResourceTable.h" 25 #include "ResourceValues.h" 26 #include "Resources.pb.h" 27 #include "ResourcesInternal.pb.h" 28 #include "StringPool.h" 29 #include "xml/XmlDom.h" 30 31 namespace aapt { 32 33 struct SerializeXmlOptions { 34 /** Remove text nodes that only contain whitespace. */ 35 bool remove_empty_text_nodes = false; 36 }; 37 38 struct SerializeTableOptions { 39 /** Prevent serializing the source pool and source protos. */ 40 bool exclude_sources = false; 41 }; 42 43 // Serializes a Value to its protobuf representation. An optional StringPool will hold the 44 // source path string. 45 void SerializeValueToPb(const Value& value, pb::Value* out_value, StringPool* src_pool = nullptr); 46 47 // Serialize an Item into its protobuf representation. pb::Item does not store the source path nor 48 // comments of an Item. 49 void SerializeItemToPb(const Item& item, pb::Item* out_item); 50 51 // Serializes an XML element into its protobuf representation. 52 void SerializeXmlToPb(const xml::Element& el, pb::XmlNode* out_node, 53 const SerializeXmlOptions options = {}); 54 55 // Serializes an XmlResource into its protobuf representation. The ResourceFile is NOT serialized. 56 void SerializeXmlResourceToPb(const xml::XmlResource& resource, pb::XmlNode* out_node, 57 const SerializeXmlOptions options = {}); 58 59 // Serializes a StringPool into its protobuf representation, which is really just the binary 60 // ResStringPool representation stuffed into a bytes field. 61 void SerializeStringPoolToPb(const StringPool& pool, pb::StringPool* out_pb_pool, IDiagnostics* diag); 62 63 // Serializes a ConfigDescription into its protobuf representation. 64 void SerializeConfig(const android::ConfigDescription& config, pb::Configuration* out_pb_config); 65 66 // Serializes a ResourceTable into its protobuf representation. 67 void SerializeTableToPb(const ResourceTable& table, pb::ResourceTable* out_table, 68 IDiagnostics* diag, SerializeTableOptions options = {}); 69 70 // Serializes a ResourceFile into its protobuf representation. 71 void SerializeCompiledFileToPb(const ResourceFile& file, pb::internal::CompiledFile* out_file); 72 73 } // namespace aapt 74 75 #endif /* AAPT_FORMAT_PROTO_PROTOSERIALIZE_H */ 76