Visão geral de recursos e APIs

O Android 14 introduz ótimos recursos e APIs para desenvolvedores. As informações a seguir ajudam você a conhecer os recursos disponíveis para os apps e 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 conferir detalhes sobre as APIs adicionadas, acesse a Referência da API do Android. No Android 14, procure as APIs que foram adicionadas no nível 34 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 14 para apps destinados ao Android 14 e para todos os apps.

Internacionalização

Seleção de idioma por app

O Android 14 expande os recursos de linguagem por app lançados no Android 13 (API de nível 33) com estes recursos extras:

• Gerar automaticamente o localeConfig de um app: a partir do Android Studio Giraffe Canary 7 e do AGP 8.1.0-alpha07, é possível configurar seu app para oferecer suporte a seleção de idioma por app automaticamente. Com base nos recursos do projeto, o Plug-in do Android para Gradle gera o arquivo LocaleConfig e adiciona uma referência a ele no arquivo de manifesto final. Assim, não é mais necessário criar ou atualizar o arquivo manualmente. O AGP usa os recursos nas pastas res dos módulos do app e qualquer dependência de módulos de biblioteca para determinar as localidades que serão incluídas no arquivo LocaleConfig.

• Atualizações dinâmicas para o localeConfig de um app: use os métodos setOverrideLocaleConfig() e getOverrideLocaleConfig() em LocaleManager para atualizar dinamicamente a lista de idiomas com suporte no app nas configurações do sistema do dispositivo. Use essa flexibilidade para personalizar a lista de idiomas com suporte por região, executar experimentos A/B ou fornecer uma lista atualizada de localidades se o app usar pushes do lado do servidor para localização.

• Visibilidade do idioma do app para Editores de método de entrada (IMEs): os IMEs podem usar o método getApplicationLocales() para conferir o idioma do app atual e associar o idioma do IME a ele.

API Grammatical Inflection

Três bilhões de pessoas falam idiomas com marcação de gênero: idiomas em que categorias gramaticais, como substantivos, verbos, adjetivos e preposições, mudam de acordo com o gênero das pessoas e os objetos sobre os quais elas falam. Tradicionalmente, vários idiomas com marcação de gênero usam o gênero gramatical masculino como padrão ou genérico.

Referir-se a usuários no gênero gramatical errado, como falar com uma mulher no gênero gramatical masculino, pode afetar negativamente o desempenho e a atitude dela. Por outro lado, uma interface com linguagem que reflete corretamente o gênero gramatical do usuário pode melhorar o engajamento e fornecer uma experiência do usuário mais personalizada e natural.

Para ajudar a criar uma interface focada no usuário para idiomas com flexão de gênero, o Android 14 apresenta a API Grammatical Inflection, que permite adicionar suporte aos gêneros gramaticais sem refatorar o app.

Preferências regionais

As preferências regionais permitem que os usuários personalizem unidades de temperatura, o primeiro dia da semana e sistemas de numeração. Um europeu que mora nos Estados Unidos pode preferir que as unidades de temperatura estejam em Celsius em vez de Fahrenheit e que apps tratem a segunda-feira como o início da semana, em vez do padrão dos EUA de usar o domingo.

Os novos menus de configurações do Android para essas preferências oferecem aos usuários um local detectável e centralizado para mudar as preferências do app. Essas preferências também são mantidas com backup e restauração. Várias APIs e intents (como getTemperatureUnit e getFirstDayOfWeek) permitem que o app acesse as preferências do usuário, ajustando a forma como as informações são exibidas. Também é possível registrar um BroadcastReceiver em ACTION_LOCALE_CHANGED para processar mudanças de configuração de localidade quando as preferências regionais mudam.

Para encontrar essas configurações, abra o app Configurações e navegue até Sistema > Idiomas e entrada > Preferências regionais.

Tela de preferências regionais nas configurações do sistema Android.

Opções de temperatura para preferências regionais no sistema Android configurações.

Acessibilidade

Dimensionamento de fonte não linear para 200%

