您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 搖一搖截圖:做出簡便的問題回報功能

編輯:iOS 開發綜合

有一段時間沒更新,這篇記錄最近工作中用到的功能。

要解決的問題

測試人員在驗證客戶端產品時,遇到問題或 BUG 得先截圖,再從相簿挑出截圖、補上一段描述,然後上傳到缺陷管理系統或直接寄信給開發人員。整個流程很繁瑣。

如果改成「搖一搖裝置,自動截圖並存到 App 沙盒」,接著跳出一個自轉的回報頁面填寫描述,最後把描述與截圖一起寄給開發人員,流程就順得多。描述欄位甚至可以整合語音輸入(例如訊飛語音)來加快填寫。

用 category 把功能做成外掛

這個做法的好處是:整個功能收在一個 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 的需求。

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