The Android 16 Beta is now available. Try it out today and let us know what you think!

Esta página foi traduzida pela API Cloud Translation.

Visão geral de recursos e APIs
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

O Android 15 apresenta ótimos recursos e APIs 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 adicionadas, modificadas e removidas, leia o Relatório de diferenças da API. Para saber mais sobre as APIs adicionadas, acesse a Referência da API do Android. No Android 15, procure as APIs que foram adicionadas no nível 35 da API. Para saber mais sobre as áreas em que as mudanças na plataforma podem afetar seus apps, confira as mudanças de comportamento do Android 15 para apps destinados ao Android 15 e para todos os apps.

Câmera e mídia

O Android 15 inclui vários recursos que melhoram a experiência de câmera e mídia e oferecem acesso a ferramentas e hardware para ajudar os criadores de conteúdo a dar vida às ideias no Android.

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

Aumento do modo pouca luz

Android 15 introduces Low Light Boost, an auto-exposure mode available to both Camera 2 and the night mode camera extension. Low Light Boost adjusts the exposure of the Preview stream in low-light conditions. This is different from how the night mode camera extension creates still images, because night mode combines a burst of photos to create a single, enhanced image. While night mode works very well for creating a still image, it can't create a continuous stream of frames, but Low Light Boost can. Thus, Low Light Boost enables camera capabilities, such as:

Providing an enhanced image preview, so users are better able to frame their low-light pictures
Scanning QR codes in low light

If you enable Low Light Boost, it automatically turns on when there's a low light level, and turns off when there's more light.

Apps can record off the Preview stream in low-light conditions to save a brightened video.

For more information, see Low Light Boost.

Controles da câmera no app

Android 15 adds an extension for more control over the camera hardware and its algorithms on supported devices:

Advanced flash strength adjustments enabling precise control of flash intensity in both SINGLE and TORCH modes while capturing images.

Controle de headroom de HDR

O Android 15 escolhe o headroom HDR apropriado para os recursos do dispositivo e a profundidade de bits do painel. Para páginas com muito conteúdo SDR, como um app de mensagens que mostra uma única miniatura HDR, esse comportamento pode acabar influenciando negativamente o brilho percebido do conteúdo SDR. O Android 15 permite controlar o headroom HDR com setDesiredHdrHeadroom para encontrar um equilíbrio entre conteúdo SDR e HDR.

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

Controle de loudness

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 2.0 virtuais

Android 13 added support for connecting to MIDI 2.0 devices using USB, which communicate using Universal MIDI Packets (UMP). Android 15 extends UMP support to virtual MIDI apps, enabling composition apps to control synthesizer apps as a virtual MIDI 2.0 device just like they would with an USB MIDI 2.0 device.

Decodificação de software AV1 mais eficiente

Logotipo da dav1d

dav1d, o popular decodificador de software AV1 da VideoLAN, está disponível para dispositivos Android que não oferecem suporte à decodificação AV1 em hardware. O dav1d tem até três vezes mais desempenho do que o decodificador de software AV1 herdado, permitindo a reprodução de AV1 em alta definição para mais usuários, incluindo alguns dispositivos de nível baixo e médio.

O app precisa ativar o uso do dav1d invocando-o pelo nome "c2.android.av1-dav1d.decoder". O dav1d vai se tornar o decodificador de software AV1 padrão em uma atualização subsequente. Esse suporte é padronizado e tem 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 se concentre em ferramentas como Android Studio, Jetpack Compose e as bibliotecas do Android Jetpack, sempre procuramos maneiras de ajudar você a realizar sua visão.

Atualizações do OpenJDK 17

O Android 15 continua atualizando as principais bibliotecas 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 buffers NIO
Streams
Outros métodos math e strictmath
Atualizações de pacote util, incluindo collection, map e set sequenciais
Suporte a ByteBuffer no Deflater
Atualizações de segurança, como X500PrivateCredential e 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 usando as atualizações do sistema do Google Play. Assim, você pode direcionar os recursos de programação mais recentes.

Melhorias em PDFs

Android 15 includes substantial improvements to the PdfRenderer APIs. Apps can incorporate advanced features such as rendering password-protected files, annotations, form editing, searching, and selection with copy. Linearized PDF optimizations are supported to speed local PDF viewing and reduce resource use. The Jetpack PDF library uses these APIs to simplify adding PDF viewing capabilities to your app.

