Esta página foi traduzida pela API Cloud Translation.

Visão geral de recursos e APIs

O Android 15 introduz ótimos recursos e APIs novos para desenvolvedores. As seções a seguir resumem esses recursos para ajudar você a começar a usar as APIs relacionadas.

Para uma lista detalhada das APIs novas, modificadas e removidas, leia o relatório de diferenças da API. Para ver detalhes sobre as novas APIs, acesse a Referência da API do Android. As novas APIs estão em destaque para visibilidade. Além disso, para saber mais sobre as áreas em que as mudanças na plataforma podem afetar seus apps, consulte as mudanças de comportamento que afetam os apps direcionados ao Android 15 e as mudanças de comportamento que afetam todos os apps, independente da targetSdkVersion.

Câmera e mídia

O Android 15 inclui uma variedade de recursos que melhoram a experiência de câmera e mídia e que dão acesso a ferramentas e hardware para ajudar os criadores a dar vida às ideias deles no Android.

Para saber mais sobre os recursos mais recentes e soluções para desenvolvedores para mídia e câmera Android, confira a palestra Como criar experiências modernas de mídia e câmera Android do Google I/O.

Intensificação de pouca luz

O Android 15 apresenta o Melhoria de pouca luz, um novo modo de exposição automática disponível para a Câmera 2 e a extensão de câmera do modo noturno. O recurso "Baixa iluminação" ajusta a exposição do stream da prévia em condições de pouca luz. Isso é diferente de como a extensão de câmera do modo noturno cria imagens estáticas, porque esse modo combina uma sequência de fotos para criar uma imagem única e aprimorada. Embora o modo noturno funcione muito bem para criar uma imagem estática, ele não pode criar um fluxo contínuo de frames, mas o recurso Low Light Boost pode fazer. Assim, o recurso "Baixa iluminação" ativa novos recursos da câmera, como:

Fornece uma visualização de imagem aprimorada para que os usuários possam enquadrar fotos com pouca luz.
Como ler QR codes com pouca luz

Se você ativar o aprimoramento de pouca luz, ele será ativado automaticamente quando houver um nível baixo de luz e será desativado quando houver mais luz.

Os apps podem gravar fora do stream da prévia em condições de pouca luz para salvar um vídeo brilhante.

Para saber mais, consulte Intensificação de luz.

Controles de câmera no app

O Android 15 adiciona uma nova extensão para ter mais controle sobre o hardware da câmera e os algoritmos em dispositivos com suporte:

Ajustes avançados de intensidade do flash que permitem um controle preciso da intensidade do flash nos modos SINGLE e TORCH durante a captura de imagens.

Controle de margem de HDR

O Android 15 escolhe a margem de HDR adequada para os recursos do dispositivo e a profundidade de bits do painel. Em páginas que têm muito conteúdo SDR, como um app de mensagens exibindo uma única miniatura HDR, esse comportamento pode afetar negativamente o brilho percebido do conteúdo SDR. O Android 15 permite controlar a margem do HDR com setDesiredHdrHeadroom para encontrar um equilíbrio entre conteúdo SDR e HDR.

O brilho dos elementos da IU SDR na tela esquerda parece ser mais uniforme do que o brilho na tela direita, o que simula possíveis problemas de margem quando os conteúdos HDR e SDR estão misturados. Ao ajustar a margem do HDR, você pode alcançar um equilíbrio melhor entre o conteúdo SDR e HDR.

Controle do volume

O Android 15 oferece suporte ao padrão de volume CTA-2075 para evitar inconsistências de volume de áudio e garantir que os usuários não precisem ajustar constantemente o volume ao alternar entre conteúdos. O sistema aproveita os dados características dos dispositivos de saída (fones de ouvido e alto-falantes), além de metadados de volume disponíveis no conteúdo de áudio AAC para ajustar de forma inteligente o volume do áudio e níveis de compactação do intervalo dinâmico.

Para ativar esse recurso, você precisa garantir que os metadados de intensidade de som estejam disponíveis no conteúdo AAC e ativar o recurso da plataforma no app. Para isso, instancie um objeto LoudnessCodecController chamando o método de fábrica create com o ID da sessão de áudio do AudioTrack associado. Isso começa a aplicar automaticamente as atualizações de áudio. É possível transmitir um OnLoudnessCodecUpdateListener para modificar ou filtrar loudness antes de serem aplicados ao MediaCodec

// Media contains metadata of type MPEG_4 OR MPEG_D
val mediaCodec = …
val audioTrack = AudioTrack.Builder()
                                .setSessionId(sessionId)
                                .build()
...
// Create new loudness controller that applies the parameters to the MediaCodec
try {
   val lcController = LoudnessCodecController.create(mSessionId)
   // Starts applying audio updates for each added MediaCodec
}

O ExoPlayer da AndroidX media3 também será atualizado para usar a LoudnessCodecController APIs para uma integração perfeita de apps.

Dispositivos MIDI virtual 2.0

O Android 13 adicionou suporte à conexão com Dispositivos MIDI 2.0 por USB, que se comunicam usando Pacotes MIDI (UMP). O Android 15 estende o suporte à UMP para MIDI virtual , permitindo que apps de composição controlem apps de sintetizador como um dispositivo MIDI 2.0 virtual, como faria com um USB MIDI 2.0.

Decodificação de software AV1 mais eficiente

Logotipo da dav1d

dav1d, o conhecido decodificador de software AV1 do VideoLAN agora está disponível para dispositivos Android que não são compatíveis com a decodificação AV1 em hardware. O dav1d tem um desempenho até três vezes maior do que o decodificador de software AV1 legado, permitindo a reprodução HD AV1 para mais usuários, incluindo alguns dispositivos de níveis básicos e intermediários.

Por enquanto, seu app precisa ativar o uso dav1d invocando-o pelo nome "c2.android.av1-dav1d.decoder". O dav1d será o decodificador padrão do software AV1 em uma atualização subsequente. Esse suporte é padronizado e oferece backport para dispositivos Android 11 que recebem atualizações do sistema do Google Play.

Produtividade e ferramentas para desenvolvedores

Embora a maior parte do nosso trabalho para melhorar a produtividade tenha como foco ferramentas como o Android Studio, o Jetpack Compose e as bibliotecas do Android Jetpack, sempre procuramos maneiras de ajudar você a dar vida às suas ideias com mais facilidade.