No Android 14 e versões mais recentes, o sistema oferece suporte ao escalonamento de fontes até 200%, oferecendo aos usuários com baixa visão outras opções de acessibilidade alinhadas às Diretrizes de Acessibilidade para Conteúdo Web (WCAG, na sigla em inglês).

Para evitar que elementos de texto grandes na tela fiquem grandes demais, o sistema aplica uma curva de dimensionamento não linear. Essa estratégia significa que textos grandes não são dimensionados na mesma taxa que os menores. O dimensionamento de fonte não linear ajuda a preservar a hierarquia proporcional entre elementos de tamanhos diferentes, reduzindo problemas com o dimensionamento linear em graus elevados, como cortes de texto ou dificuldade de leitura devido a telas muito grandes.

Testar o app com dimensionamento de fontes não linear

Ative o tamanho máximo da fonte nas configurações de acessibilidade de um dispositivo para testar o app.

Se você já usa unidades de pixels dimensionados (sp, na sigla em inglês) para definir o dimensionamento do texto, essas outras opções e melhorias de dimensionamento são aplicadas automaticamente ao texto do app. No entanto, ainda é necessário realizar testes de interface com o tamanho máximo da fonte ativado (200%) para garantir que o app aplique os tamanhos de fonte corretamente e possa acomodar fontes maiores sem afetar a usabilidade.

Para ativar o tamanho de fonte de 200%, siga estas etapas:

1. Abra o app Configurações e navegue até Acessibilidade > Texto e tamanho de exibição.
2. Na opção Tamanho da fonte, toque no ícone de adição (+) até ativar a configuração de tamanho máximo de fonte, conforme mostrado na imagem que acompanha esta seção.

Usar unidades de pixels dimensionados (sp) para tamanhos de texto

Sempre especifique tamanhos de texto em unidades de sp. Quando o app usa unidades de sp, o Android pode aplicar o tamanho de texto preferencial do usuário e escaloná-lo adequadamente.

Não use unidades de sp para preenchimento ou defina as alturas da visualização presumindo que o padding implícito: com o dimensionamento de fonte não linear, as dimensões de sp podem não ser proporcionais. Portanto, 4sp + 20sp podem não ser iguais a 24sp.

Converter unidades de pixels dimensionados

Use TypedValue.applyDimension() para converter unidades de sp em pixels, e TypedValue.deriveDimension() para converter pixels em sp. Esses métodos aplicam a curva de dimensionamento não linear adequada automaticamente.

Evite equações fixadas no código usando Configuration.fontScale ou DisplayMetrics.scaledDensity. Como o dimensionamento da fonte não é linear, o campo scaledDensity não é mais preciso. O campo fontScale precisa ser usado apenas para fins informativos porque as fontes não são mais escalonadas com um único valor escalar.

Usar unidades sp para lineHeight

Sempre defina android:lineHeight usando unidades sp em vez de dp, para que a altura da linha seja dimensionada de acordo com o texto. Caso contrário, se o texto for sp, mas a lineHeight estiver em dp ou px, ele não será dimensionado e parecerá apertado. A TextView corrige automaticamente a lineHeight para que as proporções pretendidas sejam preservadas, mas somente se textSize e lineHeight forem definidos em unidades sp.

Câmera e mídia

Ultra HDR para imagens

Ilustração do intervalo dinâmico padrão (SDR) versus o alto Qualidade de imagem em alcance dinâmico (HDR).

O Android 14 adiciona suporte a imagens de High Dynamic Range (HDR) que retêm mais informações do sensor ao tirar uma foto, o que permite cores vibrantes e maior contraste. O Android usa o formato Ultra HDR, que é totalmente compatível com versões anteriores de imagens JPEG, permitindo que os apps interajam perfeitamente com imagens HDR, exibindo-as no intervalo dinâmico padrão (SDR, na sigla em inglês) conforme necessário.

A renderização dessas imagens na interface em HDR é feita automaticamente pelo framework quando o app opta por usar a interface HDR para a janela de atividade, seja por uma entrada de manifesto ou no momento da execução, chamando Window.setColorMode(). Também é possível capturar imagens estáticas Ultra HDR compactadas em dispositivos compatíveis. Com mais cores recuperadas do sensor, a edição na pós-produção pode ser mais flexível. O O Gainmap associado a imagens Ultra HDR pode ser usado para renderização usando OpenGL ou Vulkan.

