为了接收用户反馈,很多iOS应用都会在设置页面中,加入发送邮件功能——尤其当应用是由个人开发者开发时。当然iOS中邮件的发送方式有很多种,有体验相对较差openURL跳转方式,也有调用其他第三方库等办法。
不过较常用且方便的,还是如下图(应用为潮汐),调用系统的MFMailComposeViewController视图在应用内完成邮件发送,并返回应用。
下面就详解下这种方式的实现步骤。
一、建立静态列表
首先,拖一个Table View Controller到main.storyboard中,并选中Table View在右侧属性面板中将其设置为静态列表Static Cells。
为了演示方便这里就先创建一个Section,其中有两行Cell。两个Cell的Style都设置为Basic,并将Title修改如下。
下一步是建立这个Table View的Controller。新建一个Cocoa Touch Class文件,并选择Subclass of UITableViewController。
override func tableView(tableView: UITableView,didSelectRowAtIndexPath indexPath: NSIndexPath){ if indexPath.section == 0 && indexPath.row == 0 { print("给应用评分") } if indexPath.section == 0 && indexPath.row == 1 { print("意见反馈") } }
在模拟器中运行,点按Cell,检查output区中print的内容是否正常,然后就可以进入下一步。
二、MFMailComposeViewController
处理完UITableViewController以后,就可以开始调用邮件视图了。不过先不急着写代码,首先需要导入框架MessageUI.framework。在项目设置Build Phases的Link Binary With Libraries中添加MessageUI.framework。
然后在Controller里导入头文件import MessageUI。并给Controller加上MFMailComposeViewControllerDelegate协议。
上述步骤搞定后,就可以愉快地写代码了。首先先写个函数,来配置发邮件的视窗。
func configuredMailComposeViewController() -> MFMailComposeViewController { let mailComposeVC = MFMailComposeViewController() mailComposeVC.mailComposeDelegate = self //设置邮件地址、主题及正文 mailComposeVC.setToRecipients(["<你的邮箱地址>"]) mailComposeVC.setSubject("<邮件主题>") mailComposeVC.setMessageBody("<邮件正文>",isHTML: false) return mailComposeVC }
鉴于这种发送邮件的方式,要求用户已经在设备上至少添加有一个邮箱,所以对没有设置邮箱的用户,还应予以提示。因此这里再写一个函数,来配置针对未设置邮箱用户的弹窗提醒。
func showSendMailErrorAlert() { let sendMailErrorAlert = UIAlertController(title: "无法发送邮件",message: "您的设备尚未设置邮箱,请在“邮件”应用中设置后再尝试发送。",preferredStyle: .Alert) sendMailErrorAlert.addAction(UIAlertAction(title: "确定",style: .Default) { _ in }) self.presentViewController(sendMailErrorAlert,animated: true){} }
搞定这俩函数后,就可以在之前的tableView函数中调用两者了。
if indexPath.section == 0 && indexPath.row == 1 { print("意见反馈") if MFMailComposeViewController.canSendMail() { //注意这个实例要写在if block里,否则无法发送邮件时会出现两次提示弹窗(一次是系统的) let mailComposeViewController = configuredMailComposeViewController() self.presentViewController(mailComposeViewController,animated: true,completion: nil) } else { self.showSendMailErrorAlert() } }
func mailComposeController(controller: MFMailComposeViewController,didFinishWithResult result: MFMailComposeResult,error: NSError?) { switch result.rawValue { case MFMailComposeResultCancelled.rawValue: print("取消发送") case MFMailComposeResultSent.rawValue: print("发送成功") default: break } self.dismissViewControllerAnimated(true,completion: nil) }
三、加入设备及应用信息
为了获得更加准确的反馈信息,可以在邮件正文里加入反馈者的设备及应用信息。那怎样使用swift获得设备信息呢?可以如下通过UIDevice取得。
//获取设备名称 let deviceName = UIDevice.currentDevice().name //获取系统版本号 let systemVersion = UIDevice.currentDevice().systemVersion //获取设备的型号 let deviceModel = UIDevice.currentDevice().model //获取设备唯一标识符 let deviceUUID = UIDevice.currentDevice().identifierForVendor?.UUIDString
这里的设备型号deviceModel只能获知设备的简单区分(如是iPhone还是iPad),如果需要详细的iOS设备信息,还需要写一个UIDevice的扩展。
public extension UIDevice { var modelName: String { var systemInfo = utsname() uname(&systemInfo) let machineMirror = Mirror(reflecting: systemInfo.machine) let identifier = machineMirror.children.reduce("") { identifier,element in guard let value = element.value as? Int8 where value != 0 else { return identifier } return identifier + String(UnicodeScalar(UInt8(value))) } switch identifier { case "iPod5,1": return "iPod Touch 5" case "iPod7,1": return "iPod Touch 6" case "iPhone3,1","iPhone3,2",3": return "iPhone 4" case "iPhone4,1": return "iPhone 4s" case "iPhone5,"iPhone5,2": return "iPhone 5" case "iPhone5,3",4": return "iPhone 5c" case "iPhone6,"iPhone6,2": return "iPhone 5s" case "iPhone7,2": return "iPhone 6" case "iPhone7,1": return "iPhone 6 Plus" case "iPhone8,1": return "iPhone 6s" case "iPhone8,2": return "iPhone 6s Plus" case "iPad2,"iPad2,4":return "iPad 2" case "iPad3,"iPad3,3": return "iPad 3" case "iPad3,4",5",6": return "iPad 4" case "iPad4,"iPad4,3": return "iPad Air" case "iPad5,"iPad5,4": return "iPad Air 2" case "iPad2,6",7": return "iPad Mini" case "iPad4,6": return "iPad Mini 2" case "iPad4,7",8",9": return "iPad Mini 3" case "iPad5,2": return "iPad Mini 4" case "iPad6,"iPad6,8": return "iPad Pro" case "AppleTV5,3": return "Apple TV" case "i386","x86_64": return "Simulator" default: return identifier } } } //调用 let modelName = UIDevice.currentDevice().modelName
mailComposeVC.setMessageBody("\\n\\n\\n系统版本:\\(systemVersion)\\n设备型号:\\(modelName)",isHTML: false)
同理,也可以获得应用的相关信息。
let infoDic = NSBundle.mainBundle().infoDictionary // 获取App的版本号 let appVersion = infoDic?["CFBundleShortVersionString"] // 获取App的build版本 let appBuildVersion = infoDic?["CFBundleVersion"] // 获取App的名称 let appName = infoDic?["CFBundleDisplayName"]
到这里,一个调用UITableViewController的iOS邮件反馈就基本写完了。运行的时候,要注意用虚拟器的话可能会报错,测试需要真机环境。效果如下。