Atualizações do OpenJDK 17

O Android 15 continua o trabalho de atualizar as principais bibliotecas do Android para se alinhar aos recursos das versões mais recentes do LTS do OpenJDK.

Os seguintes recursos e melhorias principais estão incluídos:

Melhorias na qualidade de vida em relação aos buffers NIO
Streams
Métodos adicionais math e strictmath
Atualizações do pacote util, incluindo collection, map e set sequenciados
Suporte de ByteBuffer em Deflater
Atualizações de segurança, como o X500PrivateCredential e atualizações de chaves de segurança,

Essas APIs são atualizadas em mais de um bilhão de dispositivos com o Android 12 (nível 31 da API) e versões mais recentes com as atualizações do sistema do Google Play. Assim, você pode usar os recursos de programação mais recentes.

Melhorias no PDF

O Android 15 inclui melhorias substanciais no PdfRenderer. APIs de terceiros. Os aplicativos podem incorporar recursos avançados, como renderização arquivos protegidos por senha, anotações, edição de formulários, pesquisa e seleção com cópia. PDF linearizado são suportadas para acelerar a visualização do PDF local e reduzir o uso de recursos. A biblioteca PDF do Jetpack usa essas APIs para simplificar a adição de recursos de visualização de PDF ao app.

As últimas atualizações para a renderização de PDF incluem recursos como pesquisar um arquivo PDF incorporado.

O PdfRenderer foi movido para um módulo que pode ser atualizado usando o Google As atualizações do sistema do Google Play são independentes da versão da plataforma, e temos suporte para essas mudanças de volta para o Android 11 (nível 30 da API), criando uma versão anterior ao Android 15 da plataforma da API, chamada PdfRendererPreV.

Refinamentos automáticos da troca de idioma

O Android 14 adicionou o reconhecimento de vários idiomas no dispositivo em áudio com a alternância automática entre idiomas, mas isso pode causar a queda das palavras, especialmente quando os idiomas são alternados com menos pausa entre as duas expressões. O Android 15 adiciona outros controles para ajudar os apps a ajustar essa alternância para o caso de uso. EXTRA_LANGUAGE_SWITCH_INITIAL_ACTIVE_DURATION_TIME_MILLIS confina a troca automática ao início da sessão de áudio, enquanto EXTRA_LANGUAGE_SWITCH_MATCH_SWITCHES desativa a alternância de idioma após um número definido de trocas. Essas opções são especialmente úteis se você espera que um único idioma falado durante a sessão precise ser detectado automaticamente.

API OpenType Variable Font aprimorada

O Android 15 melhora a usabilidade da fonte variável OpenType. Agora é possível criar uma instância de FontFamily usando uma fonte variável sem especificar de peso com a API buildVariableFamily. O renderizador de texto substitui o valor do eixo wght para corresponder ao texto exibido.

Usando a nova API, isso simplifica o código para criar um Typeface. consideravelmente:

Kotlin

val newTypeface = Typeface.CustomFallbackBuilder(
            FontFamily.Builder(
                Font.Builder(assets, "RobotoFlex.ttf").build())
                    .buildVariableFamily())
    .build()

Java

Typeface newTypeface = Typeface.CustomFallbackBuilder(
            new FontFamily.Builder(
                new Font.Builder(assets, "RobotoFlex.ttf").build())
                    .buildVariableFamily())
    .build();

Anteriormente, para criar o mesmo Typeface, você precisaria de muito mais código:

Kotlin

val oldTypeface = Typeface.CustomFallbackBuilder(
            FontFamily.Builder(
                Font.Builder(assets, "RobotoFlex.ttf")
                    .setFontVariationSettings("'wght' 400")
                    .setWeight(400)
                    .build())
                .addFont(
                    Font.Builder(assets, "RobotoFlex.ttf")
                        .setFontVariationSettings("'wght' 100")
                        .setWeight(100)
                        .build()
                )
                .addFont(
                    Font.Builder(assets, "RobotoFlex.ttf")
                        .setFontVariationSettings("'wght' 200")
                        .setWeight(200)
                        .build()
                )
                .addFont(
                    Font.Builder(assets, "RobotoFlex.ttf")
                        .setFontVariationSettings("'wght' 300")
                        .setWeight(300)
                        .build()
                )
                .addFont(
                    Font.Builder(assets, "RobotoFlex.ttf")
                        .setFontVariationSettings("'wght' 500")
                        .setWeight(500)
                        .build()
                )
                .addFont(
                    Font.Builder(assets, "RobotoFlex.ttf")
                        .setFontVariationSettings("'wght' 600")
                        .setWeight(600)
                        .build()
                )
                .addFont(
                    Font.Builder(assets, "RobotoFlex.ttf")
                        .setFontVariationSettings("'wght' 700")
                        .setWeight(700)
                        .build()
                )
                .addFont(
                    Font.Builder(assets, "RobotoFlex.ttf")
                        .setFontVariationSettings("'wght' 800")
                        .setWeight(800)
                        .build()
                )
                .addFont(
                    Font.Builder(assets, "RobotoFlex.ttf")
                        .setFontVariationSettings("'wght' 900")
                        .setWeight(900)
                        .build()
                ).build()
        ).build()

Java

Typeface oldTypeface = new Typeface.CustomFallbackBuilder(
    new FontFamily.Builder(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 400")
            .setWeight(400)
            .build()
    )
    .addFont(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 100")
            .setWeight(100)
            .build()
    )
    .addFont(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 200")
            .setWeight(200)
            .build()
    )
    .addFont(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 300")
            .setWeight(300)
            .build()
    )
    .addFont(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 500")
            .setWeight(500)
            .build()
    )
    .addFont(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 600")
            .setWeight(600)
            .build()
    )
    .addFont(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 700")
            .setWeight(700)
            .build()
    )
    .addFont(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 800")
            .setWeight(800)
            .build()
    )
    .addFont(
        new Font.Builder(assets, "RobotoFlex.ttf")
            .setFontVariationSettings("'wght' 900")
            .setWeight(900)
            .build()
    )
    .build()
).build();

Confira um exemplo de como uma Typeface foi criada com a API antiga e a nova. renderiza:

Um exemplo de como a renderização de família tipográfica é diferente usando as versões novas e antigas
APIs

