गेम लूप टेस्ट शुरू करें

जब गेमिंग ऐप्लिकेशन अलग-अलग यूज़र इंटरफ़ेस (यूआई) फ़्रेमवर्क पर बनाए जाते हैं, तो गेम की टेस्टिंग को ऑटोमेट करना मुश्किल हो सकता है. गेम लूप टेस्ट की मदद से, अपने नेटिव टेस्ट को Test Lab के साथ इंटिग्रेट किया जा सकता है. साथ ही, उन्हें चुने गए डिवाइसों पर आसानी से चलाया जा सकता है. इस गाइड में, Firebase Test Lab का इस्तेमाल करके गेम लूप टेस्ट को चलाने का तरीका बताया गया है.

गेम लूप टेस्ट के बारे में जानकारी

गेम लूप टेस्ट क्या है?

गेम लूप टेस्ट, किसी असली खिलाड़ी की कार्रवाइयों को सिम्युलेट करता है. इससे यह पुष्टि की जाती है कि आपका गेम, उपयोगकर्ताओं के लिए तेज़ी से और स्केलेबल तरीके से अच्छा परफ़ॉर्म करता है या नहीं. लूप, गेमिंग ऐप्लिकेशन पर टेस्ट के पूरे या कुछ हिस्से को चलाने की प्रोसेस है. Test Lab में, सिम्युलेटर पर या डिवाइसों के किसी सेट पर, गेम लूप टेस्ट को स्थानीय तौर पर चलाया जा सकता है. गेम लूप टेस्ट का इस्तेमाल इन कामों के लिए किया जा सकता है:

  • अपने गेम को उसी तरह चलाएं जिस तरह कोई असली उपयोगकर्ता उसे चलाएगा. उपयोगकर्ता के इनपुट को स्क्रिप्ट में लिखा जा सकता है, उपयोगकर्ता को कुछ समय के लिए इंतज़ार करने दिया जा सकता है या उपयोगकर्ता की जगह एआई का इस्तेमाल किया जा सकता है. उदाहरण के लिए, अगर आपने कार रेसिंग गेम में एआई का इस्तेमाल किया है, तो उपयोगकर्ता के इनपुट के लिए एआई ड्राइवर का इस्तेमाल किया जा सकता है.
  • अपने गेम को सबसे अच्छी क्वालिटी की सेटिंग पर चलाकर देखें कि यह किन डिवाइसों पर काम करता है.
  • तकनीकी जांच करें. जैसे, कई शेडर को कंपाइल करना, उन्हें लागू करना, और यह देखना कि आउटपुट उम्मीद के मुताबिक है या नहीं.

पहला चरण: Test Lab का कस्टम यूआरएल स्कीम रजिस्टर करना

  1. Xcode में, कोई प्रोजेक्ट टारगेट चुनें.

  2. जानकारी टैब पर क्लिक करें. इसके बाद, नया यूआरएल टाइप जोड़ें.

  3. यूआरएल स्कीम फ़ील्ड में, firebase-game-loop डालें. कस्टम यूआरएल स्कीम को रजिस्टर करने के लिए, इसे अपने प्रोजेक्ट की 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 का इस्तेमाल करके टेस्ट चलाने के लिए कॉन्फ़िगर हो गया है.

दूसरा चरण: अपने ऐप्लिकेशन को कॉन्फ़िगर करना (ज़रूरी नहीं)

एक से ज़्यादा लूप चलाना

अगर आपको अपने टेस्ट में एक से ज़्यादा लूप (जिन्हें स्थिति भी कहा जाता है) चलाने हैं, तो आपको यह बताना होगा कि लॉन्च के समय आपको अपने ऐप्लिकेशन में कौनसे लूप चलाने हैं.

अपने ऐप्लिकेशन डेलीगेट में, 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:).
  }
}

जब टेस्ट में एक से ज़्यादा लूप चलाए जाते हैं, तो मौजूदा लूप को ऐप्लिकेशन लॉन्च करने के लिए इस्तेमाल किए गए यूआरएल में पैरामीटर के तौर पर पास किया जाता है. कस्टम यूआरएल स्कीमा को फ़ेच करने के लिए इस्तेमाल किए गए URLComponents ऑब्जेक्ट को पार्स करके, मौजूदा लूप नंबर भी पाया जा सकता है:

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

टेस्ट को जल्दी खत्म करना

डिफ़ॉल्ट रूप से, गेम लूप टेस्ट तब तक चलता रहता है, जब तक कि वह पांच मिनट के टाइम आउट तक न पहुंच जाए. भले ही, सभी लूप पूरे हो चुके हों. टाइम आउट होने पर, जांच खत्म हो जाती है और किसी भी लंबित लूप को रद्द कर दिया जाता है. अपने ऐप्लिकेशन के AppDelegate में, Test Lab के कस्टम यूआरएल स्कीम firebase-game-loop-complete को कॉल करके, टेस्ट को तेज़ किया जा सकता है या उसे जल्दी खत्म किया जा सकता है. उदाहरण के लिए:

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) {}];
}