Zoom, foco, pós-visualização e muito mais nas extensões da câmera

Android 14 upgrades and improves camera extensions, allowing apps to handle longer processing times, which enables improved images using compute-intensive algorithms like low-light photography on supported devices. These features give users an even more robust experience when using camera extension capabilities. Examples of these improvements include:

• Dynamic still capture processing latency estimation provides much more accurate still capture latency estimates based on the current scene and environment conditions. Call CameraExtensionSession.getRealtimeStillCaptureLatency() to get a StillCaptureLatency object that has two latency estimation methods. The getCaptureLatency() method returns the estimated latency between onCaptureStarted and onCaptureProcessStarted(), and the getProcessingLatency() method returns the estimated latency between onCaptureProcessStarted() and the final processed frame being available.
• Support for capture progress callbacks so that apps can display the current progress of long-running, still-capture processing operations. You can check if this feature is available with CameraExtensionCharacteristics.isCaptureProcessProgressAvailable, and if it is, you implement the onCaptureProcessProgressed() callback, which has the progress (from 0 to 100) passed in as a parameter.

• Extension specific metadata, such as CaptureRequest.EXTENSION_STRENGTH for dialing in the amount of an extension effect, such as the amount of background blur with EXTENSION_BOKEH.

• Postview Feature for Still Capture in camera extensions, which provides a less-processed image more quickly than the final image. If an extension has increased processing latency, a postview image could be provided as a placeholder to improve UX and switched out later for the final image. You can check if this feature is available with CameraExtensionCharacteristics.isPostviewAvailable. Then you can pass an OutputConfiguration to ExtensionSessionConfiguration.setPostviewOutputConfiguration.

• Support for SurfaceView allowing for a more optimized and power-efficient preview render path.

• Support for tap to focus and zoom during extension usage.

Zoom no sensor

Quando REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE em CameraCharacteristics contiver SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW, seu app poderá usar recursos avançados de sensor para dar a um stream RAW cortado os mesmos pixels do campo de visão completo, usando um CaptureRequest com um destino RAW que tenha o caso de uso de stream definido como CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW. Ao implementar os controles de substituição de solicitação, a câmera atualizada oferece aos usuários controle de zoom mesmo antes que outros controles da câmera estejam prontos.

Áudio USB sem perdas

O Android 14 ganha suporte a formatos de áudio sem perdas para experiências a nível de audiófilo em fones de ouvido com fio USB. Você pode consultar um dispositivo USB para os atributos preferidos de mixer, registrar um listener para mudanças nos atributos de mixer preferidos e configurar os atributos usando a classe AudioMixerAttributes. Essa classe representa o formato, como a máscara de canal, a taxa de amostragem e o comportamento do mixer de áudio. A classe permite que o áudio seja enviado diretamente, sem mixagem, ajuste de volume ou efeitos de processamento.

Produtividade e ferramentas para desenvolvedores

Credential Manager

O Android 14 adiciona o Gerenciador de credenciais como uma API de plataforma, com suporte extra a dispositivos Android 4.4 (nível 19 da API) usando uma Biblioteca Jetpack usando o Google Play Services. O objetivo do Gerenciador de credenciais é facilitar o login para usuários com APIs que recuperam e armazenam credenciais com provedores de credenciais configurados pelo usuário. O Gerenciador de credenciais oferece suporte a vários métodos de login, incluindo nome de usuário e senha, chaves de acesso e soluções de login federadas (como o recurso "Fazer login com o Google") em uma única API.

As chaves de acesso oferecem muitas vantagens. Por exemplo, as chaves de acesso são criadas com base nos padrões do setor e podem funcionar em diferentes sistemas operacionais e ecossistemas de navegadores e podem ser usadas em sites e apps.

Para saber mais, consulte a documentação do Gerenciador de credenciais e chaves de acesso e a postagem do blog sobre o Gerenciador de credenciais e chaves de acesso.

Conexão Saúde