Neste exemplo, a Typeface criada com a API antiga não tem a para criar pesos precisos de fonte para os tamanhos 350, 450, 550 e 650 instâncias de Font, então o renderizador retorna ao peso mais próximo. Então, em neste caso, 300 é renderizado em vez de 350, 400 é renderizado em vez de 450 e assim por diante. Por outro lado, a Typeface criada com as novas APIs cria dinamicamente uma instância de Font para um determinado peso, então pesos precisos são renderizados para 350, 450, 550 e 650.

Controles granulares de quebra de linha

从 Android 15 开始，TextView 和底层换行符可以保留同一行中给定的文本部分，可读性。您可以通过使用字符串资源中的 <nobreak> 标记，或 createNoBreakSpan。同样，您可以保留使用 <nohyphen> 标记断字；或者 createNoHyphenationSpan。

例如，以下字符串资源不包含换行符，并且渲染时会显示“Pixel 8 Pro”文字在不理想的位置发生故障：

<resources>
    <string name="pixel8pro">The power and brains behind Pixel 8 Pro.</string>
</resources>

相比之下，此字符串资源包含 <nobreak> 标记，用于封装如“Pixel 8 Pro”并防止换行：

<resources>
    <string name="pixel8pro">The power and brains behind <nobreak>Pixel 8 Pro.</nobreak></string>
</resources>

下方显示了这些字符串的呈现方式差异图片：

一行文字的布局，其中包含短语“Pixel 8 Pro”。未使用 <nobreak> 标记进行封装。

短语“Pixel 8 Pro”所在的同一行文字的布局。使用 <nobreak> 标记封装。

Arquivamento de apps

O Android e o Google Play anunciaram o suporte ao arquivamento de apps por último ano, permitindo que os usuários liberem espaço removendo parcialmente apps usados com pouca frequência do dispositivo que foram publicados usando o app Android Pacote no Google Play. O Android 15 inclui suporte no nível do SO para arquivamento e desarquivamento de apps, facilitando a implementação em todas as app stores.

Apps com a permissão REQUEST_DELETE_PACKAGES podem chamar o PackageInstaller requestArchive para solicitar o arquivamento de um do pacote de apps instalado, que remove o APK e todos os arquivos em cache, mas persiste dados do usuário. Os apps arquivados são retornados como apps que podem ser exibidos por meio do APIs do LauncherApps os usuários verão um tratamento de interface para destacar e os apps são arquivados. Se um usuário tocar em um app arquivado, o instalador responsável receberá uma solicitação para desarquivá-la. Nesse caso, será possível monitorado pela transmissão ACTION_PACKAGE_ADDED.

Gráficos

O Android 15 traz as melhorias gráficas mais recentes, incluindo o ANGLE e adições ao sistema gráfico Canvas.

Como modernizar o acesso a GPUs do Android

Logotipo da Vulkan

O hardware do Android evoluiu bastante desde os primeiros dias, em que o SO principal era executado em uma única CPU, e as GPUs eram acessadas usando APIs com base em pipelines de função fixa. A API gráfica Vulkan® está disponível no NDK desde o Android 7.0 (nível 24 da API) com uma abstração de nível inferior que reflete melhor o hardware de GPU moderno, escalona melhor para oferecer suporte a vários núcleos da CPU e oferece redução da sobrecarga do driver da CPU, melhorando o desempenho do app. O Vulkan oferece suporte a todos os mecanismos de jogos modernos.

O Vulkan é a interface preferencial do Android para a GPU. Portanto, o Android 15 inclui o ANGLE como uma camada opcional para executar o OpenGL® ES sobre o Vulkan. A migração para o ANGLE vai padronizar a implementação do OpenGL do Android para melhorar a compatibilidade e, em alguns casos, o desempenho. Você pode testar a estabilidade e o desempenho do app OpenGL ES com o ANGLE ativando a opção do desenvolvedor em Settings -> System -> Developer Options -> Experimental: Enable ANGLE no Android 15.

O Android ANGLE no roteiro Vulkan

Roteiro das próximas mudanças nas APIs de GPU do Android.

Como parte da simplificação da nossa pilha de GPU, a partir de agora, lançaremos o ANGLE como o driver do sistema GL em mais dispositivos novos, com a expectativa futura de que o OpenGL/ES só esteja disponível pelo ANGLE. Dito isso, planejamos continuar a compatibilidade com o OpenGL ES em todos os dispositivos.

Próximas etapas recomendadas

Use as opções do desenvolvedor para selecionar o driver ANGLE para OpenGL ES e testar seu app. Para novos projetos, recomendamos o uso do Vulkan para C/C++.

Melhorias no Canvas

O Android 15 continua nossa modernização do sistema gráfico Canvas do Android com novos recursos:

Matrix44 fornece uma matriz 4x4 para transformar coordenadas que precisam ser usadas quando você quiser manipular a tela em 3D.
clipShader cruza o clipe atual com o sombreador especificado, enquanto clipOutShader define o clipe como a diferença entre o clipe atual e o sombreador, tratando o sombreador como uma máscara alfa. Isso permite desenhar formas complexas de maneira eficiente.

Performance e bateria

O Android continua focado em ajudar você a melhorar o desempenho e a qualidade dos seus apps. O Android 15 apresenta novas APIs que ajudam a tornar as tarefas do app mais eficientes, otimizar a performance e coletar insights sobre eles.

Para conferir práticas recomendadas de eficiência da bateria, depuração de rede e uso de energia, além de detalhes sobre como melhoramos a eficiência do trabalho em segundo plano no Android 15 e em versões recentes do Android, consulte a palestra Como melhorar a eficiência do trabalho em segundo plano no Android no Google I/O.

API ApplicationStartInfo

Nas versões anteriores do Android, a inicialização de apps era um pouco misteriosa. Era difícil determinar, no seu app, se ele iniciava de um estado frio, quente ou quente. Também era difícil saber quanto tempo o app passava durante as várias fases de lançamento: bifurcar o processo, chamar onCreate, desenhar o primeiro frame, entre outras. Quando a classe Application era instanciada, você não tinha como saber se o app era iniciado por uma transmissão, um provedor de conteúdo, um job, um backup, uma inicialização concluída, um alarme ou um Activity.

