תחילת העבודה עם בדיקות של לולאת משחקים ל-iOS

בעזרת בדיקות של לולאות משחק, אתם יכולים לכתוב בדיקות שמותאמות למנוע המשחק שלכם ואז להריץ אותן ב-Test Lab במכשירים שתבחרו. כך לא צריך לדאוג לגבי כתיבה לממשקי משתמש שונים או למסגרות בדיקה שונות. בדיקת לולאת משחק מדמה את הפעולות של שחקן אמיתי, וכשמריצים אותה ב-Test Lab, היא מספקת דרך מהירה וניתנת להרחבה כדי לוודא שהמשחק פועל בצורה טובה עבור המשתמשים.

בדף הזה מוסבר איך להריץ בדיקה של לולאת משחק, ואז לראות ולנהל את תוצאות הבדיקה בדף Test Lab במסוף Firebase. אפשר גם להתאים אישית את הבדיקות באמצעות תכונות אופציונליות, כמו כתיבת תוצאות בדיקה בהתאמה אישית או סיום הבדיקה לפני הזמן.

הערה: אפשר להשתמש ב-Test Lab ללא תשלום עם תוכנית התמחור של Spark, שכוללת מכסת שימוש יומית מוגבלת. מידע נוסף על תוכניות תמחור אחרות ומגבלות שימוש זמין במאמר תוכניות התמחור של Firebase.

מהו בדיקת לולאת משחק?

לולאה היא הרצה מלאה או חלקית של הבדיקה באפליקציית המשחק. אפשר להריץ בדיקת לולאת משחק באופן מקומי בסימולטור או במערך מכשירים ב-Test Lab. אפשר להשתמש בבדיקות של לולאות משחק כדי:

• משחקים במשחק כמו משתמש קצה. אפשר ליצור סקריפט לקלט של המשתמש, לאפשר למשתמש להיות לא פעיל או להחליף את המשתמש ב-AI (לדוגמה, אם הטמעתם AI במשחק מירוץ מכוניות, אתם יכולים להציב נהג AI שאחראי על הקלט של המשתמש).

• כדי לגלות אילו מכשירים יכולים לתמוך בהגדרה הזו, מריצים את המשחק בהגדרת האיכות הגבוהה ביותר.

• מריצים בדיקה טכנית, כמו קומפילציה של כמה הצללות, הפעלה שלהן ובדיקה שהפלט הוא כמו שציפיתם.

שלב 1: רישום סכמת כתובות ה-URL המותאמת אישית של Test Lab

קודם כל, צריך לרשום את סכימת כתובות ה-URL המותאמת אישית של Firebase 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 (אופציונלי): הגדרת האפליקציה להפעלת כמה לולאות

אם באפליקציה שלכם רשומים כמה סכימות מותאמות אישית של כתובות URL ואתם מתכננים להריץ כמה לולאות (כלומר תרחישים) בבדיקה, אתם צריכים לציין אילו לולאות אתם רוצים להריץ באפליקציה בזמן ההפעלה.

בנציג האפליקציה, מחליפים את השיטה 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 <UIApplicationOpenURLOptionsKey, id> *)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).
        }
    }
}

שלב 3: יצירה והרצה של בדיקה

אחרי שרושמים את סכמת כתובות ה-URL המותאמת אישית של Test Lab, אפשר להריץ את הבדיקה במסוף Firebase או באמצעות gcloud beta CLI. אם עדיין לא עשיתם זאת, צריך ליצור קובץ IPA לאפליקציה (תצטרכו לאתר אותו בהמשך).

טיפ: לפני שמשתמשים ב-Test Lab, אפשר קודם לוודא שלולאות המשחק פועלות כמצופה על ידי הפעלת הבדיקה באופן מקומי בסימולטור.

יצירת קובץ IPA לאפליקציה

1. ב-Xcode, בוחרים פרופיל הקצאת הרשאות לאפליקציית היעד.
   הערה: Test Lab חותמת מחדש את האפליקציה עם פרופיל הקצאת הרשאות משלה ותעודה משלה.
2. בתפריט הנפתח שמופיע, לוחצים על מוצר > העברה לארכיון. בוחרים את הארכיון האחרון ולוחצים על הפצת האפליקציה.
3. בחלון שמופיע, לוחצים על פיתוח > הבא.
4. אופציונלי: כדי ליצור את האפליקציה מהר יותר, מבטלים את הסימון של האפשרות Rebuild from Bitcode (בנייה מחדש מ-Bitcode) ולוחצים על Next (הבא). Test Lab לא נדרש דילול או בנייה מחדש של האפליקציה כדי להריץ בדיקה, כך שאפשר להשבית את האפשרות הזו בבטחה.
5. לוחצים על ייצוא, ואז מזינים את הספרייה שבה רוצים להוריד את קובץ ה-IPA של האפליקציה.

הרצת בדיקה במסוף Firebase

1. אם עדיין לא עשיתם זאת, פותחים את מסוף Firebase ויוצרים פרויקט.

2. בדף Test Lab במסוף Firebase, לוחצים על הפעלת הבדיקה הראשונה > הפעלת לולאת משחק ב-iOS.