The latest updates to PDF rendering include features such as searching an embedded PDF file.

The PdfRenderer has been moved to a module that can be updated using Google Play system updates independent of the platform release, and we're supporting these changes back to Android 11 (API level 30) by creating a compatible pre-Android 15 version of the API surface, called PdfRendererPreV.

Aprimoramentos da troca automática de idioma

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

API de fonte variável OpenType melhorada

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

Starting in Android 15, a TextView and the underlying line breaker can preserve the given portion of text in the same line to improve readability. You can take advantage of this line break customization by using the <nobreak> tag in string resources or createNoBreakSpan. Similarly, you can preserve words from hyphenation by using the <nohyphen> tag or createNoHyphenationSpan.

For example, the following string resource doesn't include a line break, and renders with the text "Pixel 8 Pro." breaking in an undesirable place:

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

In contrast, this string resource includes the <nobreak> tag, which wraps the phrase "Pixel 8 Pro." and prevents line breaks:

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

The difference in how these strings are rendered is shown in the following images:

Layout for a line of text where the phrase "Pixel 8 Pro." isn't wrapped using a <nobreak> tag.

Layout for the same line of text where the phrase "Pixel 8 Pro." is wrapped using a <nobreak> tag.

Arquivamento de apps

Android and Google Play announced support for app archiving last year, allowing users to free up space by partially removing infrequently used apps from the device that were published using Android App Bundle on Google Play. Android 15 includes OS level support for app archiving and unarchiving, making it easier for all app stores to implement it.

Apps with the REQUEST_DELETE_PACKAGES permission can call the PackageInstaller requestArchive method to request archiving an installed app package, which removes the APK and any cached files, but persists user data. Archived apps are returned as displayable apps through the LauncherApps APIs; users will see a UI treatment to highlight that those apps are archived. If a user taps on an archived app, the responsible installer will get a request to unarchive it, and the restoration process can be monitored by the ACTION_PACKAGE_ADDED broadcast.

Enable 16 KB mode on a device using developer options

Toggle the Boot with 16KB page size developer option to boot a device in 16 KB mode.

Starting with Android 15 QPR1, you can use the developer option that's available on certain devices to boot the device in 16 KB mode and perform on-device testing.

This developer option is available on the following devices:

Pixel 8 and 8 Pro (with Android 15 QPR1 or higher)

Warning: Due to a known issue with Android 15 QPR2 Beta 3, the touchscreen doesn't work on Pixel 8 devices after installing Android 15 QPR2 Beta 3 and booting the device in 16 KB mode. This issue doesn't affect Pixel 8 Pro devices.
Pixel 8a (with Android 15 QPR1 or higher)

Warning: Due to a known issue with Android 15 QPR2 Beta 3, the touchscreen doesn't work on Pixel 8a devices after installing Android 15 QPR2 Beta 3 and booting the device in 16 KB mode.
Pixel 9, 9 Pro, and 9 Pro XL (with Android 15 QPR2 Beta 2 or higher)

Gráficos

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

Modernização do acesso à GPU do Android

Logotipo do Vulkan

O hardware do Android evoluiu bastante desde os primeiros dias, quando o SO principal era executado em uma única CPU e as GPUs eram acessadas usando APIs baseadas 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 mais baixo que reflete melhor o hardware de GPU moderno, dimensiona melhor para oferecer suporte a vários núcleos de CPU e oferece uma sobrecarga reduzida do driver de CPU, o que resulta em um melhor desempenho do app. O Vulkan é compatível com todos os mecanismos de jogo modernos.

O Vulkan é a interface preferida do Android para a GPU. Portanto, o Android 15 inclui o ANGLE como uma camada opcional para executar o OpenGL® ES em cima do Vulkan. A mudança para o ANGLE padroniza a implementação do OpenGL do Android para melhorar a compatibilidade e, em alguns casos, o desempenho. Para testar a estabilidade e o desempenho do app OpenGL ES com o ANGLE, ative a opção do desenvolvedor em Configurações -> Sistema -> Opções do desenvolvedor -> Experimental: Ativar ANGLE no Android 15.

Planejamento do ANGLE no Vulkan para Android