A API ApplicationStartInfo no Android 15 oferece tudo isso e muito mais. Você pode até adicionar seus próprios carimbos de data/hora ao fluxo para ajudar a coletar dados de tempo em um só lugar. Além de coletar métricas, você pode usar ApplicationStartInfo para otimizar diretamente a inicialização do app. Por exemplo, você pode eliminar a instanciação cara de bibliotecas relacionadas à interface na classe Application quando o app está iniciando devido a uma transmissão.

Informações detalhadas sobre o tamanho do app

Desde o Android 8.0 (nível 26 da API), o Android inclui a API StorageStats.getAppBytes, que resume o tamanho instalado de um app como um único número de bytes, que é uma soma do tamanho do APK, do tamanho dos arquivos extraídos do APK e dos arquivos gerados no dispositivo, como código compilado antecipado (AOT, na sigla em inglês). Esse número não é muito útil em termos de como seu app está usando o armazenamento.

O Android 15 adiciona a API StorageStats.getAppBytesByDataType([type]), que permite ter insights sobre como o app está usando todo esse espaço, incluindo divisões de arquivo APK, AOT e código relacionado à aceleração, metadados de dex, bibliotecas e perfis guiados.

Criação de perfil gerenciada pelo app

O Android 15 inclui a classe ProfilingManager, que permite coletar informações de criação de perfil dentro do seu aplicativo. Planejamos encerrar esse com uma API Android Jetpack que simplificará a criação de perfis mas a API principal permite a coleta de heap dumps, perfis, amostragem de pilhas e muito mais. Ele fornece um callback para o app com uma tag fornecida para identificar o arquivo de saída, que é enviado para o diretório de arquivos do app. A API faz uma limitação de taxa para minimizar o impacto no desempenho.

Melhorias no banco de dados SQLite

O Android 15 apresenta APIs SQLite que expõem recursos avançados do mecanismo SQLite que são destinados a problemas de desempenho específicos que podem se manifestar em apps. Essas APIs estão incluídas na atualização do SQLite para a versão 3.44.3.

Os desenvolvedores precisam consultar as práticas recomendadas para a performance do SQLite. para aproveitar ao máximo o banco de dados SQLite, especialmente ao trabalhar com grandes ou ao executar consultas sensíveis à latência.

Transações adiadas somente leitura: ao emitir transações somente leitura (sem instruções de gravação), use beginTransactionReadOnly() e beginTransactionWithListenerReadOnly(SQLiteTransactionListener) para emitir transações DEFERRED somente leitura. Essas transações podem ser executadas simultaneamente entre si e, se o banco de dados estiver no modo WAL, eles poderão são executados simultaneamente a transações IMMEDIATE ou EXCLUSIVE.
Contagem e IDs de linhas: foram adicionadas APIs para extrair a contagem de linhas alteradas ou o ID da última linha inserida sem emitir uma consulta extra. getLastChangedRowCount() retorna o número de linhas que foram inseridos, atualizados ou excluídos pela instrução SQL mais recente no a transação atual, enquanto getTotalChangedRowCount() retorna a contagem da conexão atual. getLastInsertRowId() retorna o rowid da última linha. seja inserido na conexão atual.
Instruções brutas: emitem uma instrução SQL bruta, sem a conveniência. wrappers e qualquer sobrecarga de processamento adicional que eles possam incorrer.

Atualizações do Android Dynamic Performance Framework

O Android 15 continua nosso investimento no Android Dynamic Performance Framework (ADPF), um conjunto de APIs que permite que jogos e apps com alto desempenho interajam mais diretamente com os sistemas térmicos e de energia de dispositivos Android. Em dispositivos com suporte, o Android 15 vai adicionar novos recursos de ADPF:

Um modo de eficiência energética para sessões de dicas indicam que as linhas de execução associadas preferem a economia de energia em vez do desempenho, o que é ótimo para cargas de trabalho em segundo plano de longa duração.
As durações do trabalho de GPU e da CPU podem ser informadas em sessões de dicas, permitindo que o sistema ajuste as frequências de CPU e GPU juntas para atender melhor às demandas de carga de trabalho.
Limites da margem térmica para interpretar o possível status de limitação térmica com base na previsão da margem.

Para saber mais sobre como usar o ADPF em apps e jogos, acesse a documentação.

Privacidade

O Android 15 inclui uma variedade de recursos que ajudam os desenvolvedores de apps a proteger a privacidade do usuário.

Detecção de gravação de tela

Android 15 增加了对应用的支持，以检测正在录制。每当应用转换时，系统都会调用回调在屏幕录制内容中处于可见与隐藏状态之间。如果正在记录注册进程的 UID 拥有的 activity，则系统会将应用视为可见。这样一来，如果您的应用执行敏感操作，您就可以告知用户正在录制他们的操作。

val mCallback = Consumer<Int> { state ->
  if (state == SCREEN_RECORDING_STATE_VISIBLE) {
    // We're being recorded
  } else {
    // We're not being recorded
  }
}

override fun onStart() {
   super.onStart()
   val initialState =
      windowManager.addScreenRecordingCallback(mainExecutor, mCallback)
   mCallback.accept(initialState)
}

override fun onStop() {
    super.onStop()
    windowManager.removeScreenRecordingCallback(mCallback)
}

Recursos expandidos de IntentFilter

O Android 15 oferece suporte a uma resolução de Intent mais precisa usando UriRelativeFilterGroup, que contém um conjunto de Objetos UriRelativeFilter que formam um conjunto de Intent que precisam ser cumpridas, incluindo parâmetros de consulta e URL e regras de bloqueio ou exclusão.

Essas regras podem ser definidas no arquivo XML AndroidManifest com a tag <uri-relative-filter-group>, que pode incluir uma tag android:allow. Essas tags podem conter tags <data> que usam atributos de tag de dados existentes, além dos atributos android:query e android:fragment.

Confira um exemplo da sintaxe AndroidManifest:

<intent-filter>
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.BROWSABLE" />
  <data android:scheme="http" />
  <data android:scheme="https" />
  <data android:domain="astore.com" />
  <uri-relative-filter-group>
    <data android:pathPrefix="/auth" />
    <data android:query="region=na" />
  </uri-relative-filter-group>
  <uri-relative-filter-group android:allow="false">
    <data android:pathPrefix="/auth" />
    <data android:query="mobileoptout=true" />
  </uri-relative-filter-group>
  <uri-relative-filter-group android:allow="false">
    <data android:pathPrefix="/auth" />
    <data android:fragmentPrefix="faq" />
  </uri-relative-filter-group>