3. בקטע Upload App (העלאת אפליקציה), לוחצים על Browse (עיון) ואז בוחרים את קובץ ה-IPA של האפליקציה (אם עדיין לא עשיתם זאת, צריך ליצור קובץ IPA לאפליקציה).

4. אופציונלי: אם רוצים להריץ כמה לולאות (תרחישים) בו-זמנית או לבחור לולאות ספציפיות להרצה, מזינים את מספרי הלולאות בשדה Scenarios (תרחישים).

   לדוגמה, אם מזינים '1-3, 5', Test Lab מפעיל את לולאות 1, 2, 3 ו-5. כברירת מחדל (אם לא מזינים שום דבר בשדה תרחישים), הפקודה Test Lab מפעילה רק את לולאה 1.

5. בקטע מכשירים, בוחרים מכשיר פיזי אחד או יותר שרוצים לבדוק עליו את האפליקציה ולוחצים על התחלת הבדיקות.

הפעלת בדיקה באמצעות gcloud beta CLI

הערה: הפקודה של ה-CLI של gcloud בגרסת בטא לבדיקות של לולאות משחק ב-iOS היא גרסת בטא. זה אומר שהפונקציונליות עשויה להשתנות בדרכים שלא תואמות לאחור. גרסת בטא לא כפופה להסכם רמת שירות או למדיניות הוצאה משימוש, ויכול להיות שהתמיכה בה תהיה מוגבלת או שלא תהיה תמיכה בכלל.

1. אם עדיין לא עשיתם זאת, מגדירים את סביבת gcloud SDK המקומית, ואז מתקינים את רכיב הבטא של gcloud.

2. מריצים את הפקודה gcloud beta firebase test ios run ומשתמשים בדגלים הבאים כדי להגדיר את הריצה:

סימון לבדיקה של לולאות משחק
--type	חובה: מציינים את סוג הבדיקה ל-iOS שרוצים להריץ. אפשר להזין את סוגי הבדיקות xctest (ברירת מחדל) או game-loop.
--app	חובה: נתיב מוחלט (Google Cloud Storage או מערכת קבצים) לקובץ ה-IPA של האפליקציה. הדגל הזה תקף רק כשמריצים בדיקות של Game Loop.
--scenario-numbers	הלולאות (או התרחישים) שרוצים להריץ באפליקציה. אפשר להזין לולאה אחת, רשימה של לולאות או טווח של לולאות. ברירת המחדל של הלולאה היא 1. לדוגמה, --scenario-numbers=1-3,5 מפעיל את הלולאות 1, 2, 3 ו-5.
--device-model	המכשיר הפיזי שבו רוצים להריץ את הבדיקה (כאן אפשר לראות אילו מכשירים זמינים אפשר להשתמש).
--timeout	משך הזמן המקסימלי שבו רוצים להריץ את הבדיקה. אפשר להזין מספר שלם שמייצג את משך הזמן בשניות, או מספר שלם וספירה שמייצגים את משך הזמן כיחידת זמן ארוכה יותר. לדוגמה: ‫--timeout=200 מאלץ את הבדיקה להסתיים כשהיא מגיעה ל-200 שניות. ‫--timeout=1h גורם לסיום הבדיקה כשהיא מגיעה לשעה.

לדוגמה, הפקודה הבאה מריצה בדיקת Game Loop שמבצעת לולאות 1, 4, 6, 7 ו-8 באייפון 8 פלוס:

gcloud beta firebase test ios run
 --type game-loop --app path/to/my/App.ipa --scenario-numbers 1,4,6-8
 --device-model=iphone8plus

מידע נוסף על gcloud CLI מופיע במאמרי העזרה.

הרצת בדיקה באופן מקומי

כדי להריץ את הבדיקה באופן מקומי, טוענים את אפליקציית המשחק בסימולטור ומריצים את הפקודה:

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

• כדי למצוא את ה-UDID של הסימולטור, מריצים את הפקודה instruments -s devices.

• אם פועל רק סימולטור אחד, מזינים את המחרוזת המיוחדת "booted" במקום SIMULATOR_UDID.

אם הבדיקה מכילה כמה לולאות, אפשר לציין איזו לולאה רוצים להריץ באמצעות העברת מספר הלולאה לדגל scenario. הערה: אפשר להריץ רק לולאה אחת בכל פעם כשמריצים את הבדיקה באופן מקומי. לדוגמה, אם רוצים להפעיל את לולאות 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

סיום מוקדם של בדיקה

כברירת מחדל, בדיקה של לולאות משחק ממשיכה לפעול עד שהיא מגיעה לזמן קצוב לתפוגה של חמש דקות, גם כשכל הלולאות כבר בוצעו. כשהטיימ-אאוט מגיע, הבדיקה מסתיימת וכל הלולאות שממתינות לביצוע מבוטלות. כדי להאיץ את הבדיקה או לסיים אותה לפני הזמן, אפשר לקרוא לTest Labסכימת כתובות ה-URL המותאמת אישית של 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];
       }
   }