आपका गेम लूप टेस्ट, मौजूदा लूप को खत्म कर देता है और अगला लूप चलाता है. जब कोई लूप नहीं चलता है, तो टेस्ट खत्म हो जाता है.

पसंद के मुताबिक टेस्ट के नतीजे लिखना

अपने डिवाइस के फ़ाइल सिस्टम में, पसंद के मुताबिक टेस्ट के नतीजे लिखने के लिए, अपने गेम लूप टेस्ट को कॉन्फ़िगर किया जा सकता है. इस तरह, जब टेस्ट शुरू होता है, तो 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];
        }
    }
    

तीसरा चरण: अपने ऐप्लिकेशन को साइन करना

  1. पक्का करें कि ऐप्लिकेशन में मौजूद सभी आर्टफ़ैक्ट पर हस्ताक्षर किए गए हों. उदाहरण के लिए, Xcode की मदद से ऐसा किया जा सकता है. इसके लिए, आपको साइन करने की सेटिंग तय करनी होगी. जैसे, प्रोविज़निंग प्रोफ़ाइल और पहचान. ज़्यादा जानकारी के लिए, यह लेख पढ़ें: Apple कोड साइनिंग

चौथा चरण: अपलोड करने के लिए अपने ऐप्लिकेशन को पैकेज करना

अपने ऐप्लिकेशन के लिए IPA फ़ाइल जनरेट करें. आपको बाद में इसे ढूंढना होगा.

  1. इसके बाद, दिखने वाले ड्रॉप-डाउन मेन्यू में, प्रॉडक्ट > संग्रह करें पर क्लिक करें. सबसे हाल ही का संग्रह चुनें. इसके बाद, ऐप्लिकेशन उपलब्ध कराएं पर क्लिक करें.

  2. इसके बाद, खुलने वाली विंडो में डेवलपमेंट > अगला पर क्लिक करें.

  3. ज़रूरी नहीं: तेज़ी से बिल्ड करने के लिए, बिटकोड से फिर से बनाएं विकल्प से चुने हुए का निशान हटाएं. इसके बाद, आगे बढ़ें पर क्लिक करें. Test Lab टेस्ट चलाने के लिए, आपको अपने ऐप्लिकेशन को छोटा करने या फिर से बनाने की ज़रूरत नहीं होती. इसलिए, इस विकल्प को सुरक्षित तरीके से बंद किया जा सकता है.

  4. एक्सपोर्ट करें पर क्लिक करें. इसके बाद, वह डायरेक्ट्री डालें जिसमें आपको अपने ऐप्लिकेशन की IPA फ़ाइल डाउनलोड करनी है.

पांचवां चरण: ऐप्लिकेशन के हस्ताक्षर की पुष्टि करना

  1. .ipa फ़ाइल को अनज़िप करके, ऐप्लिकेशन हस्ताक्षर की पुष्टि करें. इसके बाद, codesign --verify --deep --verbose /path/to/MyApp.app को चलाएं. यहां "MyApp", अनज़िप किए गए फ़ोल्डर में मौजूद ऐप्लिकेशन का नाम है. यह हर प्रोजेक्ट के लिए अलग-अलग होता है. अनुमानित आउटपुट MyApp.app: valid on disk है.

छठा चरण: टेस्ट को स्थानीय तौर पर चलाना

Test Lab के साथ चलाने से पहले, अपने टेस्ट को लोकल लेवल पर चलाकर उसकी परफ़ॉर्मेंस देखी जा सकती है. स्थानीय तौर पर टेस्ट करने के लिए, अपने गेमिंग ऐप्लिकेशन को सिम्युलेटर में लोड करें और चलाएं:

xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://
  • instruments -s devices कमांड चलाकर, अपने सिम्युलेटर का यूडीआईडी पाया जा सकता है.

  • अगर सिर्फ़ एक सिम्युलेटर चल रहा है, तो SIMULATOR_UDID के बजाय खास स्ट्रिंग "booted" डालें.

अगर आपके टेस्ट में एक से ज़्यादा लूप हैं, तो scenario फ़्लैग में लूप नंबर डालकर यह तय किया जा सकता है कि आपको कौनसा लूप चलाना है. ध्यान दें कि लोकल तौर पर टेस्ट चलाते समय, एक बार में सिर्फ़ एक लूप चलाया जा सकता है. उदाहरण के लिए, अगर आपको पहला, दूसरा, और पांचवां लूप चलाना है, तो आपको हर लूप के लिए एक अलग निर्देश चलाना होगा:

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 सीएलआई का इस्तेमाल करके, अपना टेस्ट चलाएं.