blob: ba11e488197dc04c8e21d5f3ebad38eb6f9cd97d [file] [log] [blame]
{namespace android_prebuilt_aar}
/***/
{template .soyweb}
{call buck.page}
{param title: 'android_prebuilt_aar()' /}
{param prettify: true /}
{param description}
A rule that takes an .aar file and makes it available as an Android
dependency.
{/param}
{param content}
{call buck.rule}
{param status: 'FROZEN' /}
{param overview}
An <code>android_prebuilt_aar()</code> rule takes an <code>.aar</code> file and
makes it available as an Android dependency. As expected,
an {call buck.android_binary /} that transitively depends on
an <code>android_prebuilt_aar()</code> will include its contents in the generated APK.
<p>
<p>
See the <a href="http://tools.android.com/tech-docs/new-build-system/aar-format">
official Android documentation</a> for details about the <code>.aar</code> format.
{/param}
{param args}
{call buck.arg}
{param name: 'name' /}
{param desc}
The name of the rule.
{/param}
{/call}
{call buck.arg}
{param name: 'aar' /}
{param desc}
Path to the <code>.aar</code> file. This may also be a build target to
a rule (such as a {call buck.genrule /}) whose output is
an <code>.aar</code> file.
{/param}
{/call}
{call buck.visibility_arg /}
{/param} // close args
{param examples}
{literal}<pre class="prettyprint lang-py">
android_prebuilt_aar(
name = 'play-services',
aar = 'play-services-4.0.30.aar',
)
android_library(
name = 'lib',
# This Java code can compile against Play services and reference its resources.
srcs = glob(['*.java']),
deps = [ ':play-services' ],
)</pre>{/literal}
{/param}
{/call} // close buck.rule
{/param}
{/call}
{/template}