</intent-filter>

Espaço privado

O espaço privado permite que os usuários criem um espaço separado no dispositivo onde podem manter aplicativos sensíveis longe de olhares curiosos, sob uma camada adicional de autenticação. O espaço privado usa um perfil de usuário separado. O usuário pode optar por usar o bloqueio do dispositivo ou um fator de bloqueio separado para o espaço privado.

Os apps no espaço privado aparecem em um contêiner separado no acesso rápido. ficam ocultos da visualização recente, das notificações, das configurações e de outros apps; quando o espaço privado está bloqueado. Conteúdo gerado e baixado pelo usuário (como mídia ou arquivos) e as contas ficam separadas entre o espaço privado espaço principal. O Sharesheet do sistema e o O seletor de fotos pode ser usado para dar aos apps acesso ao conteúdo entre os espaços quando o espaço privado está desbloqueado.

Os usuários não podem mover apps e dados para o espaço particular. Em vez disso, os usuários selecionam uma opção de instalação no espaço privado para instalar um app usando a app store que eles preferem. Os apps no espaço privado são instalados como cópias separadas de qualquer app no espaço principal (novas cópias do mesmo app).

Quando um usuário bloqueia o espaço privado, o perfil é interrompido. Enquanto o perfil for interrompido, os apps no espaço privado não estão mais ativos e não podem ser executados atividades em primeiro ou segundo plano, incluindo notificações.

Recomendamos testar o app com o espaço privado para garantir que ele funciona conforme o esperado, especialmente se o app se enquadrar em um dos categorias:

Apps com lógica para perfis de trabalho que pressupõem que qualquer cópias instaladas do app que não estejam no perfil principal estejam no do seu perfil de trabalho.
Apps de medicina
Apps de inicialização
Apps da app store

Consultar a seleção de usuário mais recente para acessar as fotos selecionadas

应用现在可以仅突出显示最近选择的照片以及视频（已获得媒体部分访问权限）。这个功能可以改善频繁请求访问照片和视频。要在您的应用中使用此功能，请启用查询 MediaStore 时使用 QUERY_ARG_LATEST_SELECTION_ONLY 参数至ContentResolver。

Kotlin

val externalContentUri = MediaStore.Files.getContentUri("external")

val mediaColumns = arrayOf(
   FileColumns._ID,
   FileColumns.DISPLAY_NAME,
   FileColumns.MIME_TYPE,
)

val queryArgs = bundleOf(
   // Return only items from the last selection (selected photos access)
   QUERY_ARG_LATEST_SELECTION_ONLY to true,
   // Sort returned items chronologically based on when they were added to the device's storage
   QUERY_ARG_SQL_SORT_ORDER to "${FileColumns.DATE_ADDED} DESC",
   QUERY_ARG_SQL_SELECTION to "${FileColumns.MEDIA_TYPE} = ? OR ${FileColumns.MEDIA_TYPE} = ?",
   QUERY_ARG_SQL_SELECTION_ARGS to arrayOf(
       FileColumns.MEDIA_TYPE_IMAGE.toString(),
       FileColumns.MEDIA_TYPE_VIDEO.toString()
   )
)

Java

Uri externalContentUri = MediaStore.Files.getContentUri("external");

String[] mediaColumns = {
    FileColumns._ID,
    FileColumns.DISPLAY_NAME,
    FileColumns.MIME_TYPE
};

Bundle queryArgs = new Bundle();
queryArgs.putBoolean(MediaStore.QUERY_ARG_LATEST_SELECTION_ONLY, true);
queryArgs.putString(MediaStore.QUERY_ARG_SQL_SORT_ORDER, FileColumns.DATE_ADDED + " DESC");
queryArgs.putString(MediaStore.QUERY_ARG_SQL_SELECTION, FileColumns.MEDIA_TYPE + " = ? OR " + FileColumns.MEDIA_TYPE + " = ?");
queryArgs.putStringArray(MediaStore.QUERY_ARG_SQL_SELECTION_ARGS, new String[] {
    String.valueOf(FileColumns.MEDIA_TYPE_IMAGE),
    String.valueOf(FileColumns.MEDIA_TYPE_VIDEO)
});

Sandbox de privacidade no Android

O Android 15 inclui as extensões mais recentes dos Serviços de publicidade do Android, incorporando a versão mais recente do Sandbox de privacidade do Android. Essa adição faz parte do nosso trabalho para desenvolver novas tecnologias que melhoram a privacidade do usuário e permitem experiências de publicidade personalizadas e eficazes em apps para dispositivos móveis. Nossa página do Sandbox de privacidade tem mais informações sobre a prévia para desenvolvedores e os programas Beta do Sandbox de privacidade do Android para ajudar você a começar.

Conexão Saúde

O Android 15 integra as extensões mais recentes A Conexão Saúde do Android, uma plataforma segura e centralizada para gerenciar e compartilhar dados de saúde e condicionamento físico coletados pelo app. Esta atualização adiciona suporte a outros tipos de dados em fitness; nutrição, temperatura da pele, planos de treino e muito mais.

O monitoramento de temperatura da pele permite que os usuários armazenem e compartilhem de forma mais precisa dados de temperatura de um wearable ou outro dispositivo de monitoramento.

Os planos de treinamento são planos de treino estruturados para ajudar o usuário a alcançar os objetivos de condicionamento físico. O suporte a planos de treinamento inclui vários objetivos de conclusão e performance:

Metas de conclusão em torno de calorias queimadas, distância, duração, repetição e passos.
Metas de desempenho de o máximo de repetições possível (AMRAP), cadência, frequência cardíaca, potência, taxa de esforço percebida e velocidade.

Saiba mais sobre as atualizações mais recentes do Conexão Saúde no Android na palestra Como criar experiências adaptáveis com o Android Health do Google I/O.

