// Copyright 2017 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.lib.rules.android; import com.google.common.collect.Iterables; import com.google.devtools.build.lib.actions.Artifact; import com.google.devtools.build.lib.actions.ParamFileInfo; import com.google.devtools.build.lib.actions.ParameterFile.ParameterFileType; import com.google.devtools.build.lib.analysis.RuleContext; import com.google.devtools.build.lib.analysis.actions.CustomCommandLine; import com.google.devtools.build.lib.analysis.actions.CustomCommandLine.VectorArg; import com.google.devtools.build.lib.analysis.actions.SpawnAction; import com.google.devtools.build.lib.analysis.configuredtargets.RuleConfiguredTarget.Mode; import com.google.devtools.build.lib.collect.nestedset.NestedSet; import com.google.devtools.build.lib.collect.nestedset.NestedSetBuilder; import com.google.devtools.build.lib.rules.android.AndroidConfiguration.AndroidAaptVersion; import com.google.devtools.build.lib.rules.android.ResourceContainerConverter.ToArg; import com.google.devtools.build.lib.rules.android.ResourceContainerConverter.ToArg.Includes; import com.google.devtools.build.lib.util.OS; /** * Builder for generating R classes for robolectric action. * *

This builder will create an action that generates r classes with internally consistent * resource ids for the transitive closure of dependencies that provide resources. */ public class RobolectricResourceSymbolsActionBuilder { private static final ResourceContainerConverter.ToArg RESOURCE_CONTAINER_TO_ARG = ResourceContainerConverter.builder() .include(Includes.ResourceRoots) .include(Includes.Manifest) .include(Includes.RTxt) .include(Includes.SymbolsBin) .withSeparator(ToArg.SeparatorType.COLON_COMMA) .toArgConverter(); private static final ResourceContainerConverter.ToArg RESOURCE_CONTAINER_TO_AAPT2_ARG = ResourceContainerConverter.builder() .include(Includes.ResourceRoots) .include(Includes.Manifest) .include(Includes.Aapt2RTxt) .include(Includes.SymbolsBin) .withSeparator(ToArg.SeparatorType.COLON_COMMA) .toArgConverter(); private Artifact classJarOut; private final ResourceDependencies dependencies; private AndroidSdkProvider sdk; private AndroidAaptVersion androidAaptVersion; private RobolectricResourceSymbolsActionBuilder(ResourceDependencies dependencies) { this.dependencies = dependencies; } public static RobolectricResourceSymbolsActionBuilder create(ResourceDependencies dependencies) { return new RobolectricResourceSymbolsActionBuilder(dependencies); } public RobolectricResourceSymbolsActionBuilder setJarOut(Artifact classJar) { this.classJarOut = classJar; return this; } public RobolectricResourceSymbolsActionBuilder setSdk(AndroidSdkProvider sdk) { this.sdk = sdk; return this; } public RobolectricResourceSymbolsActionBuilder targetAaptVersion( AndroidAaptVersion androidAaptVersion) { this.androidAaptVersion = androidAaptVersion; return this; } public NestedSet buildAsClassPathEntry(RuleContext ruleContext) { CustomCommandLine.Builder builder = new CustomCommandLine.Builder(); // Set the busybox tool. builder.add("--tool").add("GENERATE_ROBOLECTRIC_R").add("--"); NestedSetBuilder inputs = NestedSetBuilder.stableOrder(); builder.addExecPath("--androidJar", sdk.getAndroidJar()); inputs.add(sdk.getAndroidJar()); ToArg resourceContainerToArg; if (androidAaptVersion == AndroidAaptVersion.AAPT2) { inputs.addTransitive(dependencies.getTransitiveAapt2RTxt()); resourceContainerToArg = RESOURCE_CONTAINER_TO_AAPT2_ARG; } else { inputs.addTransitive(dependencies.getTransitiveRTxt()); resourceContainerToArg = RESOURCE_CONTAINER_TO_ARG; } if (!Iterables.isEmpty(dependencies.getResourceContainers())) { builder.addAll( "--data", VectorArg.join(resourceContainerToArg.listSeparator()) .each(dependencies.getResourceContainers()) .mapped(resourceContainerToArg)); } inputs .addTransitive(dependencies.getTransitiveResources()) .addTransitive(dependencies.getTransitiveAssets()) .addTransitive(dependencies.getTransitiveManifests()) .addTransitive(dependencies.getTransitiveSymbolsBin()); builder.addExecPath("--classJarOutput", classJarOut); builder.addLabel("--targetLabel", ruleContext.getLabel()); SpawnAction.Builder spawnActionBuilder = new SpawnAction.Builder(); ParamFileInfo.Builder paramFile = ParamFileInfo.builder(ParameterFileType.SHELL_QUOTED); // Some flags (e.g. --mainData) may specify lists (or lists of lists) separated by special // characters (colon, semicolon, hashmark, ampersand) that don't work on Windows, and quoting // semantics are very complicated (more so than in Bash), so let's just always use a parameter // file. // TODO(laszlocsomor), TODO(corysmith): restructure the Android BusyBux's flags by deprecating // list-type and list-of-list-type flags that use such problematic separators in favor of // multi-value flags (to remove one level of listing) and by changing all list separators to a // platform-safe character (= comma). paramFile.setUseAlways(OS.getCurrent() == OS.WINDOWS); ruleContext.registerAction( spawnActionBuilder .useDefaultShellEnvironment() .addTransitiveInputs(inputs.build()) .addOutput(classJarOut) .addCommandLine(builder.build(), paramFile.build()) .setExecutable( ruleContext.getExecutablePrerequisite("$android_resources_busybox", Mode.HOST)) .setProgressMessage("Generating R classes for %s", ruleContext.getLabel()) .setMnemonic("GenerateRobolectricRClasses") .build(ruleContext)); return NestedSetBuilder.naiveLinkOrder().add(classJarOut).build(); } }