App para carro

Crie apps baseados em modelo para o Android Auto e o Android Automotive OS.
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
3 de abril de 2024 1.2.0 1.4.0-rc02 (link em inglês) - 1.7.0-alpha01

Declarar dependências

Para adicionar uma dependência à Biblioteca Car App, é preciso adicionar o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para ver mais informações.

Adicione as dependências dos artefatos necessários ao arquivo build.gradle do seu app ou módulo:

Groovy

dependencies {
    implementation "androidx.car.app:app:1.2.0"

    // For Android Auto specific functionality
    implementation "androidx.car.app:app-projected:1.2.0"

    // For Android Automotive specific functionality
    implementation "androidx.car.app:app-automotive:1.2.0"

    // For testing
    testImplementation "androidx.car.app:app-testing:1.2.0"
}

Kotlin

dependencies {
    implementation("androidx.car.app:app:1.2.0")

    // For Android Auto specific functionality
    implementation("androidx.car.app:app-projected:1.2.0")

    // For Android Automotive specific functionality
    implementation("androidx.car.app:app-automotive:1.2.0")

    // For testing
    testImplementation("androidx.car.app:app-testing:1.2.0")
}

Para mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.7

Versão 1.7.0-alpha01

3 de abril de 2024

Lançamento de androidx.car.app:app-*:1.7.0-alpha01. Mudamos nosso esquema de controle de versões da biblioteca para corresponder à versão CarApi ativa. Isso reduz a confusão sobre o esquema de nomenclatura com base no feedback do desenvolvedor. Como resultado, vamos pular as versões 1.5 / 1.6 e passar diretamente para a versão 1.7 1.7.0-alpha01 contém estas confirmações (link em inglês).

Novos recursos

  • Mapa com conteúdo: novo modelo chamado MapWithContent, que oferece suporte a lista / grade / painel / mensagem como conteúdo dentro de um mapa.
    • O uso de RoutePreview, PlaceListNavigation e modelos de mapa foi descontinuado.
    • Os apps de exemplo foram atualizados para mostrar a funcionalidade dos modelos descontinuados usando MapWithContent.
  • Item da conversa: novas APIs para mostrar conversas (mensagens instantâneas e SMS) e leitura do Assistente no carro.
  • Dimensões do veículo: nova API para recuperar medidas do veículo (dados no AAOS no momento).

Mudanças na API

  • O tipo de imagem de linha extra pequena foi marcado como experimental (I5184b).
  • Adição da API CarInfo#fetchExteriorDimensions, que permite acesso a informações de dimensão externa do veículo, como altura, largura etc (Ia40c5).
  • A tag ExperimentalAPI foi removida de MapWithContentTemplate (I66db8).
  • O parâmetro GridItem#setTitle foi atualizado para ser anulável. (I3d610).
  • A API GetHeader não requer a API 7 porque é compatível com versões anteriores (I8c812).
  • Adição de suporte a Header em ListTemplate, e o uso de headerAction, headerTitle e actionStrip foi descontinuado (I7ae01).
  • O uso de title, headerAction e actionStrip em GridTemplate foi descontinuado, e o suporte a Header foi adicionado (I41a9c).
  • Remoção do requisito de nível 7 para APIs experimentais: selo, tamanho do item GridTemplate e getters/setters da forma da imagem, métodos GridItem para receber/definir um selo (Id71eb).
  • O uso de title, headerAction, actionStrip em PaneTemplate foi descontinuado e o novo suporte a Header foi adicionado (I23154).
  • A telemetria do Media Center foi alterada de BroadcastReceiver para Procurar ação personalizada. (I4185f).
  • Foi adicionado suporte ao atributo Header em MessageTemplate O suporte para ActionStrip, headerAction e title foi descontinuado. (Ie2de8).
  • Modificar a visibilidade da constante de alerta (Icf8a8).
  • O atributo isLoading foi removido do modelo pai (I651e6).
  • Foram adicionados extras para informar os apps de mídia sobre os principais parâmetros da interface (I85ca2).
  • O recurso de análise da Central de mídia foi adicionado ao MediaExtensions (I7ce28).
  • Opção adicionada para imagem muito pequena nas linhas. (I72c03).

Correções de bugs

  • O javadoc no ConversationItem foi atualizado para declarar que as mensagens precisam ser classificadas em ordem da mais antiga para a mais recente. (I77a2a).
  • A lógica de truncamento do ListTemplate foi atualizada para remover as mensagens mais antigas de ConversationItem (Ie0a61).

