Informações do Provedor de Contatos e Afinidades

A partir do Android 10, os dados relacionados à afinidade de contatos, gerenciados pelo componente Provedor de contatos (a fonte de dados vista no aplicativo de contatos de um dispositivo), são acessados ​​de maneira diferente do Android 9 e inferior.

Antes do Android 10, os aplicativos usavam o Provedor de contatos para acessar dados e transferi-los entre um dispositivo e serviços online. O Android 10 apresenta alterações em relação à acessibilidade de dados para garantir maior privacidade do usuário em todos os dispositivos Android 10 que usam o Provedor de contatos. Por um lado, o banco de dados subjacente não contém dados de afinidades de contato. Portanto, os aplicativos não podem escrever ou ler a partir dele. As alterações incluem o seguinte:

  • O Provedor de contatos não registra dados relacionados à afinidade de contatos, como o número de vezes que um usuário foi contatado, a última vez em que o contato foi feito, o aplicativo usado, a pessoa contatada ou quaisquer dados históricos relacionados.
  • A classe MultiAutoCompleteTextView na API de preenchimento automático do provedor de contatos não classifica os resultados da consulta por contador de interação.
  • A estrutura do Android não fornece classificação de contatos implícita. (No entanto, a classificação de contatos explícitos controlados pelo usuário (como contatos com estrela ) permanece).

Para implementar essas alterações, siga um destes procedimentos:

  • Use o provedor de contatos mais recente.
  • Atualize sua versão (se estiver usando uma versão bifurcada).

Além disso, atualize todos os aplicativos que dependem dos recursos obsoletos do Provedor de contatos . Versões de API projetadas para serem soluções alternativas para as funções obsoletas não são permitidas.

Para Android 9 e inferior, os dados de interação de contato do Provedor de contatos não foram removidos. Em vez disso, os dados de interação de contato são limpos periodicamente (aproximadamente uma vez por dia) para simular o equivalente no Android 10. O Provedor de contatos armazena essas informações, mas apenas temporariamente.

Alterações da API

Espera-se que essas alterações tenham um grande impacto nas APIs. Por exemplo, a classificação de preenchimento automático não funcionará tão bem. Os impactos potenciais no comportamento da API incluem o seguinte:

  • O Provedor de Contatos não armazenará as preferências de um usuário ou interações com o contato nas colunas da tabela ContactsContract.Contacts .
  • A API de preenchimento automático não classificará os resultados por contador de interação.
  • As TIMES_CONTACTED / TIMES_USED e LAST_TIME_CONTACTED / LAST_TIME_USED não serão atualizadas.
    • Eles são limpos (para null ou definidos como 0, dependendo das colunas afetadas) na atualização para o Android 10.
    • A classificação nas APIs de consulta de preenchimento automático retorna resultados classificados em ordem alfabética, nunca por informações de afinidade.
    • Chamadas de API para contatos frequentes (por exemplo, usando a string de filtro CONTENT_FREQUENT_URI ) não retornam resultados.

Geralmente, se algum dos elementos obsoletos da API Contacts Provider usar contadores, esses contadores (quando usados ​​no Android 10) conterão 0 e retornarão 0 quando consultados. As solicitações de atualização das APIs afetadas são ignoradas. Por exemplo, a classe ContactsContract.DataUsageFeedback foi preterida, portanto, as chamadas de atualização e exclusão para essa classe são ignoradas.

Campos que afetam as APIs

Estes campos foram alterados no Android 10:

Os campos afetados no Android 10 podem estar presentes em diferentes APIs, conforme indicado na tabela abaixo. Campos de API obsoletos retornam comportamentos conforme listado. Como um desses campos obsoletos pode ser usado em várias de suas APIs, verifique seus casos de uso.

Classe Campos de API 10 retornos
ContactsContract.Contacts
ContactsContract.RawContacts
ContactsContract.Data
ContactsContract.Entity		 ContactOptionsColumns
TIMES_CONTACTED
LAST_TIME_CONTACTED		 Essas colunas sempre contêm 0, independentemente de como são usadas. As tentativas de modificá-los são ignoradas.
Contacts markAsContacted() Nenhuma operação.
ContactsContract.DataUsageFeedback

update
delete

 Nenhuma operação.
ContactsContract.Contacts Estrequente (com estrela + frequente)
CONTENT_STREQUENT_FILTER_URI
CONTENT_STREQUENT_URI
CONTENT_FREQUENT_URI		 Retorna apenas contatos com estrela . Nenhum contato frequente retornou.
ContactsContract.CommonDataKinds.Email
ContactsContract.CommonDataKinds.Phone
ContactsContract.CommonDataKinds.Callable		 APIs de filtro (também chamadas de preenchimento automático)

CONTENT_FILTER_URI
ENTERPRISE_CONTENT_FILTER_URI

 Resultados não classificados por afinidade. Eles são classificados por com estrela e nome .

Alternativas

Não há alternativas para os campos de API obsoletos. Soluções alternativas projetadas para contornar essas restrições, seja na forma de novas APIs ou novos campos, não são permitidas.

Implementação

Você não precisa fazer nada para implementar essas mudanças. Eles fazem parte da iniciativa para aumentar a privacidade do usuário na plataforma Android OS. No entanto, se seus aplicativos contam com recursos obsoletos, convém atualizá-los para compensar quaisquer alterações. Além disso, se você usar uma versão bifurcada do Provedor de contatos, deverá atualizar seu Provedor de contatos.

Sem personalização

Não personalize ou contorne as alterações nas informações de afinidade dos contatos. Eles são incorporados à estrutura e qualquer alteração o tira da conformidade. Nunca altere as configurações padrão ou forneça alternativas de backdoor.