sms_mms 0.1.0

Opens the native messaging app on Android and iOS with recipients, a message and attachments filled in. Skips the app chooser on Android.

sms_mms

Opens the native messaging app with recipients, a message and attachments filled in. The user reviews the message and taps send.

• Android opens the default SMS app directly, without the app chooser.
• iOS presents the system compose sheet (MFMessageComposeViewController) and tells you whether the user sent or cancelled.

The plugin never sends a message by itself. See Sending without the user.

iOS	Android
demo video	demo video

Usage

import 'package:sms_mms/sms_mms.dart';

final result = await SmsMms.send(
  recipients: ['[phone]'],
  message: 'Here is the invoice',
  filePaths: [invoicePdf.path, photo.path], // optional
);

Parameter
recipients	Phone numbers. Use international format (+49…); otherwise the messaging app may add its own country prefix.
message	The message body.
filePath	One attachment. Kept for compatibility with 0.0.x.
filePaths	Any number of attachments. Combined with filePath, which goes first.

No setup is needed in your app: the plugin brings its own FileProvider and manifest entries.

What send returns

Platform	Result
iOS	SmsMmsResult.sent, .cancelled or .failed, when the user closes the sheet.
Android	SmsMmsResult.unknown, as soon as the messaging app opens.

Android messaging apps do not report whether the user sent the message, so the plugin does not guess. To run code when the user comes back to your app, listen for the app resuming:

final result = await SmsMms.send(recipients: numbers, message: text);
if (result == SmsMmsResult.unknown) {
  // Android: wait for AppLifecycleState.resumed, e.g. with AppLifecycleListener.
}

Errors

send throws a PlatformException with one of these codes:

Code	Platform	Meaning
no_sms_app	Android	No installed app can send messages or accept the attachment type.
file_not_found	both	An attachment is missing or unreadable (iOS: or of a type Messages rejects).
device_not_capable	iOS	The device cannot send messages, or cannot send attachments.
message_not_sent	iOS	Running on the simulator, which cannot send messages.
already_open	iOS	A compose sheet from an earlier call is still open.
no_view_controller	iOS	No view controller was available to present the sheet.

How attachments work on Android

Each file is copied into the app's cache directory (cache/sms_mms/) and shared through a content URI, so the plugin can attach files from any path your app can read without exposing the rest of its storage. Copies older than a day are cleared on the next send.

Sending without the user

Not supported, on purpose. iOS has no API for it. On Android it needs the SEND_SMS permission, which Google Play only allows for apps that are the default SMS handler.

Platform support

Android (API 21+) and iOS (13+). Earlier versions listed web and desktop, but they had no implementation and were removed in 0.1.0.