// Copyright 2015 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.devtools.build.lib.actions.Artifact;
import com.google.devtools.build.lib.analysis.RuleContext;
import com.google.devtools.build.lib.rules.android.AndroidResourcesProvider.ResourceContainer;
import com.google.devtools.build.lib.rules.java.JavaUtil;
import com.google.devtools.build.lib.syntax.Type;
import com.google.devtools.build.lib.util.Preconditions;

import javax.annotation.Nullable;

/**
 * Encapsulates the process of building {@link ResourceContainer}.
 */
public final class AndroidResourceContainerBuilder {
  private LocalResourceContainer data;
  private Artifact manifest;
  private Artifact rOutput;
  private boolean inlineConstants = false;
  private Artifact symbolsFile;
  private boolean useJavaPackageFromManifest = false;

  /** Provides the resources and assets for the ResourceContainer. */
  public AndroidResourceContainerBuilder withData(LocalResourceContainer data) {
    this.data = data;
    return this;
  }

  public AndroidResourceContainerBuilder withManifest(Artifact manifest) {
    this.manifest = manifest;
    return this;
  }

  public AndroidResourceContainerBuilder withROutput(Artifact rOutput) {
    this.rOutput = rOutput;
    return this;
  }

  public AndroidResourceContainerBuilder withInlinedConstants(boolean inlineContants) {
    this.inlineConstants = inlineContants;
    return this;
  }

  public AndroidResourceContainerBuilder useJavaPackageFromManifest(
      boolean useJavaPackageFromManifest) {
    this.useJavaPackageFromManifest = useJavaPackageFromManifest;
    return this;
  }

  /** Creates a {@link ResourceContainer} from a {@link RuleContext}.
   * @throws InterruptedException */
  public ResourceContainer buildFromRule(RuleContext ruleContext, @Nullable Artifact apk)
      throws InterruptedException {
    return buildFromRule(ruleContext, apk, false);
  }

  /** Creates a {@link ResourceContainer} from a {@link RuleContext}.
   * @throws InterruptedException */
  public ResourceContainer buildFromRule(RuleContext ruleContext, @Nullable Artifact apk,
      boolean alwaysExportManifest)
      throws InterruptedException {
    Preconditions.checkNotNull(this.manifest);
    Preconditions.checkNotNull(this.data);
    Artifact rJavaSrcJar = ruleContext.getImplicitOutputArtifact(
        AndroidRuleClasses.ANDROID_JAVA_SOURCE_JAR);
    return AndroidResourcesProvider.ResourceContainer.create(
            ruleContext.getLabel(),
            getJavaPackage(ruleContext, rJavaSrcJar),
            getRenameManifestPackage(ruleContext),
            inlineConstants,
            apk,
            manifest,
            rJavaSrcJar,
            null, /* javaClassJar -- compile from source jar unless generated directly by a tool */
            data.getAssets(),
            data.getResources(),
            data.getAssetRoots(),
            data.getResourceRoots(),
            alwaysExportManifest || getExportsManifest(ruleContext),
            rOutput,
            symbolsFile);
  }

  private String getJavaPackage(RuleContext ruleContext, Artifact rJavaSrcJar) {
    if (useJavaPackageFromManifest) {
      return null;
    }
    if (hasCustomPackage(ruleContext)) {
      return ruleContext.attributes().get("custom_package", Type.STRING);
    }
    // TODO(bazel-team): JavaUtil.getJavaPackageName does not check to see if the path is valid.
    // So we need to check for the JavaRoot.
    if (JavaUtil.getJavaRoot(rJavaSrcJar.getExecPath()) == null) {
      ruleContext.ruleError("You must place your code under a directory named 'java' or "
          + "'javatests' for blaze to work. That directory (java,javatests) will be treated as "
          + "your java source root. Alternatively, you can set the 'custom_package' attribute.");
    }
    return JavaUtil.getJavaPackageName(rJavaSrcJar.getExecPath());
  }

  private boolean hasCustomPackage(RuleContext ruleContext) {
    return ruleContext.attributes().isAttributeValueExplicitlySpecified("custom_package");
  }

  private boolean getExportsManifest(RuleContext ruleContext) {
    // AndroidLibraryBaseRule has exports_manifest but AndroidBinaryBaseRule does not.
    // ResourceContainers are built for both, so we must check if exports_manifest is present.
    return ruleContext.attributes().has("exports_manifest", Type.BOOLEAN)
        && ruleContext.attributes().get("exports_manifest", Type.BOOLEAN);
  }

  @Nullable
  private String getRenameManifestPackage(RuleContext ruleContext) {
    return ruleContext.attributes().isAttributeValueExplicitlySpecified("rename_manifest_package")
        ? ruleContext.attributes().get("rename_manifest_package", Type.STRING)
        : null;
  }

  public AndroidResourceContainerBuilder withSymbolsFile(Artifact symbolsFile) {
    this.symbolsFile = symbolsFile;
    return this;
  }
}

@@ -4150,40 +4150,122 @@
 or(%22
-You must
+The location of your BUILD file determines the Java
  p
-l
 ac
-e your code under a
+kage used for %22%0A          + %22Android resource processing. A
  dir
@@ -4281,175 +4281,414 @@
 med 
-'
+%5C%22
 java
-'
+%5C%22
  or 
-%22%0A          + %22'javatests' for blaze to work. That directory (java,javatests) will be treated as %22%0A          + %22your java source root. Alternatively, you can
+%5C%22javatests%5C%22 will be used %22%0A          + %22as your Java source root and the path of your BUILD file relative to the Java source %22%0A          + %22root will be used as the package for Android resource processing. The Java source %22%0A          + %22root could not be determined for %5C%22%22 + ruleContext.getPackageDirectory() + %22%5C%22. %22%0A          + %22Move your BUILD file under a java or javatests directory, or
  set
@@ -4709,16 +4709,31 @@
 ackage' 
+%22%0A          + %22
 attribut

Improve the error message for when bazel can't determine the java package for android resource processing.