Versão 1.4

Versão 1.4.0-rc02

13 de dezembro de 2023

Lançamento de androidx.car.app:app-*:1.4.0-rc02. A versão 1.4.0-rc02 contém estas confirmações. Somente pequenas correções

Correções de bugs

  • O javadoc no ConversationItem foi atualizado para declarar que as mensagens precisam ser classificadas na ordem da mais antiga para a mais recente (I77a2a).
  • A lógica de truncamento do ListTemplate foi atualizada para remover as mensagens mais antigas de ConversationItem (Ie0a61).

Versão 1.4.0-rc01

1º de novembro de 2023

Lançamento de androidx.car.app:app-*:1.4.0-rc01 sem mudanças importantes. A versão 1.4.0-rc01 contém estas confirmações.

Versão 1.4.0-beta02

20 de setembro de 2023

Lançamento de androidx.car.app:app-*:1.4.0-beta02. A versão 1.4.0-beta02 contém estas confirmações. Isso é quase idêntico ao beta01, mas reduz o requisito do compileSdk para 33.

Correções de bugs

  • Foi corrigido um bug em que as telas de carregamento em guias não eram exibidas corretamente. (cae860).

Versão 1.4.0-beta01

9 de agosto de 2023

Lançamento de androidx.car.app:app-*:1.4.0-beta01. A versão 1.4.0-beta01 contém estas confirmações.

Observação:a versão 1.4-beta01 exige o compileSdk34, que ainda está no status de desenvolvedor. A versão 1.4-beta02 corrigirá esse problema. Como alternativa, você pode adicionar android.suppressUnsupportedCompileSdk=34 ao arquivo settings.gradle do projeto para suprimir o aviso temporariamente com segurança.

Novos recursos

Mudanças na API

  • Consulte alpha02

Versão 1.4.0-alpha02

26 de julho de 2023

Lançamento de androidx.car.app:app-*:1.4.0-alpha02. A versão 1.4.0-alpha02 contém estas confirmações.

  • O lançamento da versão Alpha02 serve como preparação para a próxima versão da versão beta01.

Novos recursos

  • Renderização de mapas no suporte a cluster de instrumentos para apps de navegação
  • Adição de guias para apps para melhorar a experiência de layout
  • Adição de opções de renderização de modelos de grade / lista
  • Adicionadas novas categorias para Clima e Comunicações
  • Migração de várias APIs para a próxima versão da CarApi 7

Mudanças na API

  • Foram adicionados campos multimídia a CarMessage (I5aaf6).
  • Ações personalizadas foram adicionadas a ConversationItem na biblioteca Car App (Ie5ed6).
  • Foram adicionados extras para indicar que um item de mídia é reproduzido com um formato de áudio imersivo e mostrar o logotipo do formato de conteúdo (Icb5bb).
  • Foi adicionado um novo tipo de ação, a API ActionsConstraints, para oferecer suporte ao botão "Escrever". (I31661).
  • set/getTemplate agora é set/get ContentTemplate (Ica036).
  • O parâmetro do modelo agora é @NonNull. Atualização da documentação da API MapWithContentTemplate (I0f8ed).
  • A tag @ExperimentalCarApi foi removida das ações em ListTemplate para lançamento na CAL 1.4 (I2cfcb).
  • A tag @ExperimentalCarApi foi removida de TabTemplate (Ifcb82).
  • As anotações @ExperimentalCarApi foram removidas das decorações e ações secundárias da linha (I8487e).
  • O ID do conteúdo da guia ativa foi adicionado ao TabTemplate e descontinua o estado ativo em guias (I96932).
  • A propriedade ItemImageShape foi adicionada a GridTemplate (Ibf431).
  • A propriedade ItemSize foi adicionada a GridTemplate, que controla o dimensionamento do item da grade de acordo com intervalos relativamente pequenos, médios e grandes. (Icdb3b).
  • Permita que os desenvolvedores acessem a API para conseguir uma cópia da pilha de telas atual. (I48107).
  • A categoria de apps de clima foi adicionada à biblioteca Car App (I2be44).
  • Uma categoria para chamar apps foi adicionada à biblioteca Car App (Icab33).
  • GridItem.Builder#setBadge() foi substituído por métodos setImage() sobrecarregados (Id2000).
  • A propriedade do ícone foi adicionada ao selo (I629b2).
  • Um método para definir a cor de fundo do selo de ponto foi adicionado (I6411c).
  • A propriedade do selo foi adicionada a GridItem, permitindo que um selo seja mostrado sobre uma imagem de GridItem. (I95de7).
  • Adição de um objeto Badge experimental que representa um selo a ser exibido sobre uma imagem. (I9878d).