A Conexão Saúde é um repositório no dispositivo para dados de saúde e condicionamento físico do usuário. Ela permite que os usuários compartilhem dados entre seus aplicativos favoritos, com um único local para controlar quais dados querem compartilhar com esses apps.

Em dispositivos com versões anteriores ao Android 14, a Conexão Saúde é disponível para download como aplicativo na Google Play Store. A partir do Android 14, a Conexão Saúde faz parte da plataforma e recebe atualizações por meio das atualizações do sistema do Google Play sem precisar de um download separado. Com isso, a Health O Conexão Saúde pode ser atualizado com frequência, e seus apps podem depender dele disponíveis em dispositivos com o Android 14 ou versões mais recentes. Os usuários podem acessar a Conexão Saúde nas configurações do dispositivo, com controles de privacidade integrados às configurações do sistema.

Os usuários podem começar a usar o app Conexão Saúde sem fazer o download de um app separado em dispositivos com o Android 14 ou versões mais recentes.

Os usuários podem controlar quais apps têm acesso à própria saúde e dados de condicionamento físico nas configurações do sistema.

O app Conexão Saúde inclui vários novos recursos no Android 14, como exercícios trajetos, permitindo que os usuários compartilhem a rota do treino, que pode ser visualizada em um mapa. Um trajeto é definido como uma lista de locais salvos em uma janela de tempo, e seu aplicativo pode inserir trajetos em sessões de exercício, vinculando-as juntas. Para garantir que os usuários tenham controle total sobre esses dados sensíveis, eles precisam permitir o compartilhamento de rotas individuais com outros apps.

Para mais informações, consulte a Documentação da Conexão Saúde e a postagem do blog sobre Novidades no Android Saúde.

Atualizações do OpenJDK 17

O Android 14 continua o trabalho de atualizar as principais bibliotecas do Android para se alinhar aos recursos das versões mais recentes do LTS do OpenJDK, incluindo atualizações de bibliotecas e suporte à linguagem Java 17 para desenvolvedores de apps e plataformas.

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

• Aproximadamente 300 classes java.base foram atualizadas para oferecer suporte ao Java 17.
• Blocos de texto, que introduzem literais de string de várias linhas à linguagem de programação Java.
• Correspondência de padrão para instanceof, que permite que um objeto seja tratado como um tipo específico em uma instanceof sem nenhuma outra variável.
• Classes seladas, que permitem restringir quais classes e interfaces podem estender ou implementar essas classes.

Graças às atualizações do sistema do Google Play (Projeto Mainline), mais de 600 milhões de dispositivos podem receber as atualizações mais recentes do Android Runtime (ART), que incluem essas mudanças. Isso faz parte do nosso compromisso de oferecer aos apps um ambiente mais consistente e seguro em todos os dispositivos, com novos recursos para os usuários, independente da versão da plataforma.

Java e OpenJDK são marcas registradas da Oracle e/ou afiliadas.

Melhorias para app stores

O Android 14 apresenta várias APIs PackageInstaller que permitem que as app stores melhorem a experiência do usuário.

Observação: se você é desenvolvedor de uma app store de terceiros, queremos receber seu feedback. Teste as APIs e nos conte o que você achou.

Solicitar aprovação da instalação antes do download

A instalação ou atualização de um app pode exigir a aprovação do usuário. Por exemplo, quando um instalador usando a permissão REQUEST_INSTALL_PACKAGES tenta instalar um novo app. Nas versões anteriores do Android, as app stores só podem solicitar a aprovação do usuário depois que os APKs são gravados na sessão de instalação e a sessão é confirmada.

No Android 14 e versões mais recentes, o método requestUserPreapproval() permite que os instaladores solicitem a aprovação do usuário antes de confirmar a sessão de instalação. Essa melhoria permite que a app store adie o download de APKs até que a instalação seja aprovada pelo usuário. Além disso, depois que um usuário aprova a instalação, a app store pode fazer o download e instalar o app em segundo plano sem interromper o usuário.

Reivindicar a responsabilidade por atualizações futuras