Roteiro de mudanças futuras nas APIs de GPU do Android.

Como parte do aperfeiçoamento da pilha de GPU, vamos enviar o ANGLE como o driver do sistema GL em mais dispositivos novos, com a expectativa de que o OpenGL/ES só estará disponível pelo ANGLE. No entanto, planejamos continuar oferecendo suporte ao OpenGL ES em todos os dispositivos.

Próximas etapas recomendadas

Use as opções para desenvolvedores 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

Android 15 continues our modernization of Android's Canvas graphics system with additional capabilities:

Matrix44 provides a 4x4 matrix for transforming coordinates that should be used when you want to manipulate the canvas in 3D.
clipShader intersects the current clip with the specified shader, while clipOutShader sets the clip to the difference of the current clip and the shader, each treating the shader as an alpha mask. This supports the drawing of complex shapes efficiently.

Desempenho e bateria

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

Para conferir as práticas recomendadas de eficiência da bateria, a depuração de rede e o uso de energia, além de detalhes sobre como estamos melhorando a eficiência da bateria do trabalho em segundo plano no Android 15 e nas versões mais recentes do Android, consulte a palestra Como melhorar a eficiência da bateria do trabalho em segundo plano no Android do 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 app se ele foi iniciado a partir de um estado frio, quente ou aquecido. Também era difícil saber quanto tempo o app levava durante as várias fases de inicialização: bifurcar o processo, chamar onCreate, desenhar o primeiro frame e muito mais. Quando a classe Application foi instanciada, você não tinha como saber se o app foi iniciado por uma transmissão, um provedor de conteúdo, um job, um backup, a inicialização completa, 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 ajudar a otimizar diretamente a inicialização do app. Por exemplo, é possível eliminar a instanciação cara de bibliotecas relacionadas à interface na classe Application quando o app está sendo inicializado 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 é a soma do tamanho do APK, do tamanho dos arquivos extraídos do APK e dos arquivos gerados no dispositivo, como o código compilado antecipadamente (AOT). Esse número não é muito útil para entender como o app está usando o armazenamento.

O Android 15 adiciona a API StorageStats.getAppBytesByDataType([type]), que permite que você saiba como o app está usando todo esse espaço, incluindo divisões de arquivo APK, código relacionado ao AOT e à aceleração, metadados 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 perfil do app, como despejos de heap, perfis de heap, amostragem de pilha 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 a limitação de taxa para minimizar o impacto no desempenho.

Para simplificar a criação de solicitações de criação de perfil no seu app, recomendamos usar a API AndroidX Profiling correspondente, disponível no Core 1.15.0-rc01 ou mais recente.

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

Android 15 continues our investment in the Android Dynamic Performance Framework (ADPF), a set of APIs that allow games and performance intensive apps to interact more directly with power and thermal systems of Android devices. On supported devices, Android 15 adds ADPF capabilities:

A power-efficiency mode for hint sessions to indicate that their associated threads should prefer power saving over performance, great for long-running background workloads.
GPU and CPU work durations can both be reported in hint sessions, allowing the system to adjust CPU and GPU frequencies together to best meet workload demands.
Thermal headroom thresholds to interpret possible thermal throttling status based on headroom prediction.

To learn more about how to use ADPF in your apps and games, head over to the documentation.

Privacidade

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

Detecção de gravação de tela

O Android 15 adiciona suporte a apps para detectar isso. elas estão sendo gravadas. Um callback é invocado sempre que o app faz a transição. entre ficar visível ou invisível em uma gravação de tela. Um app é consideradas visíveis se as atividades pertencentes ao UID do processo de registro forem que está sendo gravado. Dessa forma, se o app estiver executando uma operação sensível, você informar ao usuário que a gravação está sendo feita.

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 do 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 regras de correspondência de Intent que precisam ser satisfeitas, incluindo parâmetros de consulta de URL, fragmentos de 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" />
  <category android:name="android.intent.category.DEFAULT" />
  <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

The private space can be unlocked and locked to show or hide sensitive apps on a device.

Private space lets users create a separate space on their device where they can keep sensitive apps away from prying eyes, under an additional layer of authentication. The private space uses a separate user profile. The user can choose to use the device lock or a separate lock factor for the private space.

