contactos 2.1.0

Plugin to access and manage contacts on Android and iOS.

example/lib/main.dart

import 'package:contactos_example/src/screens/contacts_list_screen.dart';
import 'package:contactos_example/src/screens/navite_contacts_picker_screen.dart';
import 'package:flutter/material.dart';
import 'package:permission_handler/permission_handler.dart';

void main() => runApp(const ContactsExampleApp());

/// iOS only: Localized labels language setting
/// is equal to CFBundleDevelopmentRegion value (Info.plist) of the iOS project
/// Set iOSLocalizedLabels=false if you always want english labels
/// whatever is the CFBundleDevelopmentRegion value.
const iOSLocalizedLabels = false;

/// {@template main}
/// Example app for the `contactos` plugin.
/// {@endtemplate}
class ContactsExampleApp extends StatelessWidget {
  /// {@macro main}
  const ContactsExampleApp({super.key});

  @override
  Widget build(BuildContext context) => MaterialApp(
        home: const _HomePage(),
        routes: <String, WidgetBuilder>{
          '/add': (_) => const AddContactScreen(),
          '/contacts-list': (_) => const ContactsListScreen(),
          '/native-contacts-picker': (_) => const NativeContactsPickerScreen(),
        },
      );
}

class _HomePage extends StatefulWidget {
  const _HomePage({
    super.key, // ignore: unused_element_parameter
  });

  @override
  State<_HomePage> createState() => __HomePageState();
}

class __HomePageState extends State<_HomePage> {
  @override
  void initState() {
    super.initState();
    _askPermissions();
  }

  Future<void> _askPermissions([String? routeName]) async {
    final navigator = Navigator.of(context);
    final permissionStatus = await _getContactPermission();
    if (permissionStatus == PermissionStatus.granted) {
      if (routeName != null) await navigator.pushNamed(routeName);
    } else {
      _handleInvalidPermissions(permissionStatus);
    }
  }

  Future<PermissionStatus> _getContactPermission() async {
    final permission = await Permission.contacts.status;
    if (permission != PermissionStatus.granted &&
        permission != PermissionStatus.permanentlyDenied) {
      final permissionStatus = await Permission.contacts.request();
      return permissionStatus;
    } else {
      return permission;
    }
  }

  void _handleInvalidPermissions(PermissionStatus permissionStatus) {
    Widget? content;
    if (permissionStatus == PermissionStatus.denied) {
      content = const Text('Access to contact data denied');
    } else if (permissionStatus == PermissionStatus.permanentlyDenied) {
      content = const Text('Contact data not available on device');
    }
    if (content == null) return;
    ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: content));
  }

  @override
  Widget build(BuildContext context) => Scaffold(
        appBar: AppBar(title: const Text('Contacts Plugin Example')),
        body: SafeArea(
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.stretch,
            children: <Widget>[
              ElevatedButton(
                child: const Text('Contacts list'),
                onPressed: () => _askPermissions('/contacts-list'),
              ),
              ElevatedButton(
                child: const Text('Native Contacts picker'),
                onPressed: () => _askPermissions('/native-contacts-picker'),
              ),
            ],
          ),
        ),
      );
}