Электронная почта — один из лучших каналов связи в 21 веке. Информация может быть доставлена ​​группе получателей за несколько секунд. Вы когда-нибудь думали об интеграции функции электронной почты в свое приложение?

Apple предоставила простую в использовании платформу MessageUIдля разработчиков. Мы можем настроить следующие свойства:

1. Список получателей
2. Предмет
3. Тело сообщения
4. Вложения

Пошаговая процедура

Шаг 1) Проверьте, может ли устройство отправлять электронную почту

import MessageUI

// Confirm the user can send email
guard MFMailComposeViewController.canSendMail() else { return }

1. Пользователь приложения еще не настроил свою учетную запись электронной почты в системном почтовом приложении.

2. Профиль iOS MDM отключил функцию рассылки, ссылаясь на этот ответ StackOverflow .

Шаг 2) Настройте экземпляр MFMailComposeViewController

// Construct the `MFMailComposeViewController` instance
let mfMailComposeViewController = MFMailComposeViewController()

// To set the recipients list, including the to, cc and bcc fields
mfMailComposeViewController.setToRecipients(["[email protected]"])
mfMailComposeViewController.setCcRecipients(["[email protected]"])
mfMailComposeViewController.setBccRecipients(["[email protected]"])

// To set the email subject
mfMailComposeViewController.setSubject("Example - Subject Text")

// To set the email message body; It can be either plain text or HTML message
mfMailComposeViewController.setMessageBody("<h1>Example - HTML message body </h1>", isHTML: true)

// Presenet the `MFMailComposeViewController` to the app user
present(mfMailComposeViewController, animated: true)

1. Список получателей, включая to, cc&bcc
2. Тематическое поле
3. Тело сообщения в виде простого текста или HTML-сообщения .

Шаг 3) Закройте MFMailComposeViewController вручную

// We must implement the `MFMailComposeViewControllerDelegate` in order to handle the user's action on the mail compo
mfMailComposeViewController.mailComposeDelegate = self

extension DemoViewController: MFMailComposeViewControllerDelegate {
    
  // This is the only callback from the Mail composer to notify the app that the user has carried out certain action
    func mailComposeController(_ controller: MFMailComposeViewController, didFinishWith result: MFMailComposeResult, error: Error?) {
        switch result {
        case .cancelled:
            print("The user has dismissed the mail composer and deleted the email draft.")
            
        case .saved:
            print("The user has dismissed the mail composer and saved the email draft.")
            
        case .sent:
            // The email request is queued in the user's mail app
            // There is no guarantee that the email is actually sent out!!!
            print("The user has \"sent\" the email out.")
            
        case .failed:
            print("The user cannot send out the email")
            print("Error of sending out the email: \(error.debugDescription)")
            
        }
        controller.dismiss(animated: true)
    }
}

Существует также resultсвойство для отображения действий пользователя, в том числе:

1. cancelled— Пользователь нажал кнопку «Отмена», а затем удалил черновик письма.
2. saved— Пользователь нажал кнопку «Отмена», а затем сохранил черновик письма.
3. sent— Пользователь *отправил* электронное письмо
4. fail— Произошла ошибка в очереди письма в почтовое приложение

Уловка — ДЕЙСТВИТЕЛЬНО ли отправлено электронное письмо, когда возвращается результат «отправлено»?

Вы пытались отправить электронное письмо, когда нет подключения к сети, например, в режиме полета? О НЕТ ! Обратный didFinishWithвызов MFMailComposeViewControllerDelegateфактически возвращает sentрезультат!!!

Что это обозначает?

В соответствии с приведенной ниже документацией Apple, MFMailComposeViewControllerнужно только отправить запрос в системную почтовую программу, чтобы поставить электронное письмо в очередь, а не отправлять его !!!

Официальная документация Apple — mailComposeController(_:didFinishWith:error:):

Если пользователь решил отправить электронное письмо, созданное этим интерфейсом, это электронное письмо должно быть поставлено в очередь в почтовой программе пользователя к моменту вызова этого метода . Если при постановке сообщения электронной почты в очередь произошла ошибка, errorпараметр содержит объект ошибки, указывающий тип возникшей ошибки.

Другими словами, приложение НИКОГДА не может знать, успешно ли отправлено электронное письмо получателям.

Расширенная функция - добавление вложения в электронное письмо

Отправка вложений — редкая функция в большинстве случаев использования. Тем не менее, MFMailComposeViewControllerпозволяет нам прикрепить список вложений в любом формате файла к составленному письму.

// Attach an image to the composed email
let attachmentImageData = UIImage(named: "example_image_name")!.pngData()!
mfMailComposeViewController.addAttachmentData(attachmentImageData, mimeType: "image/png", fileName: "example_file_name")

Учить больше

Есть много других способов отправки электронных писем. Firebase Extension Trigger Email предоставляет простой в использовании инструмент, помогающий разработчикам отправлять электронные письма путем создания документа Firestore с определенными предопределенными полями. Ниже мой другой блог о расширении триггерной электронной почты. Вы можете прочитать его, если хотите узнать о нем больше.

Расширение Firebase — триггерная электронная почта

Заключение

Apple предоставляет простую в использовании MessageUIструктуру, помогающую приложениям отправлять электронные письма, делегируя задание системному почтовому приложению. Приложение может установить список получателей, тему, тело сообщения и список вложений. Как только пользователь выполняет какие-либо действия, MFMailComposeViewControllerDelegateрезультат возвращается обратно, и приложение должно закрыть его MFMailComposeViewControllerвручную.

Имейте в виду, что sentрезультат на MFMailComposeViewControllerDelegateсамом деле не означает, что электронное письмо отправлено. Запрос по электронной почте ставится в очередь только в системном почтовом приложении!

Надеюсь, вам понравится этот блог и хорошего дня!