Apps in the private space show up in a separate container in the launcher, and are hidden from the recents view, notifications, settings, and from other apps when the private space is locked. User-generated and downloaded content (such as media or files) and accounts are separated between the private space and the main space. The system sharesheet and the photo picker can be used to give apps access to content across spaces when the private space is unlocked.

Users can't move existing apps and their data into the private space. Instead, users select an install option in the private space to install an app using whichever app store they prefer. Apps in the private space are installed as separate copies from any apps in the main space (new copies of the same app).

When a user locks the private space, the profile is stopped. While the profile is stopped, apps in the private space are no longer active and can't perform foreground or background activities, including showing notifications.

We recommend that you test your app with private space to make sure your app works as expected, especially if your app falls into one of the following categories:

Apps with logic for work profiles that assumes that any installed copies of their app that aren't in the main profile are in the work profile.
Medical apps
Launcher apps
App store apps

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

Apps can now highlight only the most-recently-selected photos and videos when partial access to media permissions is granted. This feature can improve the user experience for apps that frequently request access to photos and videos. To use this feature in your app, enable the QUERY_ARG_LATEST_SELECTION_ONLY argument when querying MediaStore through 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

Android 15 includes the latest Android Ad Services extensions, incorporating the latest version of the Privacy Sandbox on Android. This addition is part of our work to develop technologies that improve user privacy and enable effective, personalized advertising experiences for mobile apps. Our privacy sandbox page has more information about the Privacy Sandbox on Android developer preview and beta programs to help you get started.

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.

Android 15 supports app screen sharing so users can share or record just an app window rather than the entire device screen. This feature, first enabled in Android 14 QPR2, includes MediaProjection callbacks that allow your app to customize the app screen sharing experience. Note that for apps targeting Android 14 (API level 34) or higher, user consent is required for each MediaProjection capture session.

Experiência do usuário e interface do sistema

O Android 15 oferece aos desenvolvedores e usuários de apps mais controle e flexibilidade para configurar o dispositivo de acordo com as necessidades.

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

Prévias de widgets mais ricas com a API Generated Previews

Antes do Android 15, a única maneira de fornecer visualizações do seletor de widgets era especificar um recurso de imagem ou layout estático. Essas visualizações geralmente são muito diferentes da aparência do widget real quando ele é colocado na tela inicial. Além disso, recursos estáticos não podem ser criados com o Jetpack Glance, então um Resumo o desenvolvedor teve que fazer uma captura de tela do widget ou criar um layout XML para ter um visualização do widget.

O Android 15 adiciona suporte a visualizações geradas. Isso significa que os provedores de widgets de apps podem gerar RemoteViews para usar como a visualização do seletor, em vez de um recurso estático.

Os apps podem fornecer visualizações remotas ao seletor de widgets para atualizar o conteúdo no seletor de forma que ele seja mais representativo do que o usuário vai ver.

API Push

Os apps podem fornecer visualizações geradas por uma API push. Os apps podem fornecer visualizações em qualquer ponto do ciclo de vida e não recebem uma solicitação explícita do host para fornecer visualizações. As prévias são mantidas em AppWidgetService, e os hosts podem solicitá-las sob demanda. O exemplo a seguir carrega um recurso de layout de widget XML e o define como a visualização:

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

O fluxo esperado é:

A qualquer momento, o provedor de widgets chama setWidgetPreview. O As visualizações são mantidas em AppWidgetService com outras informações do provedor.
O setWidgetPreview notifica os hosts de uma visualização atualizada pelo callback AppWidgetHost.onProvidersChanged. Em resposta, o widget host recarrega todas as informações do provedor.
Ao mostrar uma visualização de widget, o host verifica AppWidgetProviderInfo.generatedPreviewCategories e, se a categoria escolhida estiver disponível, chama AppWidgetManager.getWidgetPreview para retornar a visualização salva para esse provedor.

Quando ligar para `setWidgetPreview`

Como não há callback para fornecer visualizações, os apps podem optar por enviar visualizações a qualquer momento durante a execução. A frequência de atualização da visualização depende do caso de uso do widget.

A lista a seguir descreve as duas principais categorias de casos de uso de visualização:

