آموزش ارسال ایمیل با قابلیت Attachment در iOS

نحوه ایجاد Email با قابلیت Attachment

در این جلسه می خواهیم نحوه ضمیمه کردن فایل هایی مانند تصاویر ، اسناد PDF یا پاورپوینت را در یک ایمیل آموزش دهیم. کلاس  MessageUI framework واقعاً امکان ارسال ایمیل در اپ ها را ساده نموده است. اگر اسناد رسمی فریم ورک MessageUI را مطالعه نمایید ، با کلاس MFMailComposeViewController  آشنا می شوید که یک متد به نام “addAttachmentData:” را فراخوانی می نماید ، تا بتوان هر نوع فایلی را به عنوان ضمیمه (attachment) به ایمیل ها اضافه نمود.

نگاهی به اپ Demo

از آن جایی که تمرکز اصلی این آموزش بر روی نشان دادن کاربرد قابلیت attachment می باشد ، اپ demo را بسیار ساده نگه خواهیم داشت. این اپ به سادگی ، لیستی از فایل ها را در یک table view ساده نمایش می دهد. ما table view را با انواع مختلفی از فایل ها پر خواهیم کرد ، از جمله فرمت PNG و JPEG ، Microsoft Word document ، PowerPoint ، سند PDF و فایل HTML. هنگامی که کاربر بر روی هر کدام از این فایل ها ضربه بزند ، اپ به طور خودکار یک ایمیل را با فایل انتخاب شده به عنوان ضمیمه خواهد ساخت.

شروع کار با تمپلت پروژه Xcode

برای رهایی از ایجاد پروژه Xcode از ابتدا ، می توانید تمپلت پروژه را از اینجا download this project template  دانلود نموده و کار توسعه را با آن شروع نمایید. تمپلت پروژه با موارد ذیل همراه است:

• Storyboard از پیش ساخته شده با یک table view controller برای نمایش دادن لیستی از فایل ها.
• یک کلاس AttachmentTableViewController .
• یک مجموعه از فایل هایی که برای attachment موردنیاز هستند.
• یک مجموعه از آیکون های رایگان از Pixeden.

پس از دانلود و extract نمودن فایل زیپ شده ، اپ را کامپایل و پروژه را اجرا می نماییم. اپ demo باید لیستی از فایل ها را در main view نمایش دهد. اکنون ، برای پیاده سازی عملکرد email کار را ادامه می دهیم.

ایجاد Email با استفاده از فریم ورک MessageUI

ابتدا ، عبارت import را اضافه کرده و در فایل “AttachmentTableViewController.m” نماینده “MFMailComposeViewControllerDelegate” را پیاده سازی می کنیم:

#import <MessageUI/MessageUI.h>
 
@interface AttachmentTableViewController () <MFMailComposeViewControllerDelegate>

در ادامه ، کد زیر را در همان فایل اضافه می نماییم:

- (void)showEmail:(NSString*)file {
 
    NSString *emailTitle = @"Great Photo and Doc";
    NSString *messageBody = @"Hey, check this out!";
    NSArray *toRecipents = [NSArray arrayWithObject:@"support@appcoda.com"];
    
    MFMailComposeViewController *mc = [[MFMailComposeViewController alloc] init];
    mc.mailComposeDelegate = self;
    [mc setSubject:emailTitle];
    [mc setMessageBody:messageBody isHTML:NO];
    [mc setToRecipients:toRecipents];
    
    // Determine the file name and extension
    NSArray *filepart = [file componentsSeparatedByString:@"."];
    NSString *filename = [filepart objectAtIndex:0];
    NSString *extension = [filepart objectAtIndex:1];
    
    // Get the resource path and read the file using NSData
    NSString *filePath = [[NSBundle mainBundle] pathForResource:filename ofType:extension];
    NSData *fileData = [NSData dataWithContentsOfFile:filePath];
    
    // Determine the MIME type
    NSString *mimeType;
    if ([extension isEqualToString:@"jpg"]) {
        mimeType = @"image/jpeg";
    } else if ([extension isEqualToString:@"png"]) {
        mimeType = @"image/png";
    } else if ([extension isEqualToString:@"doc"]) {
        mimeType = @"application/msword";
    } else if ([extension isEqualToString:@"ppt"]) {
        mimeType = @"application/vnd.ms-powerpoint";
    } else if ([extension isEqualToString:@"html"]) {
        mimeType = @"text/html";
    } else if ([extension isEqualToString:@"pdf"]) {
        mimeType = @"application/pdf";
    }
    
    // Add attachment
    [mc addAttachmentData:fileData mimeType:mimeType fileName:filename];
    
    // Present mail view controller on screen
    [self presentViewController:mc animated:YES completion:NULL];
    
}
 