O método setRequestUpdateOwnership() permite que um instalador indique ao sistema que pretende ser responsável por futuras atualizações de um app que ele está instalando. Esse recurso permite a aplicação da atualização de propriedade, o que significa que apenas o proprietário da atualização tem permissão para instalar atualizações automáticas no app. A aplicação da atualização de propriedade ajuda a garantir que os usuários recebam atualizações apenas da app store esperada.

Qualquer outro instalador, incluindo aqueles que usam a permissão INSTALL_PACKAGES, precisa receber aprovação explícita do usuário para instalar uma atualização. Se um usuário decidir continuar com uma atualização de outra fonte, a propriedade da atualização será perdida.

Atualizar apps em momentos menos incômodos

Geralmente, as app stores não querem atualizar um app que está em uso, porque isso encerra os processos em execução e pode interromper o que o usuário está fazendo.

No Android 14 e versões mais recentes, a API InstallConstraints oferece aos instaladores uma maneira de garantir que as atualizações do app ocorram em um momento oportuno. Por exemplo, uma app store pode chamar o método commitSessionAfterInstallConstraintsAreMet() para garantir que uma atualização só seja confirmada quando o usuário não estiver mais interagindo com o app em questão.

Instalar divisões opcionais de forma simples

Com os APKs divididos, os recursos de um app podem ser enviados em arquivos APK separados em vez de como um APK monolítico. Os APKs divididos permitem que as app stores otimizem a entrega de diferentes componentes do app. Por exemplo, app stores podem otimizar com base nas propriedades do dispositivo de destino. A API PackageInstaller oferece suporte a divisões desde que foi introduzida no nível 22 da API.

No Android 14, o método setDontKillApp() permite que um instalador indique que os processos em execução do app não serão encerrados quando novas divisões forem instaladas. As app stores podem usar esse recurso para instalar novos recursos enquanto o usuário está usando o app.

Observação: se você distribuir seu app no Google Play, use o Play Feature Delivery para permitir que determinados recursos sejam enviados condicionalmente ou transferidos por download sob demanda.

Pacotes de metadados do app

No Android 14 e versões mais recentes, o instalador do pacote do Android permite especificar metadados do app, por exemplo, práticas de segurança de dados, para incluir em páginas de app stores, como o Google Play.

Detectar quando usuários fazem capturas de tela no dispositivo

Para criar uma experiência mais padronizada para detectar capturas de tela, o Android 14 apresenta uma API de detecção de capturas de tela que preserva a privacidade. Ela permite que os apps registrem callbacks por atividade. Esses callbacks são invocados, e o usuário é notificado quando faz uma captura de tela enquanto a atividade está visível.

Observação: o callback não fornece uma imagem da captura de tela. Cabe ao app determinar o que aparece na tela quando o usuário faz uma captura de tela.

Experiência do usuário

Ações personalizadas e melhoria na classificação do Sharesheet

O Android 14 atualiza o Sharesheet do sistema para oferecer suporte a ações personalizadas do app e resultados de visualização mais informativos para os usuários.

Adicionar ações personalizadas

Com o Android 14, seu app pode adicionar ações personalizadas ao Sharesheet do sistema que ele invocar.

Captura de tela das ações personalizadas no Sharesheet.

Melhorar a classificação dos alvos de compartilhamento direto

O Android 14 usa mais indicadores de apps para determinar a classificação dos alvos de compartilhamento diretos a fim de apresentar resultados mais úteis para o usuário. Para fornecer o indicador mais útil para a classificação, siga as orientações para melhorar a classificação dos seus alvos de compartilhamento direto. Os apps de comunicação também podem informar o uso de atalhos para mensagens de entrada e saída.

Linha de compartilhamento direto na Sharesheet, como mostrado por 1

Suporte a animações de voltas preditivas integradas e personalizadas

Vídeo: animações de volta preditiva

O Android 13 introduziu a animação de volta preditiva à tela inicial por trás de uma opção do desenvolvedor. Quando usada em um app com suporte para a opção para desenvolvedor ativada, deslizar para trás mostra uma animação indicando que o gesto de retorno sai do app de volta à tela inicial.

O Android 14 inclui várias melhorias e novas orientações para a volta preditiva:

