xref: /aosp_15_r20/frameworks/base/tools/aapt2/link/XmlReferenceLinker.cpp (revision d57664e9bc4670b3ecf6748a746a57c557b6bc9e)
1*d57664e9SAndroid Build Coastguard Worker /*
2*d57664e9SAndroid Build Coastguard Worker  * Copyright (C) 2015 The Android Open Source Project
3*d57664e9SAndroid Build Coastguard Worker  *
4*d57664e9SAndroid Build Coastguard Worker  * Licensed under the Apache License, Version 2.0 (the "License");
5*d57664e9SAndroid Build Coastguard Worker  * you may not use this file except in compliance with the License.
6*d57664e9SAndroid Build Coastguard Worker  * You may obtain a copy of the License at
7*d57664e9SAndroid Build Coastguard Worker  *
8*d57664e9SAndroid Build Coastguard Worker  *      http://www.apache.org/licenses/LICENSE-2.0
9*d57664e9SAndroid Build Coastguard Worker  *
10*d57664e9SAndroid Build Coastguard Worker  * Unless required by applicable law or agreed to in writing, software
11*d57664e9SAndroid Build Coastguard Worker  * distributed under the License is distributed on an "AS IS" BASIS,
12*d57664e9SAndroid Build Coastguard Worker  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13*d57664e9SAndroid Build Coastguard Worker  * See the License for the specific language governing permissions and
14*d57664e9SAndroid Build Coastguard Worker  * limitations under the License.
15*d57664e9SAndroid Build Coastguard Worker  */
16*d57664e9SAndroid Build Coastguard Worker 
17*d57664e9SAndroid Build Coastguard Worker #include "ResourceUtils.h"
18*d57664e9SAndroid Build Coastguard Worker #include "SdkConstants.h"
19*d57664e9SAndroid Build Coastguard Worker #include "ValueVisitor.h"
20*d57664e9SAndroid Build Coastguard Worker #include "androidfw/IDiagnostics.h"
21*d57664e9SAndroid Build Coastguard Worker #include "androidfw/ResourceTypes.h"
22*d57664e9SAndroid Build Coastguard Worker #include "link/Linkers.h"
23*d57664e9SAndroid Build Coastguard Worker #include "link/ReferenceLinker.h"
24*d57664e9SAndroid Build Coastguard Worker #include "process/IResourceTableConsumer.h"
25*d57664e9SAndroid Build Coastguard Worker #include "process/SymbolTable.h"
26*d57664e9SAndroid Build Coastguard Worker #include "trace/TraceBuffer.h"
27*d57664e9SAndroid Build Coastguard Worker #include "util/Util.h"
28*d57664e9SAndroid Build Coastguard Worker #include "xml/XmlDom.h"
29*d57664e9SAndroid Build Coastguard Worker 
30*d57664e9SAndroid Build Coastguard Worker namespace aapt {
31*d57664e9SAndroid Build Coastguard Worker 
32*d57664e9SAndroid Build Coastguard Worker namespace {
33*d57664e9SAndroid Build Coastguard Worker 
34*d57664e9SAndroid Build Coastguard Worker // Visits each xml Element and compiles the attributes within.
35*d57664e9SAndroid Build Coastguard Worker class XmlVisitor : public xml::PackageAwareVisitor {
36*d57664e9SAndroid Build Coastguard Worker  public:
37*d57664e9SAndroid Build Coastguard Worker   using xml::PackageAwareVisitor::Visit;
38*d57664e9SAndroid Build Coastguard Worker 
XmlVisitor(const android::Source & source,android::StringPool * pool,const CallSite & callsite,IAaptContext * context,ResourceTable * table,SymbolTable * symbols)39*d57664e9SAndroid Build Coastguard Worker   XmlVisitor(const android::Source& source, android::StringPool* pool, const CallSite& callsite,
40*d57664e9SAndroid Build Coastguard Worker              IAaptContext* context, ResourceTable* table, SymbolTable* symbols)
41*d57664e9SAndroid Build Coastguard Worker       : source_(source),
42*d57664e9SAndroid Build Coastguard Worker         callsite_(callsite),
43*d57664e9SAndroid Build Coastguard Worker         context_(context),
44*d57664e9SAndroid Build Coastguard Worker         symbols_(symbols),
45*d57664e9SAndroid Build Coastguard Worker         reference_transformer_(callsite, context, symbols, pool, table, this) {
46*d57664e9SAndroid Build Coastguard Worker   }
47*d57664e9SAndroid Build Coastguard Worker 
Visit(xml::Element * el)48*d57664e9SAndroid Build Coastguard Worker   void Visit(xml::Element* el) override {
49*d57664e9SAndroid Build Coastguard Worker     // The default Attribute allows everything except enums or flags.
50*d57664e9SAndroid Build Coastguard Worker     Attribute default_attribute(android::ResTable_map::TYPE_ANY);
51*d57664e9SAndroid Build Coastguard Worker     default_attribute.SetWeak(true);
52*d57664e9SAndroid Build Coastguard Worker 
53*d57664e9SAndroid Build Coastguard Worker     // The default orientation of gradients in android Q is different than previous android
54*d57664e9SAndroid Build Coastguard Worker     // versions. Set the android:angle attribute to "0" to ensure that the default gradient
55*d57664e9SAndroid Build Coastguard Worker     // orientation will remain left-to-right in android Q.
56*d57664e9SAndroid Build Coastguard Worker     if (el->name == "gradient" && context_->GetMinSdkVersion() <= SDK_Q) {
57*d57664e9SAndroid Build Coastguard Worker       if (!el->FindAttribute(xml::kSchemaAndroid, "angle")) {
58*d57664e9SAndroid Build Coastguard Worker         el->attributes.push_back(xml::Attribute{xml::kSchemaAndroid, "angle", "0"});
59*d57664e9SAndroid Build Coastguard Worker       }
60*d57664e9SAndroid Build Coastguard Worker     }
61*d57664e9SAndroid Build Coastguard Worker 
62*d57664e9SAndroid Build Coastguard Worker     const android::Source source = source_.WithLine(el->line_number);
63*d57664e9SAndroid Build Coastguard Worker     for (xml::Attribute& attr : el->attributes) {
64*d57664e9SAndroid Build Coastguard Worker       // If the attribute has no namespace, interpret values as if
65*d57664e9SAndroid Build Coastguard Worker       // they were assigned to the default Attribute.
66*d57664e9SAndroid Build Coastguard Worker 
67*d57664e9SAndroid Build Coastguard Worker       const Attribute* attribute = &default_attribute;
68*d57664e9SAndroid Build Coastguard Worker 
69*d57664e9SAndroid Build Coastguard Worker       if (std::optional<xml::ExtractedPackage> maybe_package =
70*d57664e9SAndroid Build Coastguard Worker               xml::ExtractPackageFromNamespace(attr.namespace_uri)) {
71*d57664e9SAndroid Build Coastguard Worker         // There is a valid package name for this attribute. We will look this up.
72*d57664e9SAndroid Build Coastguard Worker         Reference attr_ref(
73*d57664e9SAndroid Build Coastguard Worker             ResourceNameRef(maybe_package.value().package, ResourceType::kAttr, attr.name));
74*d57664e9SAndroid Build Coastguard Worker         attr_ref.private_reference = maybe_package.value().private_namespace;
75*d57664e9SAndroid Build Coastguard Worker 
76*d57664e9SAndroid Build Coastguard Worker         std::string err_str;
77*d57664e9SAndroid Build Coastguard Worker         attr.compiled_attribute =
78*d57664e9SAndroid Build Coastguard Worker             ReferenceLinker::CompileXmlAttribute(attr_ref, callsite_, context_, symbols_, &err_str);
79*d57664e9SAndroid Build Coastguard Worker 
80*d57664e9SAndroid Build Coastguard Worker         if (!attr.compiled_attribute) {
81*d57664e9SAndroid Build Coastguard Worker           android::DiagMessage error_msg(source);
82*d57664e9SAndroid Build Coastguard Worker           error_msg << "attribute ";
83*d57664e9SAndroid Build Coastguard Worker           ReferenceLinker::WriteAttributeName(attr_ref, callsite_, this, &error_msg);
84*d57664e9SAndroid Build Coastguard Worker           error_msg << " " << err_str;
85*d57664e9SAndroid Build Coastguard Worker           context_->GetDiagnostics()->Error(error_msg);
86*d57664e9SAndroid Build Coastguard Worker           error_ = true;
87*d57664e9SAndroid Build Coastguard Worker           continue;
88*d57664e9SAndroid Build Coastguard Worker         }
89*d57664e9SAndroid Build Coastguard Worker 
90*d57664e9SAndroid Build Coastguard Worker         attribute = &attr.compiled_attribute.value().attribute;
91*d57664e9SAndroid Build Coastguard Worker       }
92*d57664e9SAndroid Build Coastguard Worker 
93*d57664e9SAndroid Build Coastguard Worker       attr.compiled_value = ResourceUtils::TryParseItemForAttribute(context_->GetDiagnostics(),
94*d57664e9SAndroid Build Coastguard Worker                                                                     attr.value, attribute);
95*d57664e9SAndroid Build Coastguard Worker       if (attr.compiled_value) {
96*d57664e9SAndroid Build Coastguard Worker         // With a compiledValue, we must resolve the reference and assign it an ID.
97*d57664e9SAndroid Build Coastguard Worker         attr.compiled_value->SetSource(source);
98*d57664e9SAndroid Build Coastguard Worker         attr.compiled_value = attr.compiled_value->Transform(reference_transformer_);
99*d57664e9SAndroid Build Coastguard Worker       } else if ((attribute->type_mask & android::ResTable_map::TYPE_STRING) == 0) {
100*d57664e9SAndroid Build Coastguard Worker         // We won't be able to encode this as a string.
101*d57664e9SAndroid Build Coastguard Worker         android::DiagMessage msg(source);
102*d57664e9SAndroid Build Coastguard Worker         msg << "'" << attr.value << "' is incompatible with attribute " << attr.name << " "
103*d57664e9SAndroid Build Coastguard Worker             << *attribute;
104*d57664e9SAndroid Build Coastguard Worker         context_->GetDiagnostics()->Error(msg);
105*d57664e9SAndroid Build Coastguard Worker         error_ = true;
106*d57664e9SAndroid Build Coastguard Worker       }
107*d57664e9SAndroid Build Coastguard Worker     }
108*d57664e9SAndroid Build Coastguard Worker 
109*d57664e9SAndroid Build Coastguard Worker     // Call the super implementation.
110*d57664e9SAndroid Build Coastguard Worker     xml::PackageAwareVisitor::Visit(el);
111*d57664e9SAndroid Build Coastguard Worker   }
112*d57664e9SAndroid Build Coastguard Worker 
HasError()113*d57664e9SAndroid Build Coastguard Worker   bool HasError() {
114*d57664e9SAndroid Build Coastguard Worker     return error_ || reference_transformer_.HasError();
115*d57664e9SAndroid Build Coastguard Worker   }
116*d57664e9SAndroid Build Coastguard Worker 
117*d57664e9SAndroid Build Coastguard Worker  private:
118*d57664e9SAndroid Build Coastguard Worker   DISALLOW_COPY_AND_ASSIGN(XmlVisitor);
119*d57664e9SAndroid Build Coastguard Worker 
120*d57664e9SAndroid Build Coastguard Worker   android::Source source_;
121*d57664e9SAndroid Build Coastguard Worker   const CallSite& callsite_;
122*d57664e9SAndroid Build Coastguard Worker   IAaptContext* context_;
123*d57664e9SAndroid Build Coastguard Worker   SymbolTable* symbols_;
124*d57664e9SAndroid Build Coastguard Worker 
125*d57664e9SAndroid Build Coastguard Worker   ReferenceLinkerTransformer reference_transformer_;
126*d57664e9SAndroid Build Coastguard Worker   bool error_ = false;
127*d57664e9SAndroid Build Coastguard Worker };
128*d57664e9SAndroid Build Coastguard Worker 
129*d57664e9SAndroid Build Coastguard Worker }  // namespace
130*d57664e9SAndroid Build Coastguard Worker 
Consume(IAaptContext * context,xml::XmlResource * resource)131*d57664e9SAndroid Build Coastguard Worker bool XmlReferenceLinker::Consume(IAaptContext* context, xml::XmlResource* resource) {
132*d57664e9SAndroid Build Coastguard Worker   TRACE_NAME("XmlReferenceLinker::Consume");
133*d57664e9SAndroid Build Coastguard Worker   CallSite callsite{resource->file.name.package};
134*d57664e9SAndroid Build Coastguard Worker 
135*d57664e9SAndroid Build Coastguard Worker   std::string out_name = resource->file.name.entry;
136*d57664e9SAndroid Build Coastguard Worker   NameMangler::Unmangle(&out_name, &callsite.package);
137*d57664e9SAndroid Build Coastguard Worker 
138*d57664e9SAndroid Build Coastguard Worker   if (callsite.package.empty()) {
139*d57664e9SAndroid Build Coastguard Worker     // Assume an empty package means that the XML file is local. This is true of AndroidManifest.xml
140*d57664e9SAndroid Build Coastguard Worker     // for example.
141*d57664e9SAndroid Build Coastguard Worker     callsite.package = context->GetCompilationPackage();
142*d57664e9SAndroid Build Coastguard Worker   }
143*d57664e9SAndroid Build Coastguard Worker 
144*d57664e9SAndroid Build Coastguard Worker   XmlVisitor visitor(resource->file.source, &resource->string_pool, callsite, context, table_,
145*d57664e9SAndroid Build Coastguard Worker                      context->GetExternalSymbols());
146*d57664e9SAndroid Build Coastguard Worker   if (resource->root) {
147*d57664e9SAndroid Build Coastguard Worker     resource->root->Accept(&visitor);
148*d57664e9SAndroid Build Coastguard Worker     return !visitor.HasError();
149*d57664e9SAndroid Build Coastguard Worker   }
150*d57664e9SAndroid Build Coastguard Worker   return false;
151*d57664e9SAndroid Build Coastguard Worker }
152*d57664e9SAndroid Build Coastguard Worker 
153*d57664e9SAndroid Build Coastguard Worker }  // namespace aapt
154