- (void) mailComposeController:(MFMailComposeViewController *)controller didFinishWithResult:(MFMailComposeResult)result error:(NSError *)error
{
    switch (result)
    {
        case MFMailComposeResultCancelled:
            NSLog(@"Mail cancelled");
            break;
        case MFMailComposeResultSaved:
            NSLog(@"Mail saved");
            break;
        case MFMailComposeResultSent:
            NSLog(@"Mail sent");
            break;
        case MFMailComposeResultFailed:
            NSLog(@"Mail sent failure: %@", [error localizedDescription]);
            break;
        default:
            break;
    }
    
    // Close the Mail Interface
    [self dismissViewControllerAnimated:YES completion:NULL];
}

وارد جزئیات متد “didFinishWithResult:” نمی شویم. این متد از پروتکل MFMailComposeViewControllerDelegate می باشد و باید پیاده سازی شود. برای اطلاع از عملکرد این متد ، می توانید به جلسه نحوه ارسال ایمیل در اپ iOS با استفاده از فریم ورک MessageUI از دوره تکمیلی آموزش برنامه نویسی iOS مراجعه نمایید.

بسیار خوب! بیایید وارد متد “showEmail” شویم. خطوط 3- 5 از کد فوق ، یک موضوع ایمیل (subject) ، محتوای پیام (message content) و گیرنده ها (recipients) را تعریف می نماید. خط 7 یک MFMailComposeViewController داخلی را ایجاد می کند که رابط کاربری استاندارد برای مدیریت ویرایش و ارسال نمودن یک پیام ایمیل را ایجاد می نماید. ما فیلدهای view را با مقادیر اولیه ، شامل گیرنده ایمیل ، subject و متن بدنه پر می کنیم.

برای افزودن یک فایل ضمیمه ، تمام کاری که باید انجام دهیم ، فراخوانی متد “addAttachmentData” از پروتکل MFMailComposeViewController می باشد.

[mc addAttachmentData:fileData mimeType:mimeType fileName:filename];

این متد سه پارامتر را می گیرد:

• اطلاعاتی که باید ضمیمه شوند – این اطلاعات محتواهایی از یک فایل می باشند که می خواهیم ارسال کنیم.
• نوع MIME – MIME اختصار Multipurpose Internet Mail Extensions می باشد. به طور خلاصه ، MIME یک استاندارد اینترنتی می باشد و روشی را برای ارسال انواع اطلاعات در ایمیل (مانند اطلاعات گرافیکی) تعریف می کند. اینجا ، MIME type  ، نوع داده برای attach شدن را مشخص می کند. برای نمونه ، MIME type  یک تصویر PNG به صورت image/png است. می توانید برای دسترسی به لیست کاملی از انواع MIME به آدرس  http://www.iana.org/assignments/media-types/ مراجعه نمایید.
• نام فایل – این نام مربوط به فایل آماده شده برای ضمیمه می باشد.

خطوط 13-36 از کد فوق ، برای تعیین محتوای این پارامترها مورد استفاده قرار می گیرند. ابتدا مسیر فایل را تعیین کرده و یک شیء NSData برای آن فایل ایجاد می کنیم ، سپس ، نوع MIME را مشخص می کنیم. در نهایت ، متد addAttachmentData را برای ضمیمه کردن فایل ، فراخوانی می کنیم.

تقریباً تمام کارها را انجام داده ایم . آخرین کار ، تغییر متد “didSelectRowAtIndexPath” با کد زیر می باشد:

- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
{
    NSString *selectedFile = [_files objectAtIndex:indexPath.row];
    [self showEmail:selectedFile];
}

کامپایل و اجرا نمودن اپ

بسیار خوب پیش آمده ایم. اکنون زمان کامپایل و اجرا نمودن اپ می باشد. یکی از فایل ها را انتخاب می کنیم. اپ ، یک ایمیل را که حاوی فایل انتخاب شده در بخش attachment می باشد ، خواهد ساخت.