Provedores que mostram dados reais nas visualizações de widget, como informações personalizadas ou recentes. Esses provedores podem definir a visualização depois que o usuário faz login ou faz a configuração inicial no app. Depois disso, eles podem definir uma tarefa periódica para atualizar as visualizações na cadência escolhida. Exemplos desse tipo de widget podem ser um widget de fotos, de agenda, de clima ou de notícias.
Provedores que mostram informações estáticas em visualizações ou widgets de ação rápida que não exibem nenhum dado. Esses provedores podem definir as prévias uma vez, quando o app é iniciado pela primeira vez. Exemplos desse tipo de widget incluem um widget de ações rápidas do Drive ou um widget de atalhos do Chrome.

Alguns provedores podem mostrar visualizações estáticas no seletor de modo Hub, mas as informações no seletor da tela inicial. Esses provedores precisam seguir as orientações para definir as prévias nesses dois casos de uso.

Picture-in-picture

O Android 15 introduz mudanças no Picture-in-Picture (PiP), garantindo uma transição ainda mais suave ao entrar no modo PiP. Isso será benéfico para apps que têm elementos de interface sobrepostos à interface principal, que entra no PiP.

Os desenvolvedores usam o callback onPictureInPictureModeChanged para definir a lógica que alterna a visibilidade dos elementos da interface sobrepostos. Esse callback é acionado quando a animação de entrada ou saída do PiP é concluída. A partir do Android 15, a classe PictureInPictureUiState inclui outro estado.

Com esse estado da interface, os apps destinados ao Android 15 (nível 35 da API) vão observar o callback Activity#onPictureInPictureUiStateChanged sendo invocado com isTransitioningToPip() assim que a animação do picture-in-picture começar. Há muitos elementos da interface que não são relevantes para o app quando ele está no modo PiP, por exemplo, visualizações ou layouts que incluem informações como sugestões, próximos vídeos, classificações e títulos. Quando o app for para o modo picture-in-picture, use o callback onPictureInPictureUiStateChanged para ocultar esses elementos da interface. Quando o app entrar no modo de tela cheia na janela picture-in-picture, use o callback onPictureInPictureModeChanged para reexibir esses elementos, conforme mostrado nos exemplos a seguir:

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

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

Esse botão de alternância de visibilidade rápida de elementos de interface irrelevantes (para uma janela picture-in-picture) ajuda a garantir uma animação de entrada do PiP mais suave e sem cintilação.

Melhorias nas regras do modo "Não perturbe"

AutomaticZenRule lets apps customize Attention Management (Do Not Disturb) rules and decide when to activate or deactivate them. Android 15 greatly enhances these rules with the goal of improving the user experience. The following enhancements are included:

Adding types to AutomaticZenRule, allowing the system to apply special treatment to some rules.
Adding an icon to AutomaticZenRule, helping to make the modes be more recognizable.
Adding a triggerDescription string to AutomaticZenRule that describes the conditions on which the rule should become active for the user.
Added ZenDeviceEffects to AutomaticZenRule, allowing rules to trigger things like grayscale display, night mode, or dimming the wallpaper.

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.

Ícone da barra de status da projeção de mídia e parada automática

A projeção de mídia pode expor informações particulares do usuário. Um novo ícone de status de destaque na barra informa os usuários sobre qualquer projeção de tela em andamento. Os usuários podem tocar no chip para interromper a transmissão, o compartilhamento ou a gravação de tela. Além disso, para uma experiência do usuário mais intuitiva, qualquer projeção de tela em andamento agora é interrompida automaticamente quando a tela do dispositivo é bloqueada.

Status bar chip for screen sharing, casting, and recording.

Telas grandes e formatos

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

Mais facilidade para várias tarefas 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.

Suporte a tela de capa

O app pode declarar uma propriedade que o Android 15 usa para permitir que o Application ou o Activity seja apresentado nas telas de cobertura pequenas de dispositivos dobráveis compatíveis. Essas telas são muito pequenas para serem consideradas como destinos compatíveis para execução de apps Android, mas seu app pode ativar o suporte a elas, tornando-o disponível em mais lugares.

Conectividade

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

Suporte a satélite

Android 15 continues to extend platform support for satellite connectivity and includes some UI elements to ensure a consistent user experience across the satellite connectivity landscape.

