有一段時間沒更新,這篇記錄最近工作中用到的功能。
測試人員在驗證客戶端產品時,遇到問題或 BUG 得先截圖,再從相簿挑出截圖、補上一段描述,然後上傳到缺陷管理系統或直接寄信給開發人員。整個流程很繁瑣。
如果改成「搖一搖裝置,自動截圖並存到 App 沙盒」,接著跳出一個自轉的回報頁面填寫描述,最後把描述與截圖一起寄給開發人員,流程就順得多。描述欄位甚至可以整合語音輸入(例如訊飛語音)來加快填寫。
這個做法的好處是:整個功能收在一個 category 裡,測試完成後只要把 pch 中的那一行 import 註解掉,功能就完全消失,不必回頭清理各個畫面的程式碼。
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;
NSString *path = [[NSHomeDirectory() stringByAppendingPathComponent:@"Documents"]
stringByAppendingPathComponent:@"error.png"];
[screenShotPNG writeToFile:path options:NSAtomicWrite error:&error];
}
@end
關鍵是 renderInContext:。它把一個 layer 的內容渲染進指定的圖形上下文,而我們提供的上下文是一個與螢幕等大的影像上下文,於是就得到了一張截圖。
要注意這條路徑只能拍到「已經渲染到 layer 上的內容」。如果畫面中有 video 播放或某些特殊 layer,可能拍不到,這時得改用 UIGraphicsImageRenderer(iOS 10 以後)或系統的截圖 API。
iOS 6.0 以上:只需在專案的 pch 檔中加入:
#import "UIViewController+ShakeAndCutter.h"
因為 category 對所有 UIViewController 生效,不必在個別畫面加任何程式碼。測試結束後,把這行註解或刪除即可。作者已在 iOS 6.0.1、6.1.5、7.0.6 上驗證過。
iOS 6.0 以下:可能需要在要啟用搖動的畫面中手動加上:
1. viewDidLoad 中:
[[UIApplication sharedApplication] setApplicationSupportsShakeToEdit:YES]; [self becomeFirstResponder];
2. viewDidAppear 中:
[self becomeFirstResponder];
3. viewDidDisappear 中:
[self resignFirstResponder];
作者手上沒有 iOS 6.0 以下的裝置,這部分尚未實測。
回報頁面的重點是把截圖與描述一起送出去。以下是郵件部分的核心程式碼。
MailViewController.h
#import <UIKit/UIKit.h> #import <MessageUI/MessageUI.h> @interface MailViewController : UIViewController <MFMailComposeViewControllerDelegate> @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:@"xxx@qq.com"]];
// 也可以有多位收件人、副本與密件副本:
// [picker setCcRecipients:...]; [picker setBccRecipients:...];
// 加上截圖附件
NSString *path = [[NSHomeDirectory() stringByAppendingPathComponent:@"Documents"]
stringByAppendingPathComponent:@"error.png"];
NSData *myData = [NSData dataWithContentsOfFile:path];
[picker addAttachmentData:myData mimeType:@"image/png" fileName:@"error.png"];
NSString *emailBody = @"<p>文字沒有全部顯示</p>";
[picker setMessageBody:emailBody isHTML:YES];
[self presentModalViewController:picker animated:YES];
[picker release];
}
#pragma mark - 郵件結果
- (void)mailComposeController:(MFMailComposeViewController *)controller
didFinishWithResult:(MFMailComposeResult)result
error:(NSError *)error {
switch (result) {
case MFMailComposeResultCancelled:
NSLog(@"Result: 郵件發送取消");
break;
case MFMailComposeResultSaved:
NSLog(@"Result: 郵件儲存成功");
break;
case MFMailComposeResultSent:
NSLog(@"Result: 郵件發送成功");
break;
case MFMailComposeResultFailed:
NSLog(@"Result: 郵件發送失敗");
break;
default:
NSLog(@"Result: 郵件未發送");
break;
}
[self dismissModalViewControllerAnimated:YES];
}
· 附件與描述要對得上。如果同一段時間搖了好幾次,error.png 會被覆蓋。實務上應該每次截圖都用時間戳命名,並把檔名一起帶進回報內容。
· 先把 canSendMail 問清楚。模擬器與未設定帳戶的裝置上,直接 present mail picker 會當掉。
· 這個功能不該進正式版。搖一搖截圖是測試輔助工具,正式上架的版本裡應該移除,或至少加上開發版判斷。
· 注意使用者隱私。截圖可能包含個人資料,上傳前值得給使用者一個確認步驟,而不是自動送出。
除了問題回報,同樣的機制也能延伸出其他效果,例如搖一搖重新整理、搖一搖切換主題等,具體怎麼用得看 App 的需求。