O Android 15 oferece suporte ao compartilhamento de tela parcial para que os usuários possam compartilhar ou gravar apenas uma janela de app em vez de toda a tela do dispositivo. Esse recurso, ativado pela primeira vez no Android 14 QPR2, inclui callbacks MediaProjection que permitem que seu app personalize a experiência de compartilhamento parcial de tela. Para aplicativos que segmentam O Android 14 (nível 34 da API) ou versões mais recentes, o consentimento do usuário é obrigatório para cada Sessão de captura do MediaProjection.

Experiência do usuário e interface do sistema

O Android 15 oferece aos desenvolvedores de apps e usuários mais controle e flexibilidade para configurar o dispositivo para atender às necessidades deles.

Para saber mais sobre como usar as melhorias mais recentes do Android 15 para melhorar a experiência do usuário no seu app, consulte a palestra Melhorar a experiência do usuário no app Android do Google I/O.

Visualizações de widgets mais completas com a API Generated Previews

在 Android 15 之前，提供微件选择器预览的唯一方法是指定静态图片或布局资源。这些预览通常与放置在主屏幕上的实际 widget 的外观大不相同。此外，由于无法使用 Jetpack Glance 创建静态资源，因此“资讯一览” 开发者必须为其微件截屏或创建 XML 布局，微件预览。

Android 15 添加了对生成的预览的支持。这意味着，应用微件提供程序可以生成 RemoteViews 以用作选择器预览，而不是静态资源。

应用可以向微件选择器提供远程视图，更新选择器中的内容，使其更能代表用户的内容看到的内容。

推送 API

应用可以通过推送 API 提供生成的预览。应用可以提供预览，并且不会收到明确的请求，以提供预览。预览会保留在 AppWidgetService 中，并且主持人可以按需请求预览。以下示例加载了一个 XML 微件并将其设置为预览：

AppWidgetManager.getInstance(appContext).setWidgetPreview(
   ComponentName(
       appContext,
       SociaLiteAppWidgetReceiver::class.java
   ),
   AppWidgetProviderInfo.WIDGET_CATEGORY_HOME_SCREEN,
   RemoteViews("com.example", R.layout.widget_preview)
)

预期的流程如下：

任何时候，widget 提供程序都会调用 setWidgetPreview。提供的预览会与其他提供方信息一起保留在 AppWidgetService 中。
setWidgetPreview 会通过 AppWidgetHost.onProvidersChanged 回调。作为回应，微件宿主会重新加载其所有提供方信息。
显示微件预览时，主机会检查 AppWidgetProviderInfo.generatedPreviewCategories，如果所选类别可用，则调用 AppWidgetManager.getWidgetPreview 以返回此提供程序的已保存预览。

何时调用 `setWidgetPreview`

由于没有用于提供预览的回调，因此应用可以选择在运行期间的任何时间发送预览。预览的更新频率取决于微件的用例。

以下列表介绍了两大类预览用例：

在 widget 预览中显示真实数据（例如个性化数据）的提供程序或最新信息。这些提供商可以设置预览已登录 Google 账号或已在其应用中完成初始配置。之后可以设置一项定期任务，按照所选的节奏更新预览。此类 widget 的示例包括照片、日历、天气或新闻 widget。
在预览中显示静态信息或不显示任何数据的快捷操作 widget 的提供程序。这些提供程序可以在应用首次启动时设置预览一次。例如，快速开车便是此类微件的示例操作 widget 或 Chrome 快捷方式 widget。

某些提供商可能会在基座接入模式选择器上显示静态预览，但真实的信息。这些提供商应遵循指南设置预览

Picture-in-picture

Android 15 引入了画中画 (PiP) 方面的变更，确保实现更流畅的过渡效果。对于在主界面上叠加界面元素的应用，这将非常有用，因为这些界面元素会进入 PiP。

开发者使用 onPictureInPictureModeChanged 回调来定义逻辑用于切换叠加界面元素的可见性。此回调是在画中画进入或退出动画播放完毕时触发。距离开始还有 Android 15 中，PictureInPictureUiState 类包含另一种状态。

在此界面状态下，以 Android 15（API 级别 35）为目标平台的应用将遵守使用以下参数调用 Activity#onPictureInPictureUiStateChanged 回调： isTransitioningToPip()。还有在画中画模式下，有很多与应用无关的界面元素，包含建议、评分和标题当应用进入画中画模式时，请使用 onPictureInPictureUiStateChanged 回调以隐藏这些界面元素。当应用从画中画窗口进入全屏模式，使用 onPictureInPictureModeChanged 回调以取消隐藏这些元素，如请参阅以下示例：

override fun onPictureInPictureUiStateChanged(pipState: PictureInPictureUiState) {
        if (pipState.isTransitioningToPip()) {
          // Hide UI elements
        }
    }

override fun onPictureInPictureModeChanged(isInPictureInPictureMode: Boolean) {
        if (isInPictureInPictureMode) {
          // Unhide UI elements
        }
    }

不相关界面元素的快速可见性切换（适用于画中画窗口）有助于确保画中画播放动画更流畅、无闪烁。

Regras aprimoradas do "Não perturbe"

O AutomaticZenRule permite que os apps personalizem a atenção de gerenciamento (Não perturbe) e decida quando ativar ou desativar para resolvê-los com rapidez. O Android 15 aprimora essas regras de forma significativa, com o objetivo de melhorar a experiência do usuário. As seguintes melhorias estão incluídas:

Adição de tipos a AutomaticZenRule, permitindo que o sistema aplique um tratamento especial a algumas regras.
Adição de um ícone à AutomaticZenRule, ajudando a tornar os modos mais reconhecíveis.
Adicionar uma string triggerDescription a AutomaticZenRule que descreve as condições em que a regra deve ficar ativa para o usuário.
Adicionado ZenDeviceEffects para AutomaticZenRule, permitindo que as regras acionem elementos como escala de cinza tela, modo noturno ou esmaecer o plano de fundo.

Definir VibrationEffect para canais de notificação

O Android 15 oferece suporte à configuração de vibrações avançadas para notificações recebidas canal usando NotificationChannel.setVibrationEffect, então os usuários podem distinguir entre diferentes tipos de notificação sem sem olhar para o dispositivo.

Telas e formatos grandes

O Android 15 oferece aos apps suporte para aproveitar ao máximo os formatos do Android, incluindo telas grandes, flippables e dobráveis.

Multitarefas aprimoradas em telas grandes

Os usuários podem salvar suas combinações favoritas de apps para tela dividida para
acesso rápido