Apps can use ServiceState.isUsingNonTerrestrialNetwork() to detect when a device is connected to a satellite, giving them more awareness of why full network services might be unavailable. Additionally, Android 15 provides support for SMS and MMS apps as well as preloaded RCS apps to use satellite connectivity for sending and receiving messages.

A notification appears when the device connects to a satellite.

Experiências de NFC mais suaves

O Android 15 está trabalhando para tornar a experiência de pagamento por aproximação mais simples e confiável, além de continuar oferecendo suporte ao ecossistema robusto 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 detecta, mas não responde aos leitores NFC, enviando os PollingFrame objetos do serviço NFC do app para processamento. Os objetos PollingFrame podem ser usados para autenticação antes da primeira comunicação com o leitor NFC, permitindo uma transação com um toque em muitos casos.

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

Função da Carteira

O Android 15 apresenta uma função de carteira que permite uma integração mais estreita com o app de carteira preferido do usuário. Essa função substitui a configuração de pagamento por aproximação padrão do NFC. Os usuários podem gerenciar o detentor de função da Carteira acessando Configurações > Apps > Apps padrão.

A função da Carteira é usada ao rotear toques NFC para AIDs registrados na categoria de pagamento. Os toques sempre vão para o detentor de função da 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 para onde o bloco de acesso rápido da Carteira precisa ir quando ativado. Quando o papel é definido como "Nenhum", o bloco "Acesso rápido" não está disponível, e os toques NFC da categoria de pagamento são enviados apenas para o app em primeiro plano.

Segurança

O Android 15 ajuda a melhorar a segurança do app, proteger os dados dele e oferecer aos usuários mais transparência e controle sobre os dados. Assista à palestra Proteção da segurança do usuário no Android (link em inglês) da Google I/O para saber mais sobre o que estamos fazendo para melhorar as proteções do usuário e proteger seu app contra novas ameaças.

Integrar o Gerenciador de credenciais ao preenchimento automático

A partir do Android 15, os desenvolvedores podem vincular visualizações específicas, como campos de nome de usuário ou senha, a solicitações do Gerenciador de credenciais, facilitando a criação de uma experiência personalizada do usuário durante o processo de login. Quando o usuário foca em uma dessas visualizações, uma solicitação correspondente é enviada ao Gerenciador de credenciais. As credenciais resultantes são agregadas entre os provedores e exibidas em interfaces padrão de preenchimento automático, como sugestões inline ou suspensas. A biblioteca androidx.credentials do Jetpack é o endpoint preferencial para desenvolvedores e em breve estará disponível para aprimorar ainda mais esse recurso no Android 15 e versões mais recentes.

Integrar o processo de login e a inscrição com um toque às solicitações biométricas

Credential Manager integrates biometric prompts into the credential creation and sign-in processes, eliminating the need for providers to manage biometric prompts. As a result, credential providers only need to focus on the results of the create and get flows, augmented with the biometric flow result. This simplified process creates a more efficient and streamlined credential creation and retrieval process.

Gerenciamento de chaves para criptografia de ponta a ponta

Estamos lançando o E2eeContactKeysManager no Android 15, que facilita a criptografia de ponta a ponta (E2EE, na sigla em inglês) 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 se integrar ao app de contatos da plataforma e 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 conjunto de APIs que executam verificações de permissão em URIs de conteúdo:

Context.checkContentUriPermissionFull: realiza uma verificação de permissão completa nos URIs de conteúdo.
Atributo de manifesto Activity requireContentUriPermissionFromCaller: aplica as permissões especificadas aos URIs de conteúdo fornecidos no início da atividade.
Classe ComponentCaller para autores de chamada 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, o TalkBack passou a oferecer suporte a telas em braille que usam o padrão HID por USB e Bluetooth seguro.

Esse padrão, semelhante ao usado por mouses e teclados, ajudará o Android a oferecer suporte a uma variedade maior de linhas braille ao longo do tempo.

Internacionalização

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

Fonte variável CJK

A partir do Android 15, o arquivo de fonte para idiomas chinês, japonês e coreano (CJK), NotoSansCJK, agora é uma fonte variável. As fontes variáveis oferecem possibilidades de tipografia criativa em idiomas CJK. Os designers podem explorar uma gama mais ampla de estilos e criar layouts visualmente atraentes que antes eram difíceis ou impossíveis de alcançar.

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