Versão 1.4.0-alpha01

22 de fevereiro de 2023

Lançamento de androidx.car.app:app-*:1.4.0-alpha01. A versão 1.4.0-alpha01 contém estas confirmações.

Mudanças na API

  • Foram adicionadas ações de nível superior a GridTemplate na biblioteca Car App (Id0191).
  • Foram adicionadas ações de nível superior a ListTemplate na biblioteca Car App (I9efab).
  • Foram adicionados extras para vincular o subtítulo ou a descrição de um item de mídia a outros (Ic84bf).
  • O nível da API foi atualizado para o nível 6 em ações da linha (Ie0a69).
  • Foram adicionados callbacks de mensagens à A4C (Ie3986).

Correções de bugs

  • Foram adicionadas referências de documentos Java para CarMessage (I5db1c).
  • equals() e hashCode() foram substituídos por ConversationItem e CarMessage (I6fd10).
  • A validação de ConversationItem.mMessages foi melhorada e agora requer um valor não nulo e não vazio (Iafc51).
  • Anotações @Keep foram adicionadas aos campos ConversationItem (I5d250).
  • Os documentos Java foram atualizados para a decoração de linhas e as ações secundárias (I000b6).

Versão 1.3

Versão 1.3.0-rc01

7 de dezembro de 2022

Lançamento de androidx.car.app:app-*:1.3.0-rc01. A versão 1.3.0-rc01 contém estas confirmações.

  • Pequenas correções de bug da versão beta01. Nenhuma mudança importante.

Versão 1.3.0-beta01

7 de setembro de 2022

Lançamento de androidx.car.app:app:1.3.0-beta01, androidx.car.app:app-projected:1.3.0-beta01, androidx.car.app:app-automotive:1.3.0-beta01 e androidx.car.app:app-testing:1.3.0-beta01. A versão 1.3.0-beta01 contém estas confirmações.

Novos recursos

Além dos recursos adicionados à biblioteca Car App versão 1.3.0-alpha01, as funções abaixo foram adicionadas como parte da versão beta01. Todos os recursos aqui envolvem apenas mudanças do lado do host, não da API:

  • A barra de navegação flutuante vai continuar a aparecer mesmo quando um usuário estiver em uma tela de seleção baseada em mapa em PlaceListNavigationTemplate, RoutePreviewNavigationTemplate e MapTemplate. Isso pode ser feito atualizando as informações de navegação com o NavigationManager.updateTrip().
  • Ative o botão de ação com FLAG_DEFAULT para mostrar uma animação de tempo limite. Esse botão vai receber um clique por padrão após o tempo limite ([API 5 - All Templates]).
  • Um subtexto de Rows não é truncado quando o carro está estacionado, mas é truncado para duas linhas enquanto você dirige ([API 5 - All Templates]).
  • Suporte ao estado desativado para Action, Toggle, Row ([API 5 - All Templates]).

Mudanças na API

  • Restrições foram relaxadas na lista de MapTemplates para oferecer suporte a listas selecionáveis (I961ed).
  • A restrição de ações de cabeçalho foi removida para permitir ícones personalizados (Iad28f).
  • Uma restrição setOnClickListenerAllowed() foi adicionada a ActionsConstraints. Isso permitiu que a classe Action definisse OnClickDelegate() como ações, exceto no caso dos tipos de ícone padrão (TYPE_APP_ICON, TYPE_BACK e TYPE_PAN) (I3c745).

Correções de bugs

Versão 1.3.0-alpha01

27 de julho de 2022

Lançamento de androidx.car.app:app:1.3.0-alpha01, androidx.car.app:app-projected:1.3.0-alpha01, androidx.car.app:app-automotive:1.3.0-alpha01 e androidx.car.app:app-testing:1.3.0-alpha01. A versão 1.3.0-alpha01 contém estas confirmações.

Os recursos anotados com a API de nível 5 são compatíveis com o Android Auto 7.9 e versões mais recentes.

