內嵌複雜的 XML 資源

某些資源類型是由多個複雜資源組成，以 XML 檔案的形式呈現。其中一個例子是動畫向量可繪項目，這個可繪製資源封裝了一個向量可繪項目和一個動畫。這需要使用至少三個 XML 檔案，如下列範例所示。

res/drawable/avd.xml

<?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>

res/drawable/vectordrawable.xml

<?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>

res/anim/rotation.xml

<?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" />

如果在其他位置重複使用此向量可繪項目和動畫，這就是動畫向量可繪項目的最佳實作方式。但是，如果這些檔案僅用於此動畫向量可繪項目，則有更簡潔的實作方式。

您可以使用 AAPT 的內嵌資源格式，在同一個 XML 檔案中定義全部三項資源，如以下範例所示。 請將動畫向量可繪項目的檔案放在 res/drawable/ 底下。

res/drawable/avd.xml

<?xml version="1.0" encoding="utf-8"?>
<animated-vector xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:aapt="http://schemas.android.com/aapt" >

    <aapt:attr name="android:drawable" >
        <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>
    </aapt:attr>

    <target android:name="rotationGroup">
        <aapt:attr name="android:animation" >
            <objectAnimator
                android:duration="6000"
                android:propertyName="rotation"
                android:valueFrom="0"
                android:valueTo="360" />
        </aapt:attr>
    </target>
</animated-vector>

XML 標記 <aapt:attr > 會指示 AAPT 將標記的子項視為資源，並將其擷取到專屬的資源檔案中。屬性名稱中的值會指定父項標記中要使用內嵌資源的位置。

AAPT 會產生所有內嵌資源的資源檔案和名稱。使用這個內嵌格式建構的應用程式可與所有 Android 版本相容。