您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

搖一搖就截圖:iOS 內建 Bug 回報流程的實作教學

編輯:iOS 相關資訊

測試人員回報 Bug 的流程,通常是這樣一長串:截圖 → 開相簿挑圖 → 打字描述 → 丟進缺陷管理系統或寄信給開發者。每一步都不難,但累積起來非常耗時,而且截圖往往來不及、脈絡也斷了。

如果把這串流程壓縮成一個動作——搖一搖手機,App 自動截圖存進沙盒,並直接跳到回報頁面讓測試人員語音描述問題,最後連圖帶文送到開發者手上——測試效率會完全不同。以下示範怎麼做。

用 Category 把功能掛到所有 ViewController 上

與其替每個頁面各寫一遍,還不如寫一個 UIViewController 的分類(Category),一次搞定全 App。

UIViewController+ShakeAndCutter.h

#import <UIKit/UIKit.h>

@interface UIViewController (ShakeAndCutter)
@end

UIViewController+ShakeAndCutter.m

#import "UIViewController+ShakeAndCutter.h"
#import <QuartzCore/QuartzCore.h>
#import "TestFeedbackViewController.h"

@implementation UIViewController (ShakeAndCutter)

- (BOOL)canBecomeFirstResponder {
    return YES;
}

#pragma mark - 搖一搖事件處理

- (void)motionBegan:(UIEventSubtype)motion withEvent:(UIEvent *)event {
    NSLog(@"began");
}

- (void)motionCancelled:(UIEventSubtype)motion withEvent:(UIEvent *)event {
    NSLog(@"cancel");
}

- (void)motionEnded:(UIEventSubtype)motion withEvent:(UIEvent *)event {
    NSLog(@"end");
    [self cutterViewToDocument];

    // 這裡導向我自訂的問題回報頁,也可以改成直接開系統郵件
    TestFeedbackViewController *vc =
        [[[TestFeedbackViewController alloc]
            initWithNibName:@"TestFeedbackViewController" bundle:nil] autorelease];
    [self.navigationController pushViewController:vc animated:YES];
}

#pragma mark - 截圖處理

- (void)cutterViewToDocument {
    UIWindow *screenWindow = [[UIApplication sharedApplication] keyWindow];

    UIGraphicsBeginImageContext(screenWindow.frame.size);
    [screenWindow.layer renderInContext:UIGraphicsGetCurrentContext()];
    UIImage *screenShot = UIGraphicsGetImageFromCurrentImageContext();
    UIGraphicsEndImageContext();

    NSData *screenShotPNG = UIImagePNGRepresentation(screenShot);
    NSError *error = nil;
    [screenShotPNG writeToFile:
        [[NSHomeDirectory() stringByAppendingPathComponent:@"Documents"]
            stringByAppendingPathComponent:@"error.png"]
        options:NSAtomicWrite error:&error];
}

@end

原理不複雜:motionEnded:withEvent: 是 iOS 針對「搖動」這類動作事件的統一入口,只要 view controller 能成為 first responder,就能收到。截圖則是把 keyWindow 的 layer 反繪(render)進一個 bitmap context,再取出 UIImage、轉成 PNG 寫進 Documents 目錄。

怎麼在專案裡啟用

iOS 6.0 以上:只要在專案的 pch 預編譯標頭檔加上 #import "UIViewController+ShakeAndCutter.h",全 App 頁面立刻都支援搖一搖。測試結束要關掉功能時,也只要把這行註解掉即可,不必回頭改任何頁面——這是 Category 最迷人的地方。(此寫法已在 iOS 6.0.1、6.1.5、7.0.6 實機驗證過。)

iOS 6.0 以下:可能需要手動在需要的頁面補上幾行程式碼。

  • viewDidLoad 中:
    [[UIApplication sharedApplication] setApplicationSupportsShakeToEdit:YES];
    [self becomeFirstResponder];
    
  • viewDidAppear 中:
    [self becomeFirstResponder];
    
  • viewDidDisappear 中:
    [self resignFirstResponder];
    

把截圖當附件寄出去

截圖存好之後,用 MessageUI 框架就能直接叫出系統郵件編輯器並附上圖片。關鍵在於先判斷裝置是否支援寄信,避免在模擬器或未設定帳號的機器上直接崩潰。

MailViewController.h

#import <UIKit/UIKit.h>
#import <MessageUI/MessageUI.h>

@interface MailViewController : UIViewController
<MFMailComposeViewControllerDelegate>
{
    UIButton *shareToMailButton;
}
@end

MailViewController.m 的核心片段:

- (void)showMailPicker {
    Class mailClass = NSClassFromString(@"MFMailComposeViewController");

    if (mailClass != nil) {
        if ([mailClass canSendMail]) {
            [self displayMailComposerSheet];
        } else {
            UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@""
                message:@"設備不支持郵件功能" delegate:nil
                cancelButtonTitle:@"確定" otherButtonTitles:nil];
            [alert show];
            [alert release];
        }
    }
}

- (void)displayMailComposerSheet {
    MFMailComposeViewController *picker = [[MFMailComposeViewController alloc] init];
    picker.mailComposeDelegate = self;

    [picker setSubject:@"Bug反饋"];
    [picker setToRecipients:[NSArray arrayWithObject:@"收件者@example.com"]];
    // 也能加抄送與密送:
    // [picker setCcRecipients:@[@"cc@example.com"]];
    // [picker setBccRecipients:@[@"bcc@example.com"]];

    // 把剛剛存下的截圖當附件;其他格式也能先轉成 NSData 再指定 mimeType
    NSData *myData = [NSData dataWithContentsOfFile:
        [[NSHomeDirectory() stringByAppendingPathComponent:@"Documents"]
            stringByAppendingPathComponent:@"error.png"]];
    [picker addAttachmentData:myData
                     mimeType:@"image/png"
                     fileName:@"error.png"];

    [picker setMessageBody:@"測試人員的描述內容" isHTML:YES];
    [self presentModalViewController:picker animated:YES];
    [picker release];
}

- (void)mailComposeController:(MFMailComposeViewController *)controller
        didFinishWithResult:(MFMailComposeResult)result
                      error:(NSError *)error {
    switch (result) {
        case MFMailComposeResultCancelled: NSLog(@"郵件發送取消"); break;
        case MFMailComposeResultSaved:     NSLog(@"郵件已儲存"); break;
        case MFMailComposeResultSent:      NSLog(@"郵件發送成功"); break;
        case MFMailComposeResultFailed:    NSLog(@"郵件發送失敗"); break;
        default:                           NSLog(@"郵件未發送"); break;
    }
    [self dismissModalViewControllerAnimated:YES];
}

附件格式的選擇上,PNG 的 mimeType 是 image/png;實務上常見的還有 txt 用 text/plain、PDF 用 application/pdf。原則是先把檔案轉成 NSData,再對應正確的 MIME 類型。

延伸應用

同一套「搖一搖 → 截圖 → 回報」的骨架,替換掉後面的回報頁就能延伸出很多變化:使用者意見回饋、 crashes 現場留存、Beta 測試問卷,甚至加上地圖座標與裝置資訊一起送出。若描述文字想走語音輸入,接上第三方語音 SDK(如訊飛)即可,測試人員連打字都省了。

要注意的是,正式上線版本通常會把這個入口關閉或加 gating,避免使用者誤觸就彈出回報頁;常見做法是只在 Debug 建置或內部簽章的 build 中啟用。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved