1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
|
// 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 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;
import static com.google.devtools.build.lib.packages.BuildType.TRISTATE;
import static com.google.devtools.build.lib.syntax.Type.BOOLEAN;
import static com.google.devtools.build.lib.syntax.Type.STRING;
import static com.google.devtools.build.lib.syntax.Type.STRING_DICT;
import static com.google.devtools.build.lib.syntax.Type.STRING_LIST;
import com.google.devtools.build.lib.analysis.RuleDefinition;
import com.google.devtools.build.lib.analysis.RuleDefinitionEnvironment;
import com.google.devtools.build.lib.packages.Attribute.AllowedValueSet;
import com.google.devtools.build.lib.packages.RuleClass;
import com.google.devtools.build.lib.packages.RuleClass.Builder.RuleClassType;
import com.google.devtools.build.lib.packages.TriState;
import com.google.devtools.build.lib.rules.android.AndroidConfiguration.AndroidManifestMerger;
/**
* Attributes for {@code android_binary} that are not present on {@code android_test}.
*/
public final class AndroidBinaryOnlyRule implements RuleDefinition {
@Override
public RuleClass build(RuleClass.Builder builder, final RuleDefinitionEnvironment env) {
return builder
/* <!-- #BLAZE_RULE(android_binary).ATTRIBUTE(manifest_merger) -->
Select the manifest merger to use for this rule.<br/>
Possible values:
<ul>
<li><code>manifest_merger = "legacy"</code>: Use the legacy manifest merger. Does not
allow features of the android merger like placeholder substitution and tools
attributes for defining merge behavior. Removes all
<code><uses-permission></code> and <code><uses-permission-sdk-23></code>
tags. Performs a tag-level merge.</li>
<li><code>manifest_merger = "android"</code>: Use the android manifest merger. Allows
features like placeholder substitution and tools attributes for defining merge
behavior. Follows the semantics from
<a href="http://tools.android.com/tech-docs/new-build-system/user-guide/manifest-merger">
the documentation</a> except it has been modified to also remove all
<code><uses-permission></code> and <code><uses-permission-sdk-23></code>
tags. Performs an attribute-level merge.</li>
<li><code>manifest_merger = "auto"</code>: Merger is controlled by the
<a href="../blaze-user-manual.html#flag--android_manifest_merger">
--android_manifest_merger</a> flag.</li>
</ul>
<!-- #END_BLAZE_RULE.ATTRIBUTE --> */
.add(attr("manifest_merger", STRING)
.allowedValues(new AllowedValueSet(AndroidManifestMerger.getAttributeValues()))
.value(AndroidManifestMerger.getRuleAttributeDefault()))
/* <!-- #BLAZE_RULE(android_binary).ATTRIBUTE(manifest_values) -->
A dictionary of values to be overridden in the manifest. Any instance of ${name} in the
manifest will be replaced with the value corresponding to name in this dictionary.
applicationId, versionCode, versionName, minSdkVersion, targetSdkVersion and
maxSdkVersion will also override the corresponding attributes of the manifest and
uses-sdk tags. packageName will be ignored and will be set from either applicationId if
specified or the package in manifest. When manifest_merger is set to legacy, only
applicationId, versionCode and versionName will have any effect.
<!-- #END_BLAZE_RULE.ATTRIBUTE --> */
.add(attr("manifest_values", STRING_DICT))
/* <!-- #BLAZE_RULE(android_binary).ATTRIBUTE(nocompress_extensions) -->
A list of file extension to leave uncompressed in apk.
<!-- #END_BLAZE_RULE.ATTRIBUTE --> */
.add(attr("nocompress_extensions", STRING_LIST))
/* <!-- #BLAZE_RULE(android_binary).ATTRIBUTE(crunch_png) -->
Do PNG crunching (or not). This is independent of nine-patch processing, which is always
done. Currently only supported for local resources (not android_resources).
<!-- #END_BLAZE_RULE.ATTRIBUTE --> */
.add(attr("crunch_png", BOOLEAN).value(true))
/* <!-- #BLAZE_RULE(android_binary).ATTRIBUTE(resource_configuration_filters) -->
A list of resource configuration filters, such 'en' that will limit the resources in the
apk to only the ones in the 'en' configuration.
<!-- #END_BLAZE_RULE.ATTRIBUTE --> */
.add(attr("resource_configuration_filters", STRING_LIST))
/* <!-- #BLAZE_RULE(android_binary).ATTRIBUTE(shrink_resources) -->
Do resource shrinking (or not). This allows resource shrinking to be controlled on a per
target basis and will only be used if Android resource shrinking is enabled globally. This
is only supported for local resources (not android_resources).
<p>Possible values:
<ul>
<li><code>shrink_resources = 1</code>: Turns on Android resource shrinking</li>
<li><code>shrink_resources = 0</code>: Turns off Android resource shrinking</li>
<li><code>shrink_resources = -1</code>: Shrinking is controlled by the
<a href="../blaze-user-manual.html#flag--android_resource_shrinking">
--android_resource_shrinking</a> flag.</li>
</ul>
<!-- #END_BLAZE_RULE.ATTRIBUTE --> */
.add(attr("shrink_resources", TRISTATE)
.value(TriState.AUTO)
.undocumented("Android resource shrinking is still experimental"))
/* <!-- #BLAZE_RULE(android_binary).ATTRIBUTE(densities) -->
Densities to filter for when building the apk.
This will strip out raster drawable resources that would not be loaded by a device with
the specified screen densities, to reduce APK size. A corresponding compatible-screens
section will also be added to the manifest if it does not already contain a superset
listing.
<!-- #END_BLAZE_RULE.ATTRIBUTE --> */
.add(attr("densities", STRING_LIST))
.add(attr("$android_manifest_merge_tool", LABEL)
.cfg(HOST)
.exec()
.value(env.getToolsLabel(AndroidRuleClasses.MANIFEST_MERGE_TOOL_LABEL)))
.removeAttribute("data")
.build();
}
@Override
public Metadata getMetadata() {
return RuleDefinition.Metadata.builder()
.name("$android_binary_only")
.type(RuleClassType.ABSTRACT)
.ancestors(AndroidRuleClasses.AndroidBinaryBaseRule.class)
.build();
}
}
|