Add user-defined IPA post-processors.

RELNOTES[NEW]: iOS ipa_post_processor attribute allows for user-defined IPA edits.

--
MOS_MIGRATED_REVID=115338312

src/main/java/com/google/devtools/build/lib/bazel/rules/BazelRuleClassProvider.java

@@ -343,6 +343,7 @@ public static void setup(ConfiguredRuleClassProvider.Builder builder) {
     builder.addRuleDefinition(new ObjcRuleClasses.CompileDependencyRule());
     builder.addRuleDefinition(new ObjcRuleClasses.ResourceToolsRule());
     builder.addRuleDefinition(new ObjcRuleClasses.XcrunRule());
+    builder.addRuleDefinition(new ObjcRuleClasses.IpaRule());
     builder.addRuleDefinition(new AppleToolchain.RequiresXcodeConfigRule());
     builder.addRuleDefinition(new IosApplicationRule());
     builder.addRuleDefinition(new IosExtensionBinaryRule());

src/main/java/com/google/devtools/build/lib/rules/objc/IntermediateArtifacts.java

@@ -61,6 +61,13 @@ public Artifact appendExtensionForEntitlementArtifact(String extension) {
     return artifact;
   }
 
+  /**
+   * Returns the location of this target's generated entitlements file.
+   */
+  public Artifact entitlements() {
+    return appendExtensionForEntitlementArtifact(".entitlements");
+  }
+
   /**
    * Returns a derived artifact in the bin directory obtained by appending some extension to the end
    * of the given {@link PathFragment}.
@@ -362,4 +369,11 @@ public Artifact j2objcPrunedArchive(Artifact unprunedArchive) {
         prunedSourceArtifactPath,
         ruleContext.getBinOrGenfilesDirectory());
   }
+
+  /**
+   * Returns the location of this target's merged but not post-processed or signed IPA.
+   */
+  public Artifact unprocessedIpa() {
+    return appendExtension(".unprocessed.ipa");
+  }
 }

src/main/java/com/google/devtools/build/lib/rules/objc/IosApplicationRule.java

@@ -27,6 +27,7 @@
 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;
+import com.google.devtools.build.lib.rules.objc.ObjcRuleClasses.IpaRule;
 
 /**
  * Rule definition for ios_application.
@@ -75,8 +76,12 @@ public Metadata getMetadata() {
     return RuleDefinition.Metadata.builder()
         .name("ios_application")
         .factoryClass(IosApplication.class)
-        .ancestors(BaseRuleClasses.BaseRule.class, ObjcRuleClasses.ReleaseBundlingRule.class,
-            ObjcRuleClasses.XcodegenRule.class, ObjcRuleClasses.SimulatorRule.class)
+        .ancestors(
+            BaseRuleClasses.BaseRule.class,
+            ObjcRuleClasses.ReleaseBundlingRule.class,
+            ObjcRuleClasses.XcodegenRule.class,
+            ObjcRuleClasses.SimulatorRule.class,
+            IpaRule.class)
         .build();
   }
 }

src/main/java/com/google/devtools/build/lib/rules/objc/IosExtensionRule.java

@@ -24,6 +24,7 @@
 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;
+import com.google.devtools.build.lib.rules.objc.ObjcRuleClasses.IpaRule;
 
 /**
  * Rule definition for ios_extension.
@@ -60,8 +61,11 @@ public Metadata getMetadata() {
     return RuleDefinition.Metadata.builder()
         .name("ios_extension")
         .factoryClass(IosExtension.class)
-        .ancestors(BaseRuleClasses.BaseRule.class, ObjcRuleClasses.ReleaseBundlingRule.class,
-            ObjcRuleClasses.XcodegenRule.class)
+        .ancestors(
+            BaseRuleClasses.BaseRule.class,
+            ObjcRuleClasses.ReleaseBundlingRule.class,
+            ObjcRuleClasses.XcodegenRule.class,
+            IpaRule.class)
         .build();
   }
 }

src/main/java/com/google/devtools/build/lib/rules/objc/ObjcRuleClasses.java

@@ -14,6 +14,7 @@
 
 package com.google.devtools.build.lib.rules.objc;
 
+import static com.google.devtools.build.lib.packages.Attribute.ANY_RULE;
 import static com.google.devtools.build.lib.packages.Attribute.ConfigurationTransition.HOST;
 import static com.google.devtools.build.lib.packages.Attribute.attr;
 import static com.google.devtools.build.lib.packages.BuildType.LABEL;
@@ -971,6 +972,43 @@ public Metadata getMetadata() {
     }
   }
 
+  /**
+   * Common attributes for {@code objc_*} rules that create a signed IPA.
+   */
+  public static class IpaRule implements RuleDefinition {
+    @Override
+    public RuleClass build(Builder builder, RuleDefinitionEnvironment env) {
+      return builder
+          /* <!-- #BLAZE_RULE($objc_signing_rule).ATTRIBUTE(ipa_post_processor) -->
+          A tool that edits this target's IPA output after it is assembled but before it is
+          (optionally) signed.
+          <p>
+          The tool is invoked with a single positional argument which represents the path to a
+          directory containing the unzipped contents of the IPA. The only entry in this directory
+          will be the <code>Payload</code> root directory of the IPA. Any changes made by the tool
+          must be made in this directory, whose contents will be (optionally) signed and then
+          zipped up as the final IPA after the tool terminates.
+          <p>
+          The tool's execution must be hermetic given these inputs to ensure that its result can be
+          safely cached.
+          <!-- #END_BLAZE_RULE.ATTRIBUTE -->*/
+          .add(
+              attr("ipa_post_processor", LABEL)
+                  .allowedRuleClasses(ANY_RULE)
+                  .allowedFileTypes(FileTypeSet.ANY_FILE)
+                  .exec())
+          .build();
+    }
+
+    @Override
+    public Metadata getMetadata() {
+      return RuleDefinition.Metadata.builder()
+          .name("$objc_ipa_rule")
+          .type(RuleClassType.ABSTRACT)
+          .build();
+    }
+  }
+
   /**
    * Common attributes for {@code objc_*} rules that use the iOS simulator.
    */