ทำการทดสอบ Game Loop

การทดสอบเกมอัตโนมัติอาจทำได้ยากเมื่อสร้างแอปเกมโดยใช้เฟรมเวิร์ก UI ที่แตกต่างกัน การทดสอบ Game Loop ช่วยให้คุณผสานรวมการทดสอบแบบเนทีฟกับ Test Lab และทำการทดสอบได้อย่างง่ายดายในอุปกรณ์ที่คุณเลือก คู่มือนี้อธิบายวิธีเตรียมการทดสอบ Game Loop ที่จะเรียกใช้โดยใช้ Firebase Test Lab

เกี่ยวกับการทดสอบ Game Loop

ขั้นตอนที่ 1: ลงทะเบียนชุดรูปแบบ URL ที่กำหนดเองของ Test Lab

1. ใน Xcode ให้เลือกเป้าหมายโปรเจ็กต์

2. คลิกแท็บข้อมูล จากนั้นเพิ่มประเภท URL ใหม่

3. ในช่องรูปแบบ URL ให้ป้อน firebase-game-loop คุณยังลงทะเบียนสคีม URL ที่กำหนดเองได้โดยเพิ่มลงในไฟล์การกำหนดค่า Info.plist ของโปรเจ็กต์ที่ใดก็ได้ภายในแท็ก <dict> ดังนี้

   <key>CFBundleURLTypes</key>
    <array>
        <dict>
            <key>CFBundleURLName</key>
            <string></string>
            <key>CFBundleTypeRole</key>
            <string>Editor</string>
            <key>CFBundleURLSchemes</key>
            <array>
                <string>firebase-game-loop</string>
            </array>
        </dict>
    </array>
   

กำหนดค่าแอปของคุณให้ทำการทดสอบโดยใช้ Test Lab แล้ว

ขั้นตอนที่ 2: กำหนดค่าแอป (ไม่บังคับ)

เรียกใช้การวนซ้ำหลายรายการ

หากวางแผนที่จะเรียกใช้การวนซ้ำหลายรายการ (หรือที่เรียกว่าสถานการณ์) ในการทดสอบ คุณต้องระบุลูปที่ต้องการเรียกใช้ในแอป ณ เวลาที่เปิดตัว

ในการมอบสิทธิ์แอป ให้ลบล้างเมธอด application(_:open:options:) ดังนี้

func application(_app: UIApplication,
                 open url: URL
                 options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    let components = URLComponents(url: url, resolvingAgainstBaseURL: true)!
    if components.scheme == "firebase-game-loop" {
        // ...Enter Game Loop Test logic to override application(_:open:options:).
    }
    return true
}

- (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary <UIApplicationOpenURLOptionsKey, id> *)options {
  if ([url.scheme isEqualToString:(@"firebase-game-loop")]) {
      // ...Enter Game Loop Test logic to override application(_:open:options:).
  }
}

เมื่อคุณเรียกใช้การวนซ้ำหลายครั้งในการทดสอบ ระบบจะส่งลูปปัจจุบันเป็นพารามิเตอร์ไปยัง URL ที่ใช้ในการเปิดแอป คุณยังรับหมายเลขลูปปัจจุบันได้โดยการแยกวิเคราะห์ออบเจ็กต์ URLComponents ที่ใช้ดึงข้อมูลรูปแบบ URL ที่กำหนดเอง

if components.scheme == "firebase-game-loop" {
    // Iterate over all parameters and find the one with the key "scenario".
    let scenarioNum = Int(components.queryItems!.first(where: { $0.name == "scenario" })!.value!)!
    // ...Write logic specific to the current loop (scenarioNum).
}

if ([url.scheme isEqualToString:(@"firebase-game-loop")]) {
    // Launch the app as part of a game loop.
    NSURLComponents *components = [NSURLComponents componentsWithURL:url
                                             resolvingAgainstBaseURL:YES];
    for (NSURLQueryItem *item in [components queryItems]) {
        if ([item.name isEqualToString:@"scenario"]) {
            NSInteger scenarioNum = [item.value integerValue];
            // ...Write logic specific to the current loop (scenarioNum).
        }
    }
}

สิ้นสุดการทดสอบก่อนกำหนด

