flutter_mailer

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Flutter Mailer ist ein Flutter-Paket, das Benutzern ermöglicht, E-Mails direkt aus ihrer App an den Standard-E-Mail-Client des Geräts zu teilen. Es unterstützt das Senden von E-Mails mit mehreren Anhängen und eignet sich daher hervorragend zum Teilen von Dokumenten, Bildern oder anderen Dateien. Das Paket integriert sich nahtlos in Android- und iOS-Plattformen und nutzt native E-Mail-Intents, um Kompatibilität und Zuverlässigkeit sicherzustellen. Es vereinfacht den Vorgang, einen E-Mail-Editor mit vordefinierten Empfängern, Betreff, Text und Anhängen zu starten.

Anwendungsfälle

Dokumente innerhalb einer App teilen
Support-Tickets mit Anlagen senden
Berichte oder Belege verteilen
Benutzerfeedback per E-Mail aktivieren
Automatisierung von E-Mail-Workflows in Apps

Hauptmerkmale

Unterstützt mehrere Dateianhänge
Verwendet native E-Mail-Clients unter Android und iOS
Einfache API für die E-Mail-Komposition
Plattformübergreifende Kompatibilität
Konfigurierbare E-Mail-Felder (An, Betreff, Inhalt)

Geeignet für

Apps, die Funktionen zum E-Mail-Teilen benötigen
dokumentenbasierte Anwendungen
Integrationen für Kundensupport
Berichterstattungs- oder Analysetools
Verteilung nutzergenerierter Inhalte

Hinweise

Beruht auf dem Standard-E-Mail-Client des Benutzers
Kein direktes E-Mail-Versenden ohne Benutzerinteraktion
Die Beschränkungen für Anhanggrößen hängen vom Gerät und dem Betriebssystem ab
Erfordert auf einigen Geräten die richtigen Berechtigungen
Die Erstellung von E-Mails kann sich leicht zwischen Plattformen unterscheiden

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

Share email content via device Email Client - supports multiple Attachments

Simple & quick plugin for cross application data sharing of email fields in mobile development.

Flutter Mailer example app

Supports:

[x] android
[x] ios

Getting Started

Add to your pubspec dependencies, like so:

dependencies:
  flutter:
    sdk: flutter
  flutter_mailer: ^3.0.0

Instantiate mail options as follows:

send email

import 'package:flutter_mailer/flutter_mailer.dart';

...
...

final MailOptions mailOptions = MailOptions(
  body: 'a long body for the email <br> with a subset of HTML',
  subject: 'the Email Subject',
  recipients: ['example@example.com'],
  isHTML: true,
  bccRecipients: ['other@example.com'],
  ccRecipients: ['third@example.com'],
  attachments: [ 'path/to/image.png', ],
);

final MailerResponse response = await FlutterMailer.send(mailOptions);
switch (response) {
  case MailerResponse.saved: /// ios only
    platformResponse = 'mail was saved to draft';
    break;
  case MailerResponse.sent: /// ios only
    platformResponse = 'mail was sent';
    break;
  case MailerResponse.cancelled: /// ios only
    platformResponse = 'mail was cancelled';
    break;
  case MailerResponse.android:
    platformResponse = 'intent was successful';
    break;
  default:
    platformResponse = 'unknown';
    break;
}

note gmail and other apps Might parse HTML out of the body.

[Android] check if app is installed.

use full if you want to send the intent to a specific App. returns false on [IOS]

const GMAIL_SCHEMA = 'com.google.android.gm';

final bool gmailinstalled =  await FlutterMailer.isAppInstalled(GMAIL_SCHEMA);

if(gmailinstalled) {
  final MailOptions mailOptions = MailOptions(
    body: 'a long body for the email <br> with a subset of HTML',
    subject: 'the Email Subject',
    recipients: ['example@example.com'],
    isHTML: true,
    bccRecipients: ['other@example.com'],
    ccRecipients: ['third@example.com'],
    attachments: [ 'path/to/image.png', ],
    appSchema: GMAIL_SCHEMA,
  );
  await FlutterMailer.send(mailOptions);
}

[IOS] check if device has the ability to send email

this package uses MFMailComposeViewController for [IOS] which requires the default mail App. if none is installed you might want to revert to use url_launcher returns false on [Android]


  final bool canSend = await FlutterMailer.canSendMail();

  if(!canSend && Platform.isIos) {
    final url = 'mailto:$recipient?body=$body&subject=$subject';
    if (await canLaunch(url)) {
      await launch(url);
    } else {
      throw 'Could not launch $url';
    }
  }
}