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

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

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

การทดสอบ Game Loop คืออะไร

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

  • เล่นเกมของคุณในลักษณะที่ผู้ใช้ปลายทางจะเล่น คุณสามารถเขียนสคริปต์อินพุตของผู้ใช้ ปล่อยให้ผู้ใช้ไม่มีการใช้งาน หรือแทนที่ผู้ใช้ด้วย AI (เช่น หากคุณใช้ AI ในเกมแข่งรถ คุณสามารถใส่คนขับ AI เป็นผู้ควบคุมอินพุตของผู้ใช้)
  • เรียกใช้เกมที่การตั้งค่าคุณภาพสูงสุดเพื่อดูว่าอุปกรณ์ใดบ้างที่รองรับ
  • ทำการทดสอบทางเทคนิค เช่น การคอมไพล์หลายชิเดอร์ การดำเนินการ และตรวจสอบว่าเอาต์พุตเป็นไปตามที่คาดไว้

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

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

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

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

เรียกใช้ลูปหลายรายการ

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

ใน App Delegate ให้ลบล้างเมธอด application(_:open:options:) ดังนี้

Swift

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
}

Objective-C

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

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

Swift

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).
}

Objective-C

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 ของแอป เช่น

Swift

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

Objective-C

- (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

ขั้นตอนที่ 4: แพ็กเกจแอปเพื่ออัปโหลด

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

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

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

  3. ไม่บังคับ: หากต้องการให้บิลด์เร็วขึ้น ให้ยกเลิกการเลือกตัวเลือกสร้างใหม่จากบิตโค้ด แล้วคลิกถัดไป 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

หากการทดสอบมีลูปหลายรายการ คุณสามารถระบุลูปที่ต้องการเรียกใช้โดยส่งหมายเลขลูปไปยัง Flag 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