Aprire link, email e telefono in Flutter con url_launcher

Aggiungi la dipendenza url_launcher al progetto. Puoi usare il comando da terminale oppure inserirla manualmente nel file pubspec.yaml.

Dopo l'aggiunta, esegui flutter pub get per scaricare il pacchetto.

flutter pub add url_launcher

A partire dalle versioni recenti, Android e iOS richiedono di dichiarare esplicitamente gli schemi URL che l'app intende aprire.

Android: apri android/app/src/main/AndroidManifest.xml e aggiungi un blocco <queries> dentro il tag <manifest> (fuori da <application>).

iOS: apri ios/Runner/Info.plist e aggiungi le chiavi LSApplicationQueriesSchemes.

<!-- AndroidManifest.xml -->
<manifest ...>
  <queries>
    <intent>
      <action android:name="android.intent.action.VIEW" />
      <data android:scheme="https" />
    </intent>
    <intent>
      <action android:name="android.intent.action.DIAL" />
      <data android:scheme="tel" />
    </intent>
    <intent>
      <action android:name="android.intent.action.SENDTO" />
      <data android:scheme="mailto" />
    </intent>
  </queries>
</manifest>

<!-- Info.plist (iOS) -->
<key>LSApplicationQueriesSchemes</key>
<array>
  <string>https</string>
  <string>tel</string>
  <string>mailto</string>
  <string>sms</string>
</array>

Per evitare di ripetere codice, creiamo una funzione helper che riceve un Uri, verifica che possa essere aperto con canLaunchUrl e lo lancia con launchUrl. Restituiamo un bool per gestire eventuali errori nell'interfaccia.

Importa il pacchetto con import 'package:url_launcher/url_launcher.dart';.

import 'package:url_launcher/url_launcher.dart';

Future<bool> apriUri(Uri uri) async {
  if (await canLaunchUrl(uri)) {
    return await launchUrl(
      uri,
      mode: LaunchMode.externalApplication,
    );
  }
  return false;
}

Usa lo schema https per aprire una pagina web. Con LaunchMode.externalApplication il link viene aperto nel browser di sistema; puoi anche usare LaunchMode.inAppWebView per aprirlo dentro l'app.

Costruiamo l'Uri con Uri.parse e lo passiamo al nostro helper.

ElevatedButton(
  onPressed: () async {
    final url = Uri.parse('https://flutter.dev');
    final ok = await apriUri(url);
    if (!ok && context.mounted) {
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('Impossibile aprire il link')),
      );
    }
  },
  child: const Text('Apri flutter.dev'),
)

Per le telefonate si usa lo schema tel: seguito dal numero, mentre per gli SMS lo schema sms:. Puoi anche precompilare il corpo del messaggio tramite i query parameters.

Nota: la telefonata effettiva parte solo su dispositivi con capacità telefoniche; sull'emulatore potrebbe aprire solo il dialer.

// Telefonata
final tel = Uri(scheme: 'tel', path: '+390123456789');
await apriUri(tel);

// SMS con testo precompilato
final sms = Uri(
  scheme: 'sms',
  path: '+390123456789',
  queryParameters: {'body': 'Ciao dal mio app Flutter!'},
);
await apriUri(sms);

Con lo schema mailto: puoi aprire il client email di default con destinatario, oggetto e corpo già compilati. I parametri vanno passati come query parameters codificati.

Creiamo una funzione dedicata che costruisce correttamente l'Uri con la codifica dei caratteri speciali.

Future<void> inviaEmail() async {
  final email = Uri(
    scheme: 'mailto',
    path: 'supporto@esempio.it',
    queryParameters: {
      'subject': 'Richiesta informazioni',
      'body': 'Salve,\nvorrei maggiori dettagli su...',
    },
  );
  await apriUri(email);
}

Alcuni schemi (come tel o sms) funzionano solo su dispositivi fisici. È buona pratica mostrare sempre un feedback all'utente quando canLaunchUrl restituisce false.

Ricorda inoltre di controllare context.mounted prima di usare il BuildContext dopo un await, per evitare eccezioni se il widget è stato smontato.

Future<void> gestisciAzione(BuildContext context, Uri uri) async {
  final ok = await apriUri(uri);
  if (!context.mounted) return;
  if (!ok) {
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(content: Text('Azione non disponibile: ${uri.scheme}')),
    );
  }
}