Modelo

Permite que os desenvolvedores de mostradores de relógio especifiquem um formato de string, como %s %d. O formato de string é muito semelhante a printf() na linguagem de programação C ou a String.format() na linguagem de programação Java (links em inglês).

Além disso, Template permite que o desenvolvedor use recursos de string do Android, incluindo os declarados em res/values/strings.xml.

Introduzido no Wear OS 4.

Sintaxe

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

Exemplos

O snippet de código abaixo indica como mostrar a string Current heart rate: 80 usando os elementos Template e Parameter:

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

Este snippet de código mostra como usar um recurso de string do Android em uma expressão:

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

em que greeting é definido em res/values/strings.xml:

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

Este snippet de código mostra como usar um recurso de string do Android para mostrar a string Day: Fri:

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

em que day_of_week é definido em res/values/strings.xml:

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

Elementos internos

O elemento Template precisa conter pelo menos um elemento interno Parameter. O elemento interno Parameter tem um atributo, expression, que é uma expressão aritmética cujo valor é convertido em um tipo específico de acordo com a string de formato do elemento Template. As expressões nos diferentes elementos internos Parameter são avaliadas da esquerda para a direita na string de formato do elemento Template.