Template

Permite que los desarrolladores de caras de reloj especifiquen un formato de cadena, como %s %d. El formato de cadena es muy similar a printf() en el lenguaje de programación C o a String.format() en Java.

Además, Template permite al desarrollador usar recursos de cadenas de Android, incluidos los declarados en res/values/strings.xml.

Se introdujo en Wear OS 4.

Sintaxis

<Template>template-string
    <Parameter expression="arithmetic-expression" />
</Template>

Ejemplos

En el siguiente fragmento de código, se muestra cómo imprimir la cadena Current heart rate: 80 con los elementos Template y Parameter:

<Template>%s %d
    <Parameter expression="Current heart rate: " />
    <Parameter expression="[HEART_RATE]" />
</Template>

En este fragmento de código, se muestra cómo usar un recurso de cadenas de Android dentro de una expresión:

<Template>%s<Parameter expression="greeting"></Parameter></Template>

En el ejemplo anterior, greeting se define en res/values/strings.xml:

<resources>
    <string name="greeting">Hello, world!</string>
</resources>

En este fragmento de código, se muestra cómo usar un recurso de cadenas de Android para imprimir la cadena Day: Fri:

<Template>day_of_week
    <Parameter expression="[DAY_OF_WEEK_S]" />
</Template>

En el ejemplo anterior, day_of_week se define en res/values/strings.xml:

<resources>
    <string name="day_of_week">Day: %1$s</string>
</resources>

Elementos internos

El elemento Template debe contener al menos un elemento interno Parameter. El elemento interno Parameter tiene un atributo, expression, que es una expresión aritmética cuyo valor se convierte en un tipo específico según la cadena de formato del elemento Template. Las expresiones en los diferentes elementos internos Parameter se evalúan de izquierda a derecha en la cadena de formato del elemento Template.