โดยค่าเริ่มต้น การทดสอบ Game Loop จะทำงานต่อไปจนกว่าจะถึงระยะหมดเวลา 5 นาที แม้ว่าจะใช้การวนซ้ำทั้งหมดแล้วก็ตาม เมื่อถึงระยะหมดเวลา การทดสอบจะสิ้นสุดลงและยกเลิกการวนซ้ำทั้งหมดที่รอดำเนินการ คุณสามารถเร่งการทดสอบหรือสิ้นสุดการทดสอบก่อนกำหนดได้โดยเรียกใช้สคีม URL ที่กำหนดเองของ Test Lab firebase-game-loop-complete ใน AppDelegate ของแอป ตัวอย่างเช่น

/// End the loop by calling our custom url scheme.
func finishLoop() {
    let url = URL(string: "firebase-game-loop-complete://")!
    UIApplication.shared.open(url)
}

- (void)finishLoop {
  UIApplication *app = [UIApplication sharedApplication];
  [app openURL:[NSURL URLWithString:@"firebase-game-loop-complete://"]
      options:@{}
completionHandler:^(BOOL success) {}];
}

การทดสอบ Game Loop จะสิ้นสุดการวนซ้ำปัจจุบันและดำเนินการวนซ้ำถัดไป เมื่อไม่มีการวนซ้ำให้เรียกใช้อีก การทดสอบจะสิ้นสุดลง

เขียนผลการทดสอบที่กำหนดเอง

คุณกำหนดค่าการทดสอบ Game Loop ให้เขียนผลการทดสอบที่กำหนดเองไปยังระบบไฟล์ของอุปกรณ์ได้ เมื่อการทดสอบเริ่มทำงาน Test Lab จะจัดเก็บไฟล์ผลลัพธ์ไว้ในไดเรกทอรี GameLoopsResults ในอุปกรณ์ทดสอบ (ซึ่งคุณต้องสร้างเอง) เมื่อการทดสอบสิ้นสุดลง Test Lab จะย้ายไฟล์ทั้งหมดจากไดเรกทอรี GameLoopResults ไปยังที่เก็บข้อมูลของโปรเจ็กต์ สิ่งที่ควรคำนึงถึงเมื่อตั้งค่าการทดสอบ

• ไฟล์ผลการค้นหาทั้งหมดจะถูกอัปโหลดโดยไม่คำนึงถึงประเภทไฟล์ ขนาด หรือจำนวน

• Test Lab จะไม่ประมวลผลผลการทดสอบจนกว่าการทดสอบจะเสร็จสิ้นทั้งหมด ดังนั้นหากการทดสอบมีลูปหลายรายการที่เขียนเอาต์พุต อย่าลืมเพิ่มลูปดังกล่าวต่อท้ายไฟล์ผลลัพธ์ที่ไม่ซ้ำกันหรือสร้างไฟล์ผลลัพธ์สำหรับแต่ละการวนซ้ำ วิธีนี้จะช่วยให้คุณหลีกเลี่ยงการเขียนทับผลลัพธ์จากลูปก่อนหน้าได้

หากต้องการตั้งค่าการทดสอบให้เขียนผลการทดสอบที่กำหนดเอง ให้ทำดังนี้

1. ในไดเรกทอรี Documents ของแอป ให้สร้างไดเรกทอรีชื่อ GameLoopResults

2. จากส่วนใดก็ได้ในโค้ดของแอป (เช่น ผู้รับมอบสิทธิ์แอป) ให้เพิ่มข้อมูลต่อไปนี้

   Swift

   /// Write to a results file.
   func writeResults() {
     let text = "Greetings from game loops!"
     let fileName = "results.txt"
     let fileManager = FileManager.default
     do {
   
     let docs = try fileManager.url(for: .documentDirectory,
                                    in: .userDomainMask,
                                    appropriateFor: nil,
                                    create: true)
     let resultsDir = docs.appendingPathComponent("GameLoopResults")
     try fileManager.createDirectory(
         at: resultsDir,
         withIntermediateDirectories: true,
         attributes: nil)
     let fileURL = resultsDir.appendingPathComponent(fileName)
     try text.write(to: fileURL, atomically: false, encoding: .utf8)
     } catch {
       // ...Handle error writing to file.
     }
   }
   

   Objective-C

   /// Write to a results file.
   - (void)writeResults:(NSString *)message {
       // Locate and create the results directory (if it doesn't exist already).
       NSFileManager *manager = [NSFileManager defaultManager];
       NSURL* url = [[manager URLsForDirectory:NSDocumentDirectory
                                     inDomains:NSUserDomainMask] lastObject];
       NSURL* resultsDir = [url URLByAppendingPathComponent:@"GameLoopResults"
                                                isDirectory:YES];
       [manager createDirectoryAtURL:resultsDir
         withIntermediateDirectories:NO
                          attributes:nil
                               error:nil];
   
       // Write the result message to a text file.
       NSURL* resultFile = [resultsDir URLByAppendingPathComponent:@"result.txt"];
       if ([manager fileExistsAtPath:[resultFile path]]) {
           // Append to the existing file
           NSFileHandle *handle = [NSFileHandle fileHandleForWritingToURL:resultFile
                                                                    error:nil];
           [handle seekToEndOfFile];
           [handle writeData:[message dataUsingEncoding:NSUTF8StringEncoding]];
           [handle closeFile];
       } else {
           // Create and write to the file.
           [message writeToURL:resultFile
                    atomically:NO
                      encoding:NSUTF8StringEncoding error:nil];
       }
   }
   

