Usar a Biblioteca de IU do Wear

O Android Jetpack permite interfaces de usuário consistentes e otimizadas em todos os apps. O Android Jetpack inclui a Biblioteca de IU do Wear, que contém muitos dos componentes de IU preferenciais para seus apps Wear OS.

A Biblioteca de IU do Wear inclui (entre outras) as seguintes classes. Algumas das classes têm nomes semelhantes e oferecem vários benefícios em relação às classes obsoletas relacionadas da Biblioteca de Suporte para Wearable:

• BoxInsetLayout. Um layout que aplica encartes para telas redondas.
• SwipeDismissFrameLayout. Um layout que permite que o usuário dispense qualquer visualização deslizando da esquerda para a direita na tela.
• WearableRecyclerView. Uma visualização que fornece um layout curvo, como aquele usado para o inicializador de aplicativos Wear.
• AmbientModeSupport. Uma classe usada com a interface AmbientModeSupport.AmbientCallbackProvider para oferecer compatibilidade com o modo ambiente.

Consulte também Gavetas de ação e navegação na Biblioteca de IU do Wear.

Adicionar uma dependência à Biblioteca de IU do Wear

Para usar a Biblioteca de IU do Wear, adicione a dependência a seguir no arquivo build.gradle do módulo Wear:

    dependencies {
        ...
        compile 'androidx.wear:wear:1.0.0'
    }
    

Importar classes do pacote da Biblioteca de IU do Wear

Ao usar uma classe da Biblioteca de IU do Wear, importe-a do pacote androidx.wear.widget. Consulte o Exemplo de uso de uma classe da biblioteca.

Usar os nomes de elementos corretos em arquivos de layout

Nos arquivos de layout, use nomes totalmente qualificados que correspondam à Biblioteca de IU do Wear (e não à Biblioteca de Suporte para Wearable).

Por exemplo, para usar a classe SwipeDismissFrameLayout da Biblioteca de IU do Wear, você pode especificar o seguinte em um arquivo de layout:

    <androidx.wear.widget.SwipeDismissFrameLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:tools="http://schemas.android.com/tools"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:id="@+id/swipe_dismiss_root" >

        <TextView
            android:id="@+id/test_content"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:gravity="center"
            android:text="Swipe the screen to dismiss me." />
    </androidx.wear.widget.SwipeDismissFrameLayout>
    

Exemplo de uso de uma classe da Biblioteca de IU do Wear

As classes da Biblioteca de IU do Wear têm funcionalidade igual ou semelhante à da Biblioteca de Suporte de Wearables. Alguns nomes de classes, métodos e atributos foram atualizados para melhorar a consistência com a Biblioteca de Suporte do Android.

Por exemplo, uma atividade que usa a classe WearableRecyclerView da Biblioteca de Suporte para Wearable pode incluir o seguinte código:

    import androidx.wear.widget.WearableRecyclerView
    ...
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.wearable_recycler_view_basic)
        findViewById<WearableRecyclerView>(R.id.wrv).apply {
            layoutManager = ChildLayoutManager()
            adapter = TestAdapter()
        }
    }
    

    import androidx.wearable.view.WearableRecyclerView;
    ...
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.wearable_recycler_view_basic);
        WearableRecyclerView wrv = findViewById(R.id.wrv);
        wrv.setLayoutManager(new ChildLayoutManager());
        wrv.setAdapter(new TestAdapter());
    }
    

Da mesma forma, uma atividade que usa a classe WearableRecyclerView da Biblioteca de IU do Wear pode incluir o código a seguir. As diferenças em relação ao código acima estão em negrito:

    import androidx.wear.widget.WearableRecyclerView
    ...
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.wearable_recycler_view_basic)
        findViewById<WearableRecyclerView>(R.id.wrv).apply {
            layoutManager = WearableLinearLayoutManager(this@MainActivity)
            adapter = TestAdapter()
        }
    }
    

    import androidx.wear.widget.WearableRecyclerView;
    ...
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.wearable_recycler_view_basic);
        WearableRecyclerView wrv = findViewById(R.id.wrv);
        wrv.setLayoutManager(new WearableLinearLayoutManager(this));
        wrv.setAdapter(new TestAdapter());
    }
    

Gavetas de ação e navegação na Biblioteca de IU do Wear

A Biblioteca de IU do Wear tem componentes para gavetas de ação e navegação.

Para mais informações, consulte Navegação e ações do Android Wear.

Substituições para classes obsoletas

A tabela abaixo contém substituições, presentes na Biblioteca de IU do Wear e em outros lugares, para classes obsoletas da Biblioteca de Suporte para Wearable.