com.google.devtools.build.lib.rules.objc.J2ObjcLibrary.java Source code

Java tutorial

Introduction

Here is the source code for com.google.devtools.build.lib.rules.objc.J2ObjcLibrary.java

Source

// 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.objc;

import static com.google.devtools.build.lib.collect.nestedset.Order.STABLE_ORDER;
import static com.google.devtools.build.lib.rules.objc.ObjcProvider.JRE_LIBRARY;
import static com.google.devtools.build.lib.rules.objc.ObjcProvider.LIBRARY;
import static com.google.devtools.build.lib.rules.objc.XcodeProductType.LIBRARY_STATIC;

import com.google.common.collect.ImmutableList;
import com.google.devtools.build.lib.actions.Artifact;
import com.google.devtools.build.lib.analysis.ConfiguredTarget;
import com.google.devtools.build.lib.analysis.RuleConfiguredTarget.Mode;
import com.google.devtools.build.lib.analysis.RuleConfiguredTargetBuilder;
import com.google.devtools.build.lib.analysis.RuleContext;
import com.google.devtools.build.lib.analysis.RunfilesProvider;
import com.google.devtools.build.lib.collect.nestedset.NestedSetBuilder;
import com.google.devtools.build.lib.packages.BuildType;
import com.google.devtools.build.lib.packages.RuleClass.ConfiguredTargetFactory.RuleErrorException;
import com.google.devtools.build.lib.rules.RuleConfiguredTargetFactory;
import com.google.devtools.build.lib.syntax.Type;
import com.google.devtools.build.lib.vfs.PathFragment;

import java.util.List;

/**
 * Implementation for the "j2objc_library" rule, which exports ObjC source files translated from
 * Java source files in java_library rules to dependent objc_binary rules for compilation and
 * linking into the final application bundle. See {@link J2ObjcLibraryBaseRule} for details.
 */
public class J2ObjcLibrary implements RuleConfiguredTargetFactory {

    public static final String NO_ENTRY_CLASS_ERROR_MSG = "Entry classes must be specified when flag --compilationMode=opt is on in order to"
            + " perform J2ObjC dead code stripping.";

    public static final List<String> J2OBJC_SUPPORTED_RULES = ImmutableList.of("java_import", "java_library",
            "proto_library");

    @Override
    public ConfiguredTarget create(RuleContext ruleContext) throws InterruptedException, RuleErrorException {
        checkAttributes(ruleContext);

        if (ruleContext.hasErrors()) {
            return null;
        }

        J2ObjcEntryClassProvider j2ObjcEntryClassProvider = new J2ObjcEntryClassProvider.Builder()
                .addTransitive(ruleContext)
                .addEntryClasses(ruleContext.attributes().get("entry_classes", Type.STRING_LIST)).build();

        Iterable<ObjcProvider> jreDeps = ruleContext.getPrerequisites("jre_deps", Mode.TARGET, ObjcProvider.class);
        ObjcProvider.Builder objcProviderBuilder = new ObjcProvider.Builder().addTransitiveAndPropagate(jreDeps)
                .addTransitiveAndPropagate(ruleContext.getPrerequisites("deps", Mode.TARGET, ObjcProvider.class));
        for (ObjcProvider prereq : jreDeps) {
            objcProviderBuilder.addTransitiveAndPropagate(JRE_LIBRARY, prereq.get(LIBRARY));
        }

        XcodeProvider.Builder xcodeProviderBuilder = new XcodeProvider.Builder();
        XcodeSupport xcodeSupport = new XcodeSupport(ruleContext).addJreDependencies(xcodeProviderBuilder)
                .addDependencies(xcodeProviderBuilder, new Attribute("deps", Mode.TARGET));

        ObjcProvider objcProvider = objcProviderBuilder.build();
        xcodeSupport.addXcodeSettings(xcodeProviderBuilder, objcProvider, LIBRARY_STATIC);

        J2ObjcMappingFileProvider j2ObjcMappingFileProvider = J2ObjcMappingFileProvider
                .union(ruleContext.getPrerequisites("deps", Mode.TARGET, J2ObjcMappingFileProvider.class));

        return new RuleConfiguredTargetBuilder(ruleContext)
                .setFilesToBuild(NestedSetBuilder.<Artifact>emptySet(STABLE_ORDER))
                .add(RunfilesProvider.class, RunfilesProvider.EMPTY)
                .addProvider(J2ObjcEntryClassProvider.class, j2ObjcEntryClassProvider)
                .addProvider(J2ObjcMappingFileProvider.class, j2ObjcMappingFileProvider)
                .addProvider(ObjcProvider.class, objcProvider)
                .addProvider(XcodeProvider.class, xcodeProviderBuilder.build()).build();
    }

    /**
     * Returns header search paths necessary to compile the J2ObjC-generated code from a single
     * target.
     *
     * @param ruleContext the rule context
     * @param objcFileRootExecPath the exec path under which all J2ObjC-generated file resides
     * @param sourcesToTranslate the source files to be translated by J2ObjC in a single target
     */
    public static Iterable<PathFragment> j2objcSourceHeaderSearchPaths(RuleContext ruleContext,
            PathFragment objcFileRootExecPath, Iterable<Artifact> sourcesToTranslate) {
        PathFragment genRoot = ruleContext.getConfiguration().getGenfilesFragment();
        ImmutableList.Builder<PathFragment> headerSearchPaths = ImmutableList.builder();
        headerSearchPaths.add(objcFileRootExecPath);
        // We add another header search path with gen root if we have generated sources to translate.
        for (Artifact sourceToTranslate : sourcesToTranslate) {
            if (!sourceToTranslate.isSourceArtifact()) {
                headerSearchPaths.add(new PathFragment(objcFileRootExecPath, genRoot));
                return headerSearchPaths.build();
            }
        }

        return headerSearchPaths.build();
    }

    private static void checkAttributes(RuleContext ruleContext) {
        checkAttributes(ruleContext, "deps");
        checkAttributes(ruleContext, "exports");
    }

    private static void checkAttributes(RuleContext ruleContext, String attributeName) {
        if (!ruleContext.attributes().has(attributeName, BuildType.LABEL_LIST)) {
            return;
        }

        List<String> entryClasses = ruleContext.attributes().get("entry_classes", Type.STRING_LIST);
        J2ObjcConfiguration j2objcConfiguration = ruleContext.getFragment(J2ObjcConfiguration.class);
        if (j2objcConfiguration.removeDeadCode() && (entryClasses == null || entryClasses.isEmpty())) {
            ruleContext.attributeError("entry_classes", NO_ENTRY_CLASS_ERROR_MSG);
        }
    }
}