// Copyright 2016 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.packages.ImplicitOutputsFunction.fromTemplates; import com.google.devtools.build.lib.analysis.BaseRuleClasses; import com.google.devtools.build.lib.analysis.RuleDefinition; import com.google.devtools.build.lib.analysis.RuleDefinitionEnvironment; import com.google.devtools.build.lib.packages.ImplicitOutputsFunction.SafeImplicitOutputsFunction; import com.google.devtools.build.lib.packages.RuleClass; import com.google.devtools.build.lib.packages.RuleClass.Builder; import com.google.devtools.build.lib.rules.apple.AppleConfiguration; /** * Rule definition for apple_dynamic_library. */ public class AppleDynamicLibraryRule implements RuleDefinition { /** * Template for the fat dynamic library output (using Apple's "lipo" tool to combine dynamic * libraries of multiple architectures). */ private static final SafeImplicitOutputsFunction LIPO_DYLIB = fromTemplates("%{name}_lipo.dylib"); @Override public RuleClass build(Builder builder, RuleDefinitionEnvironment env) { MultiArchSplitTransitionProvider splitTransitionProvider = new MultiArchSplitTransitionProvider(); return builder .requiresConfigurationFragments( ObjcConfiguration.class, J2ObjcConfiguration.class, AppleConfiguration.class) .override(builder.copy("deps").cfg(splitTransitionProvider)) .override(builder.copy("non_propagated_deps").cfg(splitTransitionProvider)) /*
name_lipo.dylib
: the 'lipo'ed potentially multi-architecture
dynamic library. All transitive dependencies and srcs
are linked.This rule produces single- or multi-architecture ("fat") Apple dynamic libraries, typically used in creating dynamic Apple Frameworks for distribution and re-use in multiple extensions or applications.
The lipo
tool is used to combine files of multiple architectures; a build flag
controls which architectures are targeted. The build flag examined depends on the
platform_type
attribute for this rule (and is described in its documentation).