Justificação entre caracteres

Starting with Android 15, text can be justified utilizing letter spacing by using JUSTIFICATION_MODE_INTER_CHARACTER. Inter-word justification was first introduced in Android 8.0 (API level 26), and inter-character justification provides similar capabilities for languages that use the whitespace character for segmentation, such as Chinese, Japanese, and others.

Layout for Japanese text using JUSTIFICATION_MODE_NONE.

Layout for English text using JUSTIFICATION_MODE_NONE.

Layout for Japanese text using JUSTIFICATION_MODE_INTER_WORD.

Layout for English text using JUSTIFICATION_MODE_INTER_WORD.

Layout for Japanese text using the JUSTIFICATION_MODE_INTER_CHARACTER.

Layout for English text using the JUSTIFICATION_MODE_INTER_CHARACTER.

Configuração automática de quebra de linha

Android started supporting phrase-based line breaks for Japanese and Korean in Android 13 (API level 33). However, while phrase-based line breaks improve the readability of short lines of text, they don't work well for long lines of text. In Android 15, apps can apply phrase-based line breaks only for short lines of text, using the LINE_BREAK_WORD_STYLE_AUTO option. This option selects the best word style option for the text.

For short lines of text, phrase-based line breaks are used, functioning the same as LINE_BREAK_WORD_STYLE_PHRASE, as shown in the following image:

For short lines of text, `LINE_BREAK_WORD_STYLE_AUTO` applies phrase-based line breaks to improve the readability of the text. This is the same as applying `LINE_BREAK_WORD_STYLE_PHRASE`.

For longer lines of text, LINE_BREAK_WORD_STYLE_AUTO uses a no line-break word style, functioning the same as LINE_BREAK_WORD_STYLE_NONE, as shown in the following image:

For long lines of text, `LINE_BREAK_WORD_STYLE_AUTO` applies no line-break word style to improve the readability of the text. This is the same as applying `LINE_BREAK_WORD_STYLE_NONE`.

Fonte japonesa Hentaigana adicional

In Android 15, a font file for old Japanese Hiragana (known as Hentaigana) is bundled by default. The unique shapes of Hentaigana characters can add a distinctive flair to artwork or design while also helping to preserve accurate transmission and understanding of ancient Japanese documents.

Character and text style for the Japanese Hentaigana font.

Cone do 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 a qualquer produto desenvolvido pela equipe do VideoLAN, mas não indica endosso do projeto.

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

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

Visão geral de recursos e APIs Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Câmera e mídia

Aumento do modo pouca luz

Controles da câmera no app

Controle de headroom de HDR

Controle de loudness

Dispositivos MIDI 2.0 virtuais

Decodificação de software AV1 mais eficiente

Produtividade e ferramentas para desenvolvedores

Atualizações do OpenJDK 17

Melhorias em PDFs

Aprimoramentos da troca automática de idioma

API de fonte variável OpenType melhorada

Kotlin

Java

Kotlin

Java

Controles granulares de quebra de linha

Arquivamento de apps

Enable 16 KB mode on a device using developer options

Gráficos

Modernização do acesso à GPU do Android

Planejamento do ANGLE no Vulkan para Android

Próximas etapas recomendadas

Melhorias no Canvas

Desempenho 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 do IntentFilter

Espaço privado

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

Kotlin

Java

Sandbox de privacidade no Android

Conexão Saúde

Compartilhamento de tela de app

Experiência do usuário e interface do sistema

Prévias de widgets mais ricas com a API Generated Previews

API Push

Quando ligar para setWidgetPreview

Picture-in-picture

Melhorias nas regras do modo "Não perturbe"

Definir VibrationEffect para canais de notificação

Ícone da barra de status da projeção de mídia e parada automática

Telas grandes e formatos

Mais facilidade para várias tarefas em telas grandes

Suporte a tela de capa

Conectividade

Suporte a satélite

Experiências de NFC mais suaves

Função da Carteira

Segurança

Integrar o Gerenciador de credenciais ao preenchimento automático

Integrar o processo de login e a inscrição com um toque às 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 variável CJK

Justificação entre caracteres

Configuração automática de quebra de linha

Fonte japonesa Hentaigana adicional

Visão geral de recursos e APIs
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Quando ligar para `setWidgetPreview`