Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev0.6.3

contacts_service

Um plugin Flutter para recuperar e gerenciar contatos em dispositivos Android e iOS.

AndroidiOS
Downloads em 30 dias
2,9 mil
Curtidas
599
Pontos Pub
140

Instalar pacote

flutter pub add contacts_service

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

O pacote contacts_service é um plugin Flutter que permite aos desenvolvedores acessar e gerenciar contatos do dispositivo nas plataformas Android e iOS. Ele fornece uma API consistente para recuperar listas de contatos, ler detalhes dos contatos, como nomes, números de telefone e e-mails, e suporta operações básicas como filtragem e pesquisa. Projetado para compatibilidade entre plataformas, simplifica a integração com os sistemas nativos de contatos sem exigir código específico da plataforma. O pacote é ideal para aplicativos que precisam de funcionalidades de busca ou importação de contatos.

Casos de uso

  • Recuperação da lista de contatos
  • Busca e filtragem de contatos
  • Importando contatos para aplicativos
  • Sincronizando contatos com dados do aplicativo
  • Exibindo detalhes do contato na interface

Principais recursos

  • Suporte multiplataforma (Android e iOS)
  • API simples para acesso de contatos
  • Suporta campos de contato como nome, telefone, e-mail
  • Recursos de pesquisa e filtragem
  • Nenhum código nativo necessário

Indicado para

  • Aplicativos que precisam de acesso ao contato
  • Ferramentas de importação de perfil de usuário
  • Aplicativos de comunicação
  • Integrações de CRM
  • widgets de seleção de contatos

Considerações

  • Permissões em tempo de execução necessárias no Android e no iOS
  • Limitado a operações básicas de contato
  • Conformidade de privacidade necessária
  • Pode exigir consentimento do usuário para acesso
  • O desempenho depende do tamanho do banco de dados de contatos do dispositivo

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

contacts_service

pub package Build Status Coverage Status

A Flutter plugin to access and manage the device's contacts.

Usage

To use this plugin, add contacts_service as a dependency in your pubspec.yaml file.
For example:

dependencies:  
    contacts_service: ^0.6.3

Permissions

Android

Add the following permissions to your AndroidManifest.xml:

<uses-permission android:name="android.permission.READ_CONTACTS" />  
<uses-permission android:name="android.permission.WRITE_CONTACTS" />  
iOS

Set the NSContactsUsageDescription in your Info.plist file

<key>NSContactsUsageDescription</key>  
<string>This app requires contacts access to function properly.</string>  

Note
contacts_service does not handle the process of asking and checking for permissions. To check and request user permission to access contacts, try using the following plugins: flutter_simple_permissions or permission_handler.

If you do not request user permission or have it granted, the application will fail. For testing purposes, you can manually set the permissions for your test app in Settings for your app on the device that you are using. For Android, go to "Settings" - "Apps" - select your test app - "Permissions" - then turn "on" the slider for contacts.

Example

// Import package  
import 'package:contacts_service/contacts_service.dart';  
  
// Get all contacts on device
List<Contact> contacts = await ContactsService.getContacts();  

// Get all contacts without thumbnail (faster)
List<Contact> contacts = await ContactsService.getContacts(withThumbnails: false);

// Android only: Get thumbnail for an avatar afterwards (only necessary if `withThumbnails: false` is used)
Uint8List avatar = await ContactsService.getAvatar(contact);
  
// Get contacts matching a string
List<Contact> johns = await ContactsService.getContacts(query : "john");

// Add a contact  
// The contact must have a firstName / lastName to be successfully added  
await ContactsService.addContact(newContact);  
  
// Delete a contact
// The contact must have a valid identifier
await ContactsService.deleteContact(contact);  

// Update a contact
// The contact must have a valid identifier
await ContactsService.updateContact(contact);

// Usage of the native device form for creating a Contact
// Throws a error if the Form could not be open or the Operation is canceled by the User
await ContactsService.openContactForm();

// Usage of the native device form for editing a Contact
// The contact must have a valid identifier
// Throws a error if the Form could not be open or the Operation is canceled by the User
await ContactsService.openExistingContact(contact);

Contact Model

// Name
String displayName, givenName, middleName, prefix, suffix, familyName;

// Company
String company, jobTitle;

// Email addresses
List<Item> emails = [];

// Phone numbers
List<Item> phones = [];

// Post addresses
List<PostalAddress> postalAddresses = [];

// Contact avatar/thumbnail
Uint8List avatar;

Example

Contributions

Contributions are welcome! If you find a bug or want a feature, please fill an issue.

If you want to contribute code please create a pull request under the staging branch.

Credits

Heavily inspired from rt2zz's react native plugin

Categorias

Dependências

Lista de dependências 2 itens

Repositório-fonte

Projetos que usam este pacote