Novos recursos

  • API de nível 5: novo MapTemplate que pode ser usado por apps de navegação para mostrar o painel ou listar conteúdos ao lado de um mapa (If5826, If44b8).
  • API de nível 5: nova API CarAudioRecord que permite gravar a entrada de áudio pelo microfone do veículo host (I5e71a).
  • API de nível 5: nova API SuggestionManager que permite que os apps forneçam sugestões para o host (I5c103).
  • API de nível 5: nova API Alert para mostrar notificações no contexto no NavigationTemplate (I163a7, I5ad70).
  • API de nível 5: novos componentes Header e MapController para facilitar a reutilização de modelos (If5826).
  • Adicionamos androidx.car.app.category.POI como uma categoria para ativar apps de PDI. As categorias androidx.car.app.category.PARKING e androidx.car.app.category.CHARGING foram descontinuadas (I59da1).

Mudanças na API

  • API de nível 5: novo método onClick na interface SurfaceCallback para permitir a interatividade "toque no mapa" (Ia9777).
  • API de nível 5: novas flags Action.FLAG_IS_PERSISTENT e Action.FLAG_DEFAULT para descrever Actions (I96318, I5ad70).
  • API de nível 5: novo estado ativado/desativado para os componentes Action, Row e Toggle. O suporte ao host vai ser disponibilizado na versão 1.3.0-beta01 da biblioteca (Id8a09).
  • API de nível 5: favorecimento do novo componente Header via setHeader no PlaceListNavigationTemplate.Builder e no RoutePreviewNavigationTemplate.Builder, com a descontinuação dos métodos setTitle e setHeaderAction (I30e6a).
  • API de nível 5: novo método setOnContentRefreshListner no PlaceListMapTemplate.Builder e no PlaceListNavigationTemplate.Builder para uso com implementações da nova interface OnContentRefreshListner.
  • API de nível 5: novos setTripText e setTripIcon no TravelEstimate.Builder para personalizar o card de estimativa de viagem (Idcc6d, Ic620d).
  • Adição de suporte às CarIconSpans no título do PaneTemplate (Ia1ee0).
  • Foi adicionado suporte a CarIconSpans no título e no texto de uma Row (Ic1e3c).
  • As ActionStrips do mapa agora podem ter até quatro ações (If3522).
  • Atualização da API Car App para o nível 5 (I26b8e).
  • Os cabeçalhos/títulos agora são opcionais para PlaceListMapTemplate, PlaceListNavigationTemplate, RoutePreviewNavigationTemplate, GridTemplate, ListTemplate, LongMessageTemplate, MessageTemplate, PaneTemplate e SignInTemplate (I2078d, Icadde).

Correções de bugs

  • As regras de tamanho da imagem do PaneTemplate foram atualizadas para que ele seja uma caixa delimitadora quadrada (Idd72e).
  • Foi corrigida uma exceção que acontece quando a pilha de telas é modificada após o State.DESTROYED (I3c8eb).
  • Adição de uma verificação de valores nulos para recuperar o ícone do app (I3f710).
  • Atualização da API Car Hardware para usar STATUS_UNKNOWN em vez de STATUS_UNAVAILABLE por padrão (Ic9444).
  • É verificado se a tela existe antes de criar a superfície (Ice027a).
  • Correção do bug de CarValue.equals() envolvendo STATUS_UNIMPLEMENTED (I24451).

Versão 1.2

Versão 1.2.0

9 de novembro de 2022

Lançamento de androidx.car.app:app-*:1.2.0. A versão 1.2.0 contém estas confirmações.

  • Esta é uma versão de estabilização. Não há mudanças em comparação com a v1.2.0-rc01.

Versão 1.2.0-rc01

23 de março de 2022

Lançamento de androidx.car.app:app-*:1.2.0-rc01. A versão 1.2.0-rc01 contém estas confirmações.

  • Esta é uma versão de estabilização. Não há mudanças de API em comparação com a v1.2.0-beta02. Foram adicionados novos recursos experimentais (API de nível 5) destinados a versões futuras do Android Auto e do Android Automotive.

Correções de bugs

  • Foi corrigida uma exceção que acontece quando a pilha de telas é modificada após o State.DESTROYED (I3c8eb).
  • A API CarSensors foi atualizada para indicar que não foi implementada para o AAOS (Idd57b).
  • PlaceListMapTempalte.Builder#setCurrentLocationEnabled foi atualizado para indicar que ACCESS_COARSE_LOCATION é suficiente para o recurso (I510c2).
  • O número de saídas é opcional para os tipos de manobra na rotatória (Ife7d1).