O Android 15 oferece aos usuários maneiras melhores de realizar várias tarefas em dispositivos de tela grande. Por exemplo, os usuários podem salvar as combinações de apps favoritos na tela dividida para acesso rápido e fixar a barra de tarefas na tela para alternar rapidamente entre os apps. Isso significa que garantir que seu app seja adaptável é mais importante do que nunca.

O Google I/O tem sessões sobre Como criar versões adaptáveis para Android apps e Como criar uma interface com o Material Design 3 biblioteca adaptável isso pode ajudar, e nossa documentação tem mais informações para ajudar você a criar para projetos de telas.

Capa de suporte para tela

O app pode declarar uma propriedade que o Android 15 usa para permitir que Application ou Activity sejam apresentados nas pequenas telas de capa de dispositivos flexíveis com suporte. Essas telas são muito pequenas para serem consideradas como destinos compatíveis com a execução de apps Android, mas seu app pode oferecer suporte a elas, disponibilizando o app em mais lugares.

Conectividade

O Android 15 atualiza a plataforma para oferecer ao app acesso aos avanços mais recentes em comunicação e tecnologias sem fio.

Suporte a satélite

O Android 15 continua a ampliar o suporte à plataforma para conectividade por satélite e inclui alguns elementos de IU para garantir uma experiência do usuário consistente em todo o de conectividade por satélite.

Os apps podem usar o ServiceState.isUsingNonTerrestrialNetwork() para detectam quando um dispositivo está conectado a um satélite, o que aumenta o reconhecimento por que serviços de rede completos podem estar indisponíveis. Além disso, o Android 15 oferece suporte a apps de SMS e MMS, bem como apps RCS pré-carregados para usar a conectividade por satélite para enviar e receber mensagens.

Uma notificação aparece quando o dispositivo se conecta a um satélite.

Experiências NFC mais suaves

O Android 15 está trabalhando para tornar a experiência de pagamento por aproximação mais simples e confiável, mantendo o suporte ao robusto ecossistema de apps NFC do Android. Em dispositivos com suporte, os apps podem solicitar que o NfcAdapter entre no modo de observação, em que o dispositivo ouve, mas não responde aos leitores de NFC, enviando os PollingFrame objetos do serviço NFC do app para o processamento. Os objetos PollingFrame podem ser usados para autenticação antes da primeira comunicação com o leitor de NFC, permitindo uma transação de um toque em muitos casos.

Além disso, os apps agora podem registrar um filtro em dispositivos compatíveis para que possam ser notificados sobre a atividade de loop de pesquisa, o que permite uma operação tranquila com vários aplicativos com reconhecimento de NFC.

Função da Carteira

O Android 15 introduz um novo papel da Carteira que permite uma maior integração com o app de carteira preferido do usuário. Esse papel substitui a configuração de pagamento por aproximação padrão da NFC. Os usuários podem gerenciar o titular da função da Carteira acessando Configurações > Apps > Aplicativos padrão.

O papel "Carteira" é usado ao rotear toques em NFC para AIDs registrados na categoria de pagamento. Os toques sempre vão para o titular da função "Carteira", a menos que outro app registrado para o mesmo AID esteja em execução em primeiro plano.

Esse papel também é usado para determinar onde o bloco QuickAccess da Carteira precisa ficar quando ativado. Quando o papel está definido como "Nenhum", o bloco QuickAccess não fica disponível e os toques NFC da categoria de pagamento são entregues apenas ao app em primeiro plano.

Segurança

O Android 15 ajuda você a reforçar a segurança do app, proteger os dados dele e oferecer aos usuários mais transparência e controle sobre os próprios dados. Consulte a palestra Como proteger a segurança do usuário no Android do Google I/O para saber mais sobre o que estamos fazendo para melhorar a proteção do usuário e proteger seu app contra novas ameaças.

Integrar o Gerenciador de credenciais ao preenchimento automático

Starting with Android 15, developers can link specific views like username or password fields with Credential Manager requests, making it easier to provide a tailored user experience during the sign-in process. When the user focuses on one of these views, a corresponding request is sent to Credential Manager. The resulting credentials are aggregated across providers and displayed in autofill fallback UIs, such as inline suggestions or drop-down suggestions. The Jetpack androidx.credentials library is the preferred endpoint for developers to use and will soon be available to further enhance this feature in Android 15 and higher.

Integrar a inscrição por toque único e login com solicitações biométricas

O Gerenciador de credenciais integra solicitações biométricas aos processos de criação e login de credenciais, eliminando a necessidade de os provedores gerenciarem solicitações biométricas. Como resultado, os provedores de credenciais só precisam se concentrar no dos fluxos "create" e "get", ampliados pelo resultado do fluxo biométrico. Esse processo simplificado cria uma credencial mais eficiente e simplificada o processo de criação e recuperação.

Gerenciamento de chaves para criptografia de ponta a ponta

Apresentamos o E2eeContactKeysManager no Android 15, que facilita a criptografia de ponta a ponta (E2EE) nos seus apps Android, fornecendo uma API no nível do SO para o armazenamento de chaves públicas criptográficas.

O E2eeContactKeysManager foi projetado para integração com o app de contatos da plataforma para oferecer aos usuários uma maneira centralizada de gerenciar e verificar as chaves públicas dos contatos.

Verificações de permissão em URIs de conteúdo

O Android 15 introduz um novo conjunto de APIs que realizam verificações de permissão em URIs de conteúdo:

Context.checkContentUriPermissionFull: executa uma verificação de permissão completa em URIs de conteúdo.
Atributo de manifesto Activity requireContentUriPermissionFromCaller: aplica permissões especificadas nos URIs de conteúdo fornecidos na inicialização da atividade.
Classe ComponentCaller para autores de chamadas Activity: representa o app que iniciou a atividade.

Acessibilidade

O Android 15 adiciona recursos que melhoram a acessibilidade para os usuários.

Melhor braille

No Android 15, agora é possível para o TalkBack oferecer suporte a telas em braille que usam o padrão HID por USB e Bluetooth seguro.

Esse padrão, muito parecido com o usado por mouses e teclados, vai ajudar o Android a oferecer suporte a uma maior variedade de telas em braille com o tempo.

Internacionalização

O Android 15 adiciona recursos e funcionalidades que complementam a experiência do usuário quando um dispositivo é usado em idiomas diferentes.

