Merge "Add Complex XML Resources guide to docs" into nyc-dev
This commit is contained in:
Adam Lesinski
committed by
Android (Google) Code Review
Android (Google) Code Review
commit
98a418758d
@@ -121,7 +121,7 @@
|
||||
<li><a href="<?cs var:toroot ?>guide/topics/resources/overview.html">
|
||||
<span class="en">Overview</span>
|
||||
</a></li>
|
||||
<li><a href="<?cs var:toroot ?>guide/topics/resources/providing-resources.html">
|
||||
<li><a href="<?cs var:toroot ?>guide/topics/resources/providing-resources.html">
|
||||
<span class="en">Providing Resources</span>
|
||||
</a></li>
|
||||
<li><a href="<?cs var:toroot ?>guide/topics/resources/accessing-resources.html">
|
||||
@@ -129,10 +129,13 @@
|
||||
</a></li>
|
||||
<li><a href="<?cs var:toroot ?>guide/topics/resources/runtime-changes.html">
|
||||
<span class="en">Handling Runtime Changes</span>
|
||||
</a></li>
|
||||
</a></li>
|
||||
<li><a href="<?cs var:toroot ?>guide/topics/resources/localization.html">
|
||||
<span class="en">Localization</span>
|
||||
</a></li>
|
||||
<li><a href="<?cs var:toroot ?>guide/topics/resources/complex-xml-resources.html">
|
||||
<span class="en">Complex XML Resources</span>
|
||||
</a></li>
|
||||
<li class="nav-section">
|
||||
<div class="nav-section-header"><a href="<?cs var:toroot ?>guide/topics/resources/available-resources.html">
|
||||
<span class="en">Resource Types</span>
|
||||
|
||||
117
docs/html/guide/topics/resources/complex-xml-resources.jd
Normal file
117
docs/html/guide/topics/resources/complex-xml-resources.jd
Normal file
@@ -0,0 +1,117 @@
|
||||
page.title=Inline Complex XML Resources
|
||||
parent.title=Application Resources
|
||||
parent.link=index.html
|
||||
@jd:body
|
||||
|
||||
<p>Certain resource types are a composition of multiple complex resources represented by XML files.
|
||||
One example is an animated vector drawable, which is a drawable resource encapsulating a vector
|
||||
drawable and an animation. This requires the use of at least three XML files.</p>
|
||||
|
||||
<dl>
|
||||
|
||||
<dt><code>res/drawable/avd.xml</code></dt>
|
||||
<dd>
|
||||
<pre class="stx">
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<animated-vector xmlns:android="http://schemas.android.com/apk/res/android"
|
||||
android:drawable="@drawable/vectordrawable" >
|
||||
<target
|
||||
android:name="rotationGroup"
|
||||
android:animation="@anim/rotation" />
|
||||
</animated-vector>
|
||||
</pre>
|
||||
</dd>
|
||||
|
||||
<dt><code>res/drawable/vectordrawable.xml</code></dt>
|
||||
<dd>
|
||||
<pre class="stx">
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<vector xmlns:android="http://schemas.android.com/apk/res/android"
|
||||
android:height="64dp"
|
||||
android:width="64dp"
|
||||
android:viewportHeight="600"
|
||||
android:viewportWidth="600" >
|
||||
<group
|
||||
android:name="rotationGroup"
|
||||
android:pivotX="300.0"
|
||||
android:pivotY="300.0"
|
||||
android:rotation="45.0" >
|
||||
<path
|
||||
android:fillColor="#000000"
|
||||
android:pathData="M300,70 l 0,-70 70,70 0,0 -70,70z" />
|
||||
</group>
|
||||
</vector>
|
||||
</pre>
|
||||
</dd>
|
||||
|
||||
<dt><code>res/anim/rotation.xml</code></dt>
|
||||
<dd>
|
||||
<pre class="stx">
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<objectAnimator xmlns:android="http://schemas.android.com/apk/android"
|
||||
android:duration="6000"
|
||||
android:propertyName="rotation"
|
||||
android:valueFrom="0"
|
||||
android:valueTo="360" />
|
||||
</pre>
|
||||
</dd>
|
||||
|
||||
</dl>
|
||||
|
||||
<p>There are a lot of files here just to make a single animated vector drawable!
|
||||
If the vector drawable and animations are re-used elsewhere, this is the best way to implement an
|
||||
animated vector drawable. If they’re only ever used for this animated vector drawable, then there is
|
||||
a more compact way to implement them.</p>
|
||||
|
||||
<p>Using AAPT’s inline resource format, you can define all three resources in the same XML file.
|
||||
Since we’re making an animated vector drawable, we put the file under <code>res/drawable/</code>.</p>
|
||||
|
||||
<dl>
|
||||
|
||||
<dt><code>res/drawable/avd.xml</code></dt>
|
||||
<dd>
|
||||
<pre class="stx">
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<animated-vector xmlns:android="http://schemas.android.com/apk/res/android"
|
||||
<strong>xmlns:aapt="http://schemas.android.com/aapt"</strong> >
|
||||
|
||||
<strong><aapt:attr name="android:drawable" ></strong>
|
||||
<vector
|
||||
android:height="64dp"
|
||||
android:width="64dp"
|
||||
android:viewportHeight="600"
|
||||
android:viewportWidth="600" >
|
||||
<group
|
||||
android:name="rotationGroup"
|
||||
android:pivotX="300.0"
|
||||
android:pivotY="300.0"
|
||||
android:rotation="45.0" >
|
||||
<path
|
||||
android:fillColor="#000000"
|
||||
android:pathData="M300,70 l 0,-70 70,70 0,0 -70,70z" />
|
||||
</group>
|
||||
</vector>
|
||||
<strong><aapt:attr /></strong>
|
||||
|
||||
<target
|
||||
android:name="rotationGroup" />
|
||||
<strong><aapt:attr name="android:animation" ></strong>
|
||||
<objectAnimator
|
||||
android:duration="6000"
|
||||
android:propertyName="rotation"
|
||||
android:valueFrom="0"
|
||||
android:valueTo="360" />
|
||||
<strong><aapt:attr></strong>
|
||||
</animated-vector>
|
||||
</pre>
|
||||
</dd>
|
||||
|
||||
</dl>
|
||||
|
||||
<p>The XML tag <code><aapt:attr ></code> tells AAPT that the tag’s child shall be treated as a
|
||||
resource and extracted into its own resource file. The value in the attribute name specifies where
|
||||
to use the inline resource within the parent tag.</p>
|
||||
|
||||
<p>AAPT will generate resource files and names for all of the inline resources.
|
||||
Applications built using this inline format are compatible with all versions of Android.</p>
|
||||
|
||||
@@ -9,6 +9,7 @@ page.title=Resources Overview
|
||||
<li><a href="accessing-resources.html">Accessing Resources</a></li>
|
||||
<li><a href="runtime-changes.html">Handling Runtime Changes</a></li>
|
||||
<li><a href="localization.html">Localization</a></li>
|
||||
<li><a href="complex-xml-resources.html">Complex XML Resources</a></li>
|
||||
</ol>
|
||||
|
||||
<h2>Reference</h2>
|
||||
@@ -79,6 +80,9 @@ code or from other XML resources.</dd>
|
||||
<dd>A bottom-up guide to localizing your application using alternative resources. While this is
|
||||
just one specific use of alternative resources, it is very important in order to reach more
|
||||
users.</dd>
|
||||
<dt><strong><a href="complex-xml-resources.html">Complex XML Resources</a></strong></dt>
|
||||
<dd>An XML format for building complex resources like animated vector drawables in a single
|
||||
XML file.</dd>
|
||||
<dt><strong><a href="available-resources.html">Resource Types</a></strong></dt>
|
||||
<dd>A reference of various resource types you can provide, describing their XML elements,
|
||||
attributes, and syntax. For example, this reference shows you how to create a resource for
|
||||
|
||||
Reference in New Issue
Block a user