Versão 1.2.0-beta02

26 de janeiro de 2022

Lançamento de androidx.car.app:app-*:1.2.0-beta02. A versão 1.2.0-beta02 contém estas confirmações.

Os apps para carros criados com essa versão da biblioteca destinada à plataforma Android Automotive OS agora podem ser publicados no canal de teste aberto da Play Store. Consulte o guia de desenvolvimento para ver mais detalhes.

Recursos anotados com API de nível 4 ou anterior são compatíveis com o Android Auto 7.2 e mais recentes e a nova plataforma do Android Automotive OS. Consulte a seção Known Issues abaixo para ver os detalhes.

Mudanças na API

  • A API experimental setOnContentRefreshListener foi adicionada aos modelos de PDIs (I6bf22).

Correções de bugs

  • Um vazamento de memória em CarAppService quando o host do carro é desvinculado foi corrigido (I5c9ca, b/203594731).
  • CarAppActivity foi atualizada a fim de incluir requisitos para o modo de inicialização singleTask (Id2f95).
  • A falha visual na retomada foi reduzida (Iff7e0).

Problemas conhecidos

  • As ActionStrips do mapa no PlaceListNavigationTemplate e no RoutePreviewNavigateTemplate vão começar a ser disponibilizadas nas próximas versões do Android Auto e do Android Automotive OS.

Versão 1.2.0-alpha02

15 de dezembro de 2021

Lançamento de androidx.car.app:app-*:1.2.0-alpha02. A versão 1.2.0-alpha02 contém estas confirmações.

Os recursos anotados com a API de nível 4 foram atualizados de "experimental" para "estável", incluindo as ActionStrips do mapa no PlaceListNavigationTemplate e RoutePreviewNavigateTemplate, a imagem CarIcon nos Panes, o QRCodeSignInMethod e a capacidade de definir dicas de renderização (como flags) nas Actions.

Novos recursos

  • No Android Auto 7.1 e em versões mais recentes, o limite de itens no Pane foi aumentado de 2 para 4.

Mudanças na API

  • Um método toString() experimental foi adicionado à CarUnit (I36a3b).

Correções de bugs

  • Foi corrigida uma falha que ocorria na CarAppPermissionActivity quando o callback era desativado (If9823).
  • Mudança do limite de listas padrão do Pane para 4 (I0068b).

Versão 1.2.0-alpha01

3 novembro de 2021

Lançamento de androidx.car.app:app-*:1.2.0-alpha01. A versão 1.2.0-alpha01 contém estas confirmações.

No momento, todos os novos recursos da v1.2.0 (API de nível 4 ou mais recente) são experimentalmente voltados para versões futuras do Android Auto e Android Automotive OS. Consulte o guia de desenvolvimento para ver mais detalhes.

Mudanças na API

  • A API AutomotiveCarInfo foi transformada em experimental (Ia13e5).
  • A API Car App Library de nível 4 foi adicionada (I2a2e7).
  • API de nível 4: foi adicionado suporte à definição de um CarIcon em Pane (Ifcc12).
  • API de nível 4: foi adicionado um método de login por QR code (Ib623e).
  • API de nível 4: set/getFlags foi adicionado a Action (Ic03ab).
  • API de nível 4: foi adicionado suporte às funções de movimentar e aumentar zoom no PlaceListNavigationTemplate e RoutePreviewNavigationTemplate (I9d8a3).

Correções de bugs

  • API de nível 4: foi adicionado um mecanismo para permitir que apps enviem atualizações de local ao host do carro (I3bad3).
  • Foi corrigido um problema em que a lógica de validação do host não encontrava a permissão TEMPLATE_RENDERER corretamente (I62618).

Versão 1.1.0

Versão 1.1.0

15 de dezembro de 2021

Lançamento de androidx.car.app:app-*:1.1.0. A versão 1.1.0 contém estas confirmações.

Esta é uma versão de estabilização. Não há mudanças em comparação com a v1.1.0-rc01. Consulte também as notas da versão da v1.2.0-alpha02 para ver mais detalhes sobre os novos recursos da biblioteca de apps para carros.

