| // Copyright 2019 The Bazel Authors. All rights reserved. | |
| // | |
| // 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 com.google.devtools.build.android; | |
| import static com.google.common.base.Verify.verify; | |
| import com.android.resources.ResourceType; | |
| import com.google.auto.value.AutoValue; | |
| import com.google.common.base.Strings; | |
| import java.util.regex.Matcher; | |
| /** | |
| * Represents an Android resource for the purposes of declarations/linkage. Resource definitions use | |
| * a ResourceName with a set of qualifiers; this is currently modeled using {@FullyQualifiedName}. | |
| */ | |
| @AutoValue | |
| abstract class ResourceName { | |
| /** Package name; this is usually left empty to denote the default/current package. */ | |
| abstract String pkg(); | |
| /** | |
| * Type of resource, e.g. string, drawable, et cetera. For example, {@code @string/foo} references | |
| * a resource of type {@code string}. | |
| */ | |
| abstract ResourceType type(); | |
| /** Entry name of a resource. For example, {@code @string/foo} references entry {@code foo}. */ | |
| abstract String entry(); | |
| static ResourceName create(String pkg, ResourceType type, String entry) { | |
| return new AutoValue_ResourceName(pkg, type, entry); | |
| } | |
| /** | |
| * Constructs a ResourceName from the canonical form used throughout Android ({@code | |
| * [<pkg>:]<type>/<entry>}). | |
| */ | |
| // While we use aapt2 to convert XML data to protobuf, we still need to do some parsing: | |
| // | |
| // https://android.googlesource.com/platform/frameworks/base.git/+/refs/tags/platform-tools-29.0.2/tools/aapt2/Resources.proto#232 | |
| static ResourceName parse(String name) { | |
| Matcher matcher = FullyQualifiedName.QUALIFIED_REFERENCE.matcher(name); | |
| verify( | |
| matcher.matches(), | |
| "%s is not a valid resource name. Expected %s", | |
| name, | |
| FullyQualifiedName.QUALIFIED_REFERENCE); | |
| return create( | |
| Strings.nullToEmpty(matcher.group("package")), | |
| ResourceType.getEnum(matcher.group("type")), | |
| matcher.group("name")); | |
| } | |
| } |