測試人員回報 Bug 的流程,通常是這樣一長串:截圖 → 開相簿挑圖 → 打字描述 → 丟進缺陷管理系統或寄信給開發者。每一步都不難,但累積起來非常耗時,而且截圖往往來不及、脈絡也斷了。
如果把這串流程壓縮成一個動作——搖一搖手機,App 自動截圖存進沙盒,並直接跳到回報頁面讓測試人員語音描述問題,最後連圖帶文送到開發者手上——測試效率會完全不同。以下示範怎麼做。
與其替每個頁面各寫一遍,還不如寫一個 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 中啟用。