Mudanças importantes desde a versão 1.0.0

  • API de nível 2: foram adicionados SignInTemplate e LongMessageTemplate, que podem ser usados para fluxos de login quando o veículo está estacionado.
  • API de nível 2: suporte à interação com mapas no NavigationTemplate.
  • API de nível 2: o suporte a mensagens de texto de vários tamanhos foi adicionado para permitir que os apps forneçam várias versões da string para exibição, dependendo do tamanho da tela do carro.
  • API de nível 3: foi adicionada uma classe CarHardwareManager, que pode ser usada para consultar dados de hardware do veículo, como modelo e marca, níveis de combustível e outros sensores.

Versão 1.1.0-rc01

3 novembro de 2021

Lançamento de androidx.car.app:app-*:1.1.0-rc01. A versão 1.1.0-rc01 contém estas confirmações.

Esta é uma versão de estabilização. Não há mudanças de API em comparação com a v1.1.0-beta01. Foram adicionados novos recursos experimentais (API de nível 4) destinados a versões futuras do Android Auto. Consulte as notas da versão da v1.2.0-alpha01 para ver mais detalhes sobre as APIs experimentais.

Versão 1.1.0-beta01

1º de setembro de 2021

Lançamento de androidx.car.app:app-*:1.1.0-beta01. A versão 1.1.0-beta01 contém estas confirmações.

Todos os recursos da v1.1.0 (API 2 e mais recentes) são totalmente compatíveis com o Android Auto 6.7 e versões mais recentes. Consulte o guia de desenvolvimento para ver mais detalhes.

Mudanças na API

  • Remoção do Manager como interface pública (Ie381b).
  • Nova capacidade de definir um plano de fundo personalizado da marca para uma solicitação de permissão (I74b76).
  • ScreenManager.getStackSize foi adicionado (I0b16a).
  • Foi removido o construtor ScreenController, que usa o TestCarContext de forma explícita (Iefebc).

Correções de bugs

  • Foi acrescentada a verificação de nível de API ao criar o CarHardwareManager (I48f9b).
  • Novas verificações de uso inválido do CarSpan em toda a API (I65ae6).
  • Foi corrigido um problema em que, quando uma Screen era marcada como concluída durante a criação, a pilha ficava em um estado corrompido (I81b13).
  • Foi corrigido um problema em que o CarNotificationManager.notify registrava um erro para o AutomotiveOS quando havia ações com ícones no CarAppExtender (I3633d).
  • Novo método de handshake para o app e o host estabelecerem uma versão da API (I7d6f8).

Versão 1.1.0-alpha02

21 de julho de 2021

Lançamento de androidx.car.app:app-*:1.1.0-alpha02. A versão 1.1.0-alpha02 contém estas confirmações.

Novos recursos

  • API de nível 3: foi adicionado um CarHardwareManager que pode ser usado para consultar dados de hardware do veículo, como modelo e marca, níveis de combustível e outros sensores. Atualmente, esse recurso está disponível apenas para o Android Auto 6.7 e versões mais recentes no canal de teste aberto. Para fazer esse teste em um ambiente de computador, é necessário lançar uma nova versão do Desktop Head Unit separadamente. Fique de olho na página Testar apps Android para carros para ver detalhes de quando a nova versão estará disponível.
  • Siga o guia de desenvolvimento e a referência da biblioteca para mais informações e diretrizes sobre como usar esses recursos em hosts de carro compatíveis com a API de nível 3.

Mudanças na API

  • Os métodos de ciclo de vida SessionController e ScreenController foram consolidados em um único método moveToState (I1ed00).
  • Novo recurso: CarContext#getHostInfo() (I8977e).
  • Campos descontinuados foram removidos (I67168).
  • SessionController e ScreenController foram atualizados para expor construtores diretamente (Iabf22).
  • PinSignInMethod.Builder e ProviderSignInMethod.Builder foram removidos (I9f0cb).
  • "setCarAppResult()" foi adicionado para permitir o uso de apps de modelo "para resultado" no AAOS (I37741).
  • As interfaces CarHardware receberam anotação @MainThread (Ib2f85).
  • OnCarDataListener foi renomeado como OnCarDataAvailableListener (I518ca).
  • Os nomes de método CarInfo, Speed e Mileage e o javadoc foram atualizados (I86672).
  • Toll foi renomeado como TollCard (I3e7c8).
  • O PinSignInMethod.getPin descontinuado foi removido e substituído pelo PinSignInMethod.getPinCode (I996ce).
  • O OnInputCompletedListener foi removido e substituído pelo InputCallback (Ib5be1).
  • O PinSignInMethod foi mudado para usar CharSequence em vez de String (I275d5).