ขั้นตอนที่ 3: รับรองแอป

1. ตรวจสอบว่าอาร์ติแฟกต์ทั้งหมดในแอปลงนามแล้ว ตัวอย่างเช่น คุณดำเนินการดังกล่าวผ่าน Xcode ได้โดยระบุการตั้งค่าการลงชื่อ เช่น โปรไฟล์การจัดสรรและข้อมูลประจำตัว สำหรับข้อมูลเพิ่มเติม โปรดดู Apple Codesigning

ขั้นตอนที่ 4: จัดแพ็กเกจแอปสำหรับการอัปโหลด

สร้างไฟล์ IPA สำหรับแอป (คุณจะต้องค้นหาในภายหลัง)

1. จากเมนูแบบเลื่อนลงที่ปรากฏขึ้น ให้คลิกผลิตภัณฑ์ > เก็บถาวร เลือกที่เก็บถาวรล่าสุด แล้วคลิกเผยแพร่แอป

2. ในหน้าต่างที่ปรากฏขึ้น ให้คลิกการพัฒนา > ถัดไป

3. ไม่บังคับ: หากต้องการให้บิลด์ที่เร็วขึ้น ให้ยกเลิกการเลือกตัวเลือกสร้างใหม่จาก Bitcode แล้วคลิกถัดไป Test Lab ไม่จำเป็นต้องทำให้แอปมีขนาดเล็กลงหรือสร้างแอปใหม่เพื่อทำการทดสอบ คุณจึงปิดใช้ตัวเลือกนี้ได้อย่างปลอดภัย

4. คลิกส่งออก แล้วป้อนไดเรกทอรีที่คุณต้องการดาวน์โหลดไฟล์ IPA ของแอป

ขั้นตอนที่ 5: ยืนยันลายเซ็นแอป

1. ยืนยันลายเซ็นของแอปโดยคลายการบีบอัดไฟล์ .ipa แล้วเรียกใช้ codesign --verify --deep --verbose /path/to/MyApp.app โดยที่ "MyApp" คือชื่อแอปในโฟลเดอร์ที่แตกแล้ว (แตกต่างกันไปในแต่ละโปรเจ็กต์) เอาต์พุตที่คาดไว้คือ MyApp.app: valid on disk

ขั้นตอนที่ 6: เรียกใช้การทดสอบในเครื่อง

คุณทำการทดสอบในเครื่องเพื่อตรวจสอบลักษณะการทำงานของการทดสอบก่อนเรียกใช้ด้วย Test Lab ได้ หากต้องการทดสอบในเครื่อง ให้โหลดแอปเกมในเครื่องมือจำลองแล้วเรียกใช้ดังนี้

xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://

• คุณค้นหา UDID ของเครื่องมือจำลองได้โดยเรียกใช้คำสั่ง instruments -s devices

• หากมีเครื่องจำลองที่ใช้งานอยู่เพียงรายการเดียว ให้ป้อนสตริงพิเศษ "booted" แทน SIMULATOR_UDID

หากการทดสอบมีการวนซ้ำหลายรายการ คุณสามารถระบุลูปที่ต้องการเรียกใช้โดยการส่งหมายเลขลูปไปยังแฟล็ก scenario โปรดทราบว่าคุณเรียกใช้ลูปได้ทีละ 1 ครั้งเมื่อทำการทดสอบในเครื่องเท่านั้น ตัวอย่างเช่น หากต้องการเรียกใช้ลูป 1, 2 และ 5 คุณต้องเรียกใช้คำสั่งแยกกันสำหรับแต่ละการวนซ้ำ

xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=1
xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=2
xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=5

ขั้นตอนถัดไป

ทำการทดสอบโดยใช้คอนโซล Firebase หรือ gcloud CLI