Fonte da variável CJK

No Android 15 e versões mais recentes, o arquivo de fontes para os idiomas chinês, japonês e coreano (CJK), NotoSansCJK, agora é uma fonte variável. Fontes variáveis abrem novas possibilidades para tipografia criativa em idiomas CJK. Os designers podem explorar uma variedade mais ampla de estilos e criar layouts visualmente incríveis que anteriormente eram difíceis ou impossíveis de alcançar.

Como a fonte variável para os idiomas chinês, japonês e coreano (CJK) aparece com diferentes larguras de fonte.

Justificativa entre caracteres

No Android 15 e versões mais recentes, o texto pode ser justificado usando o espaçamento entre letras usando JUSTIFICATION_MODE_INTER_CHARACTER. A justificação entre palavras foi introduzida pela primeira vez no Android 8.0 (nível 26 da API), e a justificação entre caracteres oferece recursos semelhantes para idiomas que usam o caractere de espaço em branco para segmentação, como chinês, japonês e outros.

Layout para texto em japonês usando JUSTIFICATION_MODE_NONE.

Layout para texto em inglês usando JUSTIFICATION_MODE_NONE.

Layout para texto em japonês usando JUSTIFICATION_MODE_INTER_WORD.

Layout para texto em inglês usando JUSTIFICATION_MODE_INTER_WORD.

Layout para texto em japonês usando JUSTIFICATION_MODE_INTER_CHARACTER.

Layout para texto em inglês usando JUSTIFICATION_MODE_INTER_CHARACTER.

Configuração automática de quebra de linha

O Android passou a oferecer suporte a quebras de linha baseadas em frases em japonês e coreano em Android 13 (nível 33 da API). No entanto, embora as quebras de linha baseadas em frase melhorem legibilidade de linhas de texto curtas, eles não funcionam bem para linhas de texto longas. No Android 15, os apps só podem aplicar quebras de linha baseadas em frases para linhas curtas de texto usando o método LINE_BREAK_WORD_STYLE_AUTO é a melhor opção. Essa opção seleciona a melhor opção de estilo de palavra para o texto.

Para linhas de texto curtas, são usadas quebras de linha baseadas em frases, funcionando da mesma como LINE_BREAK_WORD_STYLE_PHRASE, conforme mostrado no imagem a seguir:

Para linhas de texto curtas, `LINE_BREAK_WORD_STYLE_AUTO` aplica quebras de linha baseadas em frases para melhorar a legibilidade do texto. Isso é o mesmo que aplicar `LINE_BREAK_WORD_STYLE_PHRASE`.

Para linhas de texto mais longas, LINE_BREAK_WORD_STYLE_AUTO usa um "no" estilo de palavra com quebra de linha, funcionando da mesma forma LINE_BREAK_WORD_STYLE_NONE, conforme mostrado no imagem a seguir:

Para linhas de texto longas, `LINE_BREAK_WORD_STYLE_AUTO` não aplica estilo de palavra com quebra de linha para melhorar a legibilidade do texto. Isso é o mesmo que aplicar `LINE_BREAK_WORD_STYLE_NONE`.

Nova fonte japonesa Hentaigana

No Android 15, um arquivo de fonte do antigo hiragana japonês (conhecido como hentaigana) é empacotado por padrão. As formas únicas dos caracteres de Hentaigana podem adicionar um toque distinto a obras de arte ou designs, além de ajudar a preservar a transmissão e o entendimento precisos de documentos japoneses antigos.

Estilo de caracteres e texto da hentaigana japonesa fonte.

Cone de VideoLAN Copyright (c) 1996-2010 VideoLAN. Esse logotipo ou uma versão modificada pode ser usado ou modificado por qualquer pessoa para se referir ao projeto VideoLAN ou qualquer produto desenvolvido pela equipe da VideoLAN, mas não indica endosso pelo projeto.

A Vulkan e o logotipo da Vulkan são marcas registradas da Khronos Group Inc.

OpenGL é uma marca registrada, e o logotipo OpenGL ES é uma marca registrada da Hewlett Packard Enterprise usada com permissão da Khronos.

Visão geral de recursos e APIs

Câmera e mídia

Intensificação de pouca luz

Controles de câmera no app

Controle de margem de HDR

Controle do volume

Dispositivos MIDI virtual 2.0

Decodificação de software AV1 mais eficiente

Produtividade e ferramentas para desenvolvedores

Atualizações do OpenJDK 17

Melhorias no PDF

Refinamentos automáticos da troca de idioma

API OpenType Variable Font aprimorada

Kotlin

Java

Kotlin

Java

Controles granulares de quebra de linha

Arquivamento de apps

Gráficos

Como modernizar o acesso a GPUs do Android

O Android ANGLE no roteiro Vulkan

Próximas etapas recomendadas

Melhorias no Canvas

Performance e bateria

API ApplicationStartInfo

Informações detalhadas sobre o tamanho do app

Criação de perfil gerenciada pelo app

Melhorias no banco de dados SQLite

Atualizações do Android Dynamic Performance Framework

Privacidade

Detecção de gravação de tela

Recursos expandidos de IntentFilter

Espaço privado

Consultar a seleção de usuário mais recente para acessar as fotos selecionadas

Kotlin

Java

Sandbox de privacidade no Android

Conexão Saúde

Compartilhamento de tela parcial

Experiência do usuário e interface do sistema

Visualizações de widgets mais completas com a API Generated Previews

推送 API

何时调用 setWidgetPreview

Picture-in-picture

Regras aprimoradas do "Não perturbe"

Definir VibrationEffect para canais de notificação

Telas e formatos grandes

Multitarefas aprimoradas em telas grandes

Capa de suporte para tela

Conectividade

Suporte a satélite

Experiências NFC mais suaves

Função da Carteira

Segurança

Integrar o Gerenciador de credenciais ao preenchimento automático

Integrar a inscrição por toque único e login com solicitações biométricas

Gerenciamento de chaves para criptografia de ponta a ponta

Verificações de permissão em URIs de conteúdo

Acessibilidade

Melhor braille

Internacionalização

Fonte da variável CJK

Justificativa entre caracteres

Configuração automática de quebra de linha

Nova fonte japonesa Hentaigana

何时调用 `setWidgetPreview`