Correções de bugs

  • O Javadoc foi corrigido no hardware do carro (I2abbc).

Contribuição externa

Problemas conhecidos

  • No SignInTemplate, o uso do InputSignInMethod pode resultar em uma NullPointerException no host do carro. Isso será abordado na próxima versão da biblioteca. Para resolver o problema, inclua esta linha na configuração do Proguard do seu app: -keep class androidx.car.app.model.signin.InputSignInMethod { *; }

Versão 1.1.0-alpha01

16 de junho de 2021

Lançamento de androidx.car.app:app:1.1.0-alpha01, androidx.car.app:app-automotive:1.1.0-alpha01 e androidx.car.app:app-testing:1.1.0-alpha01. A versão 1.1.0-alpha01 contém estas confirmações.

Novos recursos

  • API de nível 2: novos SignInTemplate e LongMessageTemplate que podem ser usados para fluxos de login quando o veículo está estacionado.
  • API de nível 2: novo suporte à interação com o mapa no NavigationTemplate.
  • API de nível 2: novo suporte a mensagens de texto de vários tamanhos para permitir que os apps forneçam várias versões da string para exibição, dependendo do tamanho da tela do carro.
  • Siga o guia de desenvolvimento e a biblioteca Javadoc para mais informações e diretrizes sobre como usar esses recursos em hosts de carro compatíveis com a API de nível 2.

Mudanças na API

  • Todos os métodos de interface *Callback foram padronizados e renomeados como OnRequestPermissionsCallback -> OnRequestPermissionsListener (Ibb3ec9).
  • As classes androidx.car.app.hardware foram atualizadas para remover builders e classes de parâmetros desnecessários (I67beb)
  • As classes androidx.car.app.hardware foram adicionadas para fornecer acesso a dados específicos do carro, como combustível, bateria e velocidade (Iff3c9).
  • Adição de suporte à ActionStrip em MessageTemplate (Ida657).
  • setLoading foi adicionado a MessageTemplate. (I2a4b5).
  • ConnectionToCar foi renomeado como CarConnection (Ife9bd).
  • Mudança em NavigationTemplate para retornar um PanModeDelegate explícito (I13877).
  • A ordem dos parâmetros foi atualizada em CarContext.requestPermissions (Ib890a).
  • A chave de metadados foi atualizada para definir o nível mínimo da API do carro para androidx.car.api.minCarApiLevel (Ib0d41).
  • Foi criada uma API que permite observar o estado da conexão do carro (Ifc935).
  • Foi adicionado suporte à definição de um botão para uma Action, além do tipo de movimentação Action (Ica6af).
  • CarNotificationManager foi criado para oferecer suporte ao envio de notificações no carro (I10d7a).
  • Inclusão de ConstraintManager para definir limites de lista do host (I8690e).
  • O modo de movimentação e a API Map Action Strip foram adicionados no NavigationTemplate (I77aa6).
  • Inclusão da API pan e zoom em SurfaceCallback para apps de navegação (Id5e9d).
  • Atualização de CarAppApiLevel para 2 (Ic1540).
  • Foi adicionada a capacidade de solicitar permissões em um CarAppService (I5421e).
  • A anotação RequiresCarApi(2) foi adicionada à API de vários textos (Iacb62).
  • Diversas variantes de texto foram permitidas no título do modelo de meia lista (Ib8df7).
  • Foi adicionado um novo LongMessageTemplate. Requer o nível 2 da API Car (Ic5cee).

Correções de bugs

  • Os requisitos de tamanho da imagem foram atualizados para incluir telas de carros maiores (I116dc).
  • Não é mais permitido adicionar mais de duas ações em corpos de modelo (I32157).
  • Foi garantida a criação de PendingIntents nas flags do conjunto da biblioteca de apps do carro (If84fe, b/186394900).
  • Javadoc atualizado para permitir mudanças no texto de Row, como atualizações (If3f9c).
  • androidx.activity:activity:1.2.0 agora é uma dependência de API (Id1cb9).
  • SignInTemplate e LongMessageTemplate foram criados para exigir que ações no corpo deles sejam feitas apenas quando o carro estiver estacionado e atualizar a documentação para indicar que eles só vão ser mostrados quando o carro estiver estacionado (Iddaa9).
  • Foi corrigida uma exceção que ocorre ao exibir uma Screen durante a inicialização (Ifcf40, b/184664896).
  • Cor de texto personalizada permitida em ForegroundCarColorSpan (I69e59)
  • Correção de um problema em que ON_DESTROY em um Session é observado após um Screen de ON_DESTROY (I52e01, b/183696617)
  • O javadoc atualizado foi ativado ao definir o tempo restante de um TravelEstimate para um horário desconhecido (I99610, b/183632456).
  • Action foi atualizado para oferecer suporte a ForegroundColorSpan no título e em qualquer cor de fundo personalizada (I578e4).
  • NavigationManagerCallback#onStopNavigation não é executado quando o callback é apagado antes da execução do executor (I7fc5e, b/181143772).
  • Foi corrigido um problema que exigia que o app assumisse explicitamente uma dependência em lifecycle-common-java8 (I8b8c8).

