googlecode http://code.google.com/p/skpsmtpmessage/
svn checkout http://skpsmtpmessage.googlecode.com/svn/trunk/ skpsmtpmessage-read-only
github:
git clone https://github.com/kailoa/iphone-smtp.git
skpsmtpmessage 是由Skorpiostech, Inc.为我们带来的一个SMTP协议的开源实现,使用Objective-c 实现,iOS系统的项目可以直接调用 =]
skpsmtpmessage能够实现不使用iOS系统提供的发送email的两种方法,发送email的功能。
iOS系统框架提供的两种发送Email的方法
使用openURL来实现发邮件的功能:
NSString *url = [NSString stringWithString: @"mailto:[email protected][email protected]&subject=Greetings%20from%20Cupertino!&body=Wish%20you%20were%20here!"]; [[UIApplication sharedApplication] openURL: [NSURL URLWithString: url]];
缺点很明显,这样的过程会导致程序暂时退出,即使在iOS 4.x支持多任务的情况下,这样的过程还是会让人觉得不是很方便。这对于开发者而言应该是最简单的实现了,也是在iOS3.0以下唯一的方法来实现发送 Email,但是现在也可以使用MFMailComposeViewController来实现发邮件的功能,它在 MessageUI.framework中,你需要在项目中加入该框架,并在使用的文件中导入 MFMailComposeViewController.h头文件。
#import <MessageUI/MFMailComposeViewController.h>; MFMailComposeViewController* controller = [[MFMailComposeViewController alloc] init]; controller.mailComposeDelegate = self; [controller setSubject:@"My Subject"]; [controller setMessageBody:@"Hello there." isHTML:NO]; [self presentModalViewController:controller animated:YES]; [controller release];
使用该方法实现发送Email是最常规的方法,该方法有相应的MFMailComposeViewControllerDelegate事件:
- (void)mailComposeController:(MFMailComposeViewController*)controller didFinishWithResult:(MFMailComposeResult)result error:(NSError*)error; { if (result == MFMailComposeResultSent) { NSLog(@"It's away!"); } [self dismissModalViewControllerAnimated:YES]; }
有一些相关的数据结构的定义在头文件中都有具体的描述:
enum MFMailComposeResult { MFMailComposeResultCancelled,//用户取消编辑邮件 MFMailComposeResultSaved,//用户成功保存邮件 MFMailComposeResultSent,//用户点击发送,将邮件放到队列中 MFMailComposeResultFailed//用户试图保存或者发送邮件失败 };
typedef enum MFMailComposeResult MFMailComposeResult; // iOS3.0以上有效
在头文件中MFMailComposeViewController的部分方法顺便提及:
+ (BOOL)canSendMail __OSX_AVAILABLE_STARTING(__MAC_NA,__IPHONE_3_0);
//如果用户没有设置邮件账户,则会返回NO,你可以用根据返回值来决定是使用MFMailComposeViewController 还是 mailto://的传统方法,也或者,你可以选择上文中提到的skpsmtpmessage来实现发送Email的功能。
- (void)addAttachmentData:(NSData *)attachment mimeType:(NSString *)mimeType fileName:(NSString *)filename;
//NSData类型的attachment自然不必多说,关于mimeType需要一点说明,官方文档里给出了一个链接http://www.iana.org/assignments/media-types/ ,这里列出的所有的类型都应该支持。关于mimeType的用处,更多需要依靠搜索引擎了 =]
第二种方法的劣势也很明显,iOS系统替我们提供了一个mail中的UI,而我们却完全无法对齐进行订制,这会让那些定制化成自己风格的App望而却步,因为这样使用的话无疑太突兀了。
因此在这里使用第三方的发送邮件的实现就比较合适,我们可以根据自己的UI设计需求来定制相应的视图以适应整体的设计。
在SKPSMTPMessage类中,并没有对视图进行任何的要求,它提供的都是数据层级的处理,你之需要定义好相应的发送要求就可以实现邮件发送了。至于是以什么样的方式获取这些信息,就可以根据软件的需求来确定交互方式和视图样式了。
SKPSMTPMessage *testMsg = [[SKPSMTPMessage alloc] init]; testMsg.fromEmail = @"[email protected]"; testMsg.toEmail =@"[email protected]"; testMsg.relayHost = @"smtp.gmail.com"; testMsg.requiresAuth = YES; testMsg.login = @"[email protected]"; testMsg.pass = @"test"; testMsg.subject = [NSString stringWithCString:"测试" encoding:NSUTF8StringEncoding]; testMsg.bccEmail = @"[email protected]"; testMsg.wantsSecure = YES; // smtp.gmail.com doesn't work without TLS! // Only do this for self-signed certs! // testMsg.validateSSLChain = NO; testMsg.delegate = self; NSDictionary *plainPart = [NSDictionary dictionaryWithObjectsAndKeys:@"text/plain",kSKPSMTPPartContentTypeKey, [NSString stringWithCString:"测试正文" encoding:NSUTF8StringEncoding],kSKPSMTPPartMessageKey,@"8bit",kSKPSMTPPartContentTransferEncodingKey,nil]; NSString *vcfPath = [[NSBundle mainBundle] pathForResource:@"test" ofType:@"vcf"]; NSData *vcfData = [NSData dataWithContentsOfFile:vcfPath]; NSDictionary *vcfPart = [NSDictionary dictionaryWithObjectsAndKeys:@"text/directory;\r\n\tx-unix-mode=0644;\r\n\tname=\"test.vcf\"",kSKPSMTPPartContentTypeKey, @"attachment;\r\n\tfilename=\"test.vcf\"",kSKPSMTPPartContentDispositionKey,[vcfData encodeBase64ForData],kSKPSMTPPartMessageKey,@"base64",kSKPSMTPPartContentTransferEncodingKey,nil]; testMsg.parts = [NSArray arrayWithObjects:plainPart,vcfPart,nil]; [testMsg send];
该类也提供了相应的Delegate方法来让你更好的获知发送的状态.
-(void)messageSent:(SKPSMTPMessage *)message; -(void)messageFailed:(SKPSMTPMessage *)message error:(NSError *)error;