Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev0.0.13

flutter_native_contact_picker

Um plug-in do Flutter para selecionar um contato da agenda de endereços.

AndroidiOS
Downloads em 30 dias
57,7 mil
Curtidas
82
Pontos Pub
160

Instalar pacote

flutter pub add flutter_native_contact_picker

Visão geral do pacote

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

Um plugin Flutter que permite aos usuários selecionar contatos diretamente da agenda nativa em dispositivos Android e iOS. Ele fornece uma interface nativa de plataforma para seleção de contatos, garantindo uma experiência consistente para o usuário entre plataformas. O plugin se integra ao sistema interno de contatos do dispositivo, permitindo acesso a detalhes dos contatos como nomes, números de telefone e emails. Foi projetado com simplicidade e confiabilidade, sendo ideal para aplicativos que precisam de integração com contatos sem precisar desenvolver seletores personalizados.

Casos de uso

  • Integrando a seleção de contatos em aplicativos de mensagens
  • Habilitar a criação de perfil do usuário por meio da importação de contatos
  • Facilitando o compartilhamento rápido de contatos
  • Apoio à agendamento de compromissos com pesquisa de contatos
  • Construindo ferramentas de CRM com recuperação de contatos

Principais recursos

  • Interface do usuário nativa de seleção de contatos no Android e no iOS
  • Acesso a detalhes de contato, como nome e número de telefone
  • API simples para seleção de contatos
  • Compatibilidade multiplataforma
  • Manipulação segura de dados com permissões da plataforma

Indicado para

  • Desenvolvedores construindo aplicativos de comunicação
  • Aplicativos que precisam de funcionalidade de importação de contatos
  • Ferramentas para geração de leads ou networking
  • Formulários móveis que exigem entrada de contato
  • Aplicações com fluxos de onboarding de usuário

Considerações

  • Requer permissão em tempo de execução no Android e no iOS
  • Pode não suportar todos os campos de contato (por exemplo, fotos)
  • Depende do banco de dados nativo de contatos do dispositivo
  • Personalização limitada da interface do seletor
  • Necessita de tratamento adequado de erros para negações de permissão

README original

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

flutter_native_contact_picker

With this plugin a Flutter app can ask its user to select a contact or contacts from their address book, with the option to select specific phone numbers. The information associated with the contacts is returned to the app.

This plugin uses the operating system's native UI for selecting contacts and does not require any special permissions from the user, even on Android.

Features

  • [x] iOS Support

    • Select single contact
    • Select multiple contacts
    • Select specific phone number from a contact
    • Returns all phone numbers for selected contacts
  • [x] Android Support

    • Select single contact
    • Select specific phone number from a contact
    • No READ_CONTACTS permission required

Usage

Basic Contact Selection
// Create an instance of the picker
final FlutterNativeContactPicker _contactPicker = FlutterNativeContactPicker();

// Select a single contact
Contact? contact = await _contactPicker.selectContact();
print(contact?.fullName);
print(contact?.phoneNumbers);

// Select multiple contacts (iOS only)
List<Contact>? contacts = await _contactPicker.selectContacts();
for (var contact in contacts ?? []) {
  print(contact.fullName);
  print(contact.phoneNumbers);
}
Phone Number Selection
// Select a specific phone number from a contact
Contact? contact = await _contactPicker.selectPhoneNumber();
print(contact?.fullName);
print(contact?.selectedPhoneNumber); // The specifically selected number
print(contact?.phoneNumbers); // All available numbers (iOS only)

Contact Model

The Contact class provides the following properties:

class Contact {
  final String? fullName;           // Contact's full name
  final List<String>? phoneNumbers; // All phone numbers (iOS: all numbers, Android: selected number only)
  final String? selectedPhoneNumber; // The specifically selected phone number when using selectPhoneNumber()
}

Platform Differences

iOS
  • Minimum iOS 13.0 (Swift Package Manager integration and Flutter FlutterFramework requirement)
  • Supports selecting multiple contacts
  • Returns all phone numbers associated with a contact
  • When using selectPhoneNumber(), returns both the selected number and all available numbers
  • Uses native CNContactPickerViewController
Android
  • Single contact selection only
  • When using selectPhoneNumber(), returns only the selected phone number
  • No READ_CONTACTS permission required
  • Uses native contact picker intent

Example

See the example directory for a complete sample app demonstrating all features.

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final FlutterNativeContactPicker _contactPicker = FlutterNativeContactPicker();
  List<Contact>? _contacts;
  String? _selectedPhoneNumber;

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Contact Picker Example App'),
        ),
        body: Center(
          child: Column(
            mainAxisSize: MainAxisSize.min,
            children: <Widget>[
              MaterialButton(
                color: Colors.blue,
                textColor: Colors.white,
                child: const Text("Select Contact"),
                onPressed: () async {
                  Contact? contact = await _contactPicker.selectContact();
                  setState(() {
                    _contacts = contact == null ? null : [contact];
                    _selectedPhoneNumber = null;
                  });
                },
              ),
              MaterialButton(
                color: Colors.green,
                textColor: Colors.white,
                child: const Text("Select Phone Number"),
                onPressed: () async {
                  Contact? contact = await _contactPicker.selectPhoneNumber();
                  setState(() {
                    _contacts = contact == null ? null : [contact];
                    _selectedPhoneNumber = contact?.selectedPhoneNumber;
                  });
                },
              ),
              if (_contacts != null) ...[
                ..._contacts!.map(
                  (contact) => Column(
                    children: [
                      Text(contact.fullName ?? 'No name'),
                      if (_selectedPhoneNumber != null)
                        Text('Selected: $_selectedPhoneNumber'),
                      ...?contact.phoneNumbers?.map((number) => Text(number)),
                    ],
                  ),
                ),
              ],
            ],
          ),
        ),
      ),
    );
  }
}

Categorias

Dependências

Lista de dependências 1 itens

  • plugin_platform_interface^2.0.2

Repositório-fonte

Projetos que usam este pacote