• Você pode configurar android:enableOnBackInvokedCallback=true para ativar as animações do sistema de volta preditiva por atividade em vez de para todo o app.
• Adicionamos novas animações do sistema para acompanhar a animação de retorno à tela inicial do Android 13. As novas animações do sistema são entre atividades e tarefas, que são recebidas automaticamente após a migração para a volta preditiva.
• Adicionamos novas animações do componente Material Design para páginas inferiores, páginas laterais e pesquisa.
• Desenvolvemos orientações de design para a criação de transições e animações personalizadas no app.
• Adicionamos novas APIs para oferecer suporte a animações de transição personalizadas no app:
  • handleOnBackStarted, handleOnBackProgressed, handleOnBackCancelled in OnBackPressedCallback
  • onBackStarted, onBackProgressed, onBackCancelled in OnBackAnimationCallback
  • Use overrideActivityTransition em vez de overridePendingTransition para transições que respondem à medida que o usuário desliza de volta.

Com esta versão de pré-lançamento do Android 14, todos os recursos de volta preditiva permanecem por trás de uma opção para desenvolvedores. Consulte o guia do desenvolvedor para migrar seu app para a volta preditiva e o guia do desenvolvedor para criar transições personalizadas no app.

Substituições por app do fabricante do dispositivo de tela grande

As substituições por app permitem que os fabricantes mudem o comportamento dos apps em dispositivos de tela grande. Por exemplo, a substituição FORCE_RESIZE_APP instrui o sistema a redimensionar o app para que se ajuste às dimensões de exibição (evitando o modo de compatibilidade de tamanho), mesmo que resizeableActivity="false" esteja definido no manifesto do app.

As substituições têm como objetivo melhorar a experiência do usuário em telas grandes.

As novas propriedades do manifesto permitem desativar algumas substituições do fabricante do dispositivo para o app.

Substituições por app para usuários de telas grandes

Observação: esse recurso está incluído em dispositivos com o Android 14 QPR1 ou mais recente.

As substituições por app mudam o comportamento dos apps em dispositivos de tela grande. Por exemplo, a substituição do fabricante do dispositivo OVERRIDE_MIN_ASPECT_RATIO_LARGE define a proporção do app como 16:9, independente da configuração dele.

O QPR1 do Android 14 permite que os usuários apliquem substituições por app usando um novo menu de configurações em dispositivos de tela grande.

Compartilhamento de tela de app

Observação: esse recurso está incluído em dispositivos com o Android 14 QPR2 ou mais recente.

Com o compartilhamento de tela do app, os usuários podem compartilhar uma janela do app em vez da tela inteira do dispositivo durante a gravação do conteúdo da tela.

Com o compartilhamento de tela do app, a barra de status, a barra de navegação, as notificações e outros elementos da interface do sistema são excluídos da exibição compartilhada. Somente o conteúdo do app selecionado é compartilhado.

O compartilhamento de tela no app aumenta a produtividade e a privacidade porque permite que os usuários executem vários apps, mas limite o compartilhamento de conteúdo a um único app.

Resposta inteligente com tecnologia LLM no Gboard no Pixel 8 Pro

On Pixel 8 Pro devices with the December Feature Drop, developers can try out higher-quality smart replies in Gboard powered by on-device Large Language Models (LLMs) running on Google Tensor.

This feature is available as a limited preview for US English in WhatsApp, Line, and KakaoTalk. It requires using a Pixel 8 Pro device with Gboard as your keyboard.

To try it out, first enable the feature in Settings > Developer Options > AiCore Settings > Enable Aicore Persistent.

Next, open a conversation in a supported app to see LLM-powered Smart Reply in Gboard's suggestion strip in response to incoming messages.

Gboard utilizes on-device LLMs to provide higher-quality smart replies.

Note: This feature preview will begin rolling out to devices following the December Feature Drop. If you're not seeing the new Smart Reply behavior yet, please wait a couple days and try again. Model downloads might also take some time, so charging your device on Wi-Fi overnight can help speed this up.

Gráficos

Os caminhos podem ser consultados e interpolados