Problemas conhecidos

  • No SignInTemplate, o teclado na tela mostra um ícone de pesquisa em vez de um ícone de enviar quando o usuário quer confirmar a entrada. Como alternativa, os usuários podem acessar o teclado do smartphone, que é ativado quando o campo de entrada está em foco.
  • No Android Auto versão 6.5, os callbacks de movimentação e zoom em SurfaceCallback podem ser invocados incorretamente com alguns gestos de toque.

Car App Testing versão 1.0.0

Versão 1.0.0-alpha01

24 de março de 2021

Lançamento de androidx.car.app:app-testing:1.0.0-alpha01. A versão 1.0.0-alpha01 contém estas confirmações.

Essa é a primeira versão do Jetpack da biblioteca de teste código fechado anterior. Consulte nossos exemplos (em inglês) para usar essa biblioteca nos seus testes.

Novos recursos

  • Os controladores das classes de modelo foram removidos. Getters de modelo agora fazem parte da superfície da API pública, que permite validar valores que foram definidos nos builders.
  • O CarAppServiceController anterior foi substituído pelo novo SessionController para testar a lógica relacionada à vida útil da conexão com o host.

Versão 1.0.0

Versão 1.0.0

21 de abril de 2021

Lançamento de androidx.car.app:app:1.0.0. A versão 1.0.0 contém estas confirmações.

Principais recursos da versão 1.0.0

  • No início de abril, anunciamos que os apps podem começar a publicar no canal de produção usando androidx.car.app:app:1.0.0-rc01. A biblioteca Car App v1.0.0 agora é estável e totalmente compatível com o Android Auto 6.1 e versões mais recentes.
  • Siga o guia de desenvolvimento para detalhes sobre como criar apps de navegação, estacionamento e carregamento para o Android Auto usando a biblioteca.

Correções de bugs

  • Correção de uma exceção que ocorre ao exibir um Screen durante o início (70aae1, b/184664896)
  • Correção de um problema em que ON_DESTROY em um Session é observado após um Screen de ON_DESTROY (0cebor, b/183696617)

Versão 1.0.0-rc01

24 de março de 2021

Lançamento de androidx.car.app:app:1.0.0-rc01. A versão 1.0.0-rc01 contém estas confirmações.

Correções de bugs

  • Foi corrigido um bug de disputa em que o NavigationManagerCallback#onStopNavigation estava sendo chamado depois que o callback era apagado. Isso acontecia quando o callback era apagado antes do executor do callback ser realmente executado (I7fc5e, b/181143772).
  • Um problema que exigia a inicialização explícita de uma dependência do lifecycle-common-java8 foi corrigido (I8b8c8).
  • Foi corrigida uma NullPointerException que era gerada no momento em que o app recebia uma chamada stopNavigation quando já tinha removido um callback (Ib8b89, b/181143772).
  • Melhorias para não enviar chamadas ao app quando o ciclo de vida não está em um estado CREATED (I86965, b/179800224, b/177921120).
  • Foi corrigido um problema em que uma API mínima inválida especificada no manifesto do app gerava uma falha e causava um ANR no host (Iffedd, b/174231592).

Versão 1.0.0-beta01

24 de fevereiro de 2021

Lançamento de androidx.car.app:app:1.0.0-beta01. A versão 1.0.0-beta01 contém estas confirmações.

Essa é a primeira versão do Jetpack da biblioteca de código fechado anterior e é compatível com o Android Auto 6.1 e versões mais recentes. Siga o guia de desenvolvimento e veja mais detalhes sobre como criar apps para carros usando a biblioteca.

Novos recursos

Correções de bugs

  • Correção de um problema em que a Screen errada era retomada ao mostrar as telas em sequência (b/177590791).