A API Path do Android é um mecanismo avançado e flexível para criar e renderizar gráficos vetoriais, com a capacidade de traçar ou preencher um caminho, construir um caminho a partir de segmentos de linha ou curvas quadráticas ou cúbicas, realizar operações booleanas para conseguir formas ainda mais complexas ou todas essas formas simultaneamente. Uma limitação é a capacidade de descobrir o que está presente em um objeto de caminho. Os componentes internos do objeto são opacos para autores de chamadas após a criação.

Para criar um Path, chame métodos como moveTo(), lineTo() e cubicTo() para adicionar segmentos de caminho. Mas não há uma maneira de perguntar a esse caminho quais são os segmentos. Portanto, você precisa manter essas informações no momento da criação.

A partir do Android 14, é possível consultar caminhos para descobrir o que há dentro deles. Primeiro, você precisa conseguir um objeto PathIterator usando a API Path.getPathIterator:

Kotlin

val path = Path().apply {
    moveTo(1.0f, 1.0f)
    lineTo(2.0f, 2.0f)
    close()
}
val pathIterator = path.pathIterator

Java

Path path = new Path();
path.moveTo(1.0F, 1.0F);
path.lineTo(2.0F, 2.0F);
path.close();
PathIterator pathIterator = path.getPathIterator();

Em seguida, chame PathIterator para iterar os segmentos um por um, recuperando todos os dados necessários para cada segmento. Este exemplo usa objetos PathIterator.Segment, que empacotam os dados para você:

Kotlin

for (segment in pathIterator) {
    println("segment: ${segment.verb}, ${segment.points}")
}

Java

while (pathIterator.hasNext()) {
    PathIterator.Segment segment = pathIterator.next();
    Log.i(LOG_TAG, "segment: " + segment.getVerb() + ", " + segment.getPoints());
}

O PathIterator também tem uma versão não alocada de next(), em que é possível transmitir um buffer para armazenar os dados dos pontos.

Um dos casos de uso importantes para consultar os dados Path é a interpolação. Por exemplo, você pode querer animar (ou transformar) entre dois caminhos diferentes. Para simplificar ainda mais esse caso de uso, o Android 14 também inclui o método interpolate() em Path. Supondo que os dois caminhos tenham a mesma estrutura interna, o método interpolate() cria um novo Path com esse resultado interpolado. Este exemplo retorna um caminho com um formato que está na metade do caminho (uma interpolação linear de 0,5) entre path e otherPath:

Kotlin

val interpolatedResult = Path()
if (path.isInterpolatable(otherPath)) {
    path.interpolate(otherPath, .5f, interpolatedResult)
}

Java

Path interpolatedResult = new Path();
if (path.isInterpolatable(otherPath)) {
    path.interpolate(otherPath, 0.5F, interpolatedResult);
}

A biblioteca graphics-path do Jetpack também permite APIs semelhantes em versões anteriores do Android.

Malhas personalizadas com sombreadores de vértice e fragmento

Há muito tempo, o Android oferece suporte ao desenho de malhas de triângulo com sombreamento personalizado, mas o formato da malha de entrada ficou limitado a algumas combinações de atributos predefinidas. O Android 14 adiciona suporte a malhas personalizadas, que podem ser definidas como triângulos ou tiras de triângulo e, opcionalmente, indexadas. Essas malhas são especificadas com atributos personalizados, passos de vértice, variações e sombreadores de vértice e fragmento escritos em AGSL.

O sombreador de vértice define as variações, como posição e cor, enquanto o sombreador de fragmento pode, opcionalmente, definir a cor para o pixel, normalmente usando as variações criadas pelo sombreador de vértice. Se a cor for fornecida pelo sombreador de fragmento, ela será misturada com a cor Paint atual usando o modo de mesclagem selecionado ao desenhar a malha. Uniformes podem ser transmitidos para o fragmento e sombreadores de vértice para maior flexibilidade.

Renderizador de buffer de hardware para Canvas

Para ajudar no uso da API Canvas do Android para desenhar com aceleração de hardware em um HardwareBuffer, Android 14 apresenta o HardwareBufferRenderer. Essa API é particularmente útil quando seu caso de uso envolve a comunicação com o compositor do sistema usando SurfaceControl para renderização de baixa latência.