iOS के लिए, गेम लूप के टेस्ट शुरू करें

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

इस पेज पर, गेम लूप टेस्ट करने का तरीका बताया गया है. इसके बाद, टेस्ट देखने और उसे मैनेज करने का तरीका बताया गया है के नतीजे Firebase कंसोल के टेस्ट लैब पेज में मिलेंगे. आप इसे और भी वैकल्पिक सुविधाओं, जैसे कि टेस्ट के कस्टम नतीजे लिखना या टेस्ट से पहले ही खत्म कर देना.

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

लूप, आपके गेमिंग ऐप्लिकेशन पर किए गए टेस्ट का पूरा या कुछ हिस्सा होता है. आप आप सिम्युलेटर या डिवाइसों के सेट पर, स्थानीय तौर पर गेम लूप की जांच कर सकते हैं टेस्ट लैब. गेम लूप टेस्ट का इस्तेमाल इन कामों के लिए किया जा सकता है:

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

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

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

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

सबसे पहले, आपको Firebase टेस्ट लैब आपके ऐप्लिकेशन में कस्टम यूआरएल स्कीम:

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

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

  3. यूआरएल स्कीम फ़ील्ड में, firebase-game-loop डालें. कस्टम यूआरएल स्कीम को अपने प्रोजेक्ट के <dict> टैग में कहीं भी Info.plist कॉन्फ़िगरेशन फ़ाइल है:

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

अब आपके ऐप्लिकेशन को टेस्ट लैब से टेस्ट करने के लिए कॉन्फ़िगर कर दिया गया है.

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

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

अगर आपको अपने ऐप्लिकेशन का ऐक्सेस देना है, तो 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).
        }
    }
}

तीसरा चरण: टेस्ट बनाना और चलाना

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

Firebase कंसोल में जांच करना

  1. अगर आपने पहले से ऐसा नहीं किया है, तो Firebase कंसोल खोलें और प्रोजेक्ट बनाएं.

  2. Firebase कंसोल के टेस्ट लैब पेज पर, अपना पहले चलाएं पर क्लिक करें परीक्षण > iOS गेम लूप चलाएं.

  3. ऐप्लिकेशन अपलोड करें सेक्शन में, ब्राउज़ करें पर क्लिक करें. इसके बाद, अपने ऐप्लिकेशन का आईपीए फ़ाइल (अगर आपने अब तक आईपीए फ़ाइल जनरेट नहीं की है, तो आईपीए फ़ाइल जनरेट करें आपके ऐप्लिकेशन के लिए).

  4. ज़रूरी नहीं: अगर आपको एक ही समय में कई लूप (यानी स्थितियां) चलाने हैं या चलाने के लिए खास लूप चुनें, स्थिति वाले कॉलम में लूप नंबर डालें फ़ील्ड में डालें.

    उदाहरण के लिए, जब आप "1-3, 5" डालते हैं, तो टेस्ट लैब लूप 1, 2, 3, और 5 चलाता है. डिफ़ॉल्ट रूप से (अगर स्थिति वाले फ़ील्ड में कुछ भी नहीं डाला जाता है), तो परीक्षण लैब केवल लूप 1 पर चलता है.

  5. डिवाइस सेक्शन में, एक या उससे ज़्यादा फ़िज़िकल डिवाइस चुनें अपने ऐप्लिकेशन को टेस्ट करें, फिर टेस्ट शुरू करें पर क्लिक करें.

gcloud बीटा सीएलआई की मदद से टेस्ट करें

  1. अगर आपने अभी तक ऐसा नहीं किया है, तो अपने लोकल gcloud SDK एनवायरमेंट को कॉन्फ़िगर करें, तो gcloud बीटा कॉम्पोनेंट.

  2. gcloud beta firebase test ios run निर्देश चलाएं और इनका इस्तेमाल करें फ़्लैग:

गेम लूप टेस्ट के लिए फ़्लैग
--type

ज़रूरी है: यह बताता है कि किस तरह का iOS टेस्ट चलाना है. इसमें परीक्षण प्रकार xctest (डिफ़ॉल्ट) या game-loop.

--app

ज़रूरी है: ऐब्सलूट पाथ (Google Cloud Storage या फ़ाइल सिस्टम) को कॉपी किया जा सकता है. यह फ़्लैग सिर्फ़ तब मान्य होता है, जब गेम लूप टेस्ट कर रहे हैं.

--scenario-numbers

वे लूप (यानी कि स्थितियां) जिन्हें आपको अपने ऐप्लिकेशन में चलाना है. इसमें एक लूप, सूची या लूप या लूप की कोई रेंज डाली जा सकती है. डिफ़ॉल्ट लूप 1 है.

उदाहरण के लिए, --scenario-numbers=1-3,5 लूप 1, 2, 3, और 5 चलाता है.

--device-model

वह डिवाइस जिस पर आपको टेस्ट कराना है (पता लगाएं कि कौनसे डिवाइस उपलब्ध हैं इस्तेमाल किए जा सकते हैं).

--timeout

वह ज़्यादा से ज़्यादा अवधि जिसे आपको टेस्ट चलाना है. कोई पूर्णांक डाला जा सकता है अवधि को सेकंड में दिखाते हैं या अवधि को लंबी इकाई के रूप में शामिल किया है.

उदाहरण के लिए:

  • 200 तक चलने पर, --timeout=200 आपके टेस्ट को हर हाल में खत्म करता है सेकंड.
  • एक घंटे तक चलने पर, --timeout=1h आपके टेस्ट को हर हाल में खत्म कर देता है.

उदाहरण के लिए, नीचे दिए गए निर्देश से गेम लूप की जांच की जाती है. इसमें लूप को चलाया जाता है iPhone 8 Plus पर कार्ड नंबर 1, 4, 6, 7, और 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 सीएलआई के बारे में ज़्यादा जानकारी के लिए रेफ़रंस दस्तावेज़.

स्थानीय तौर पर टेस्ट करना

स्थानीय तौर पर अपना टेस्ट चलाने के लिए, अपने गेमिंग ऐप्लिकेशन को सिम्युलेटर में लोड करें और चलाएं:

xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://
  • सिम्युलेटर का यूडीआईडी ढूंढने के लिए, instruments -s devices निर्देश.

  • अगर सिर्फ़ एक सिम्युलेटर चल रहा है, तो विशेष स्ट्रिंग डालें SIMULATOR_UDID के स्थान पर "booted".

अगर आपके जांच में एक से ज़्यादा लूप हैं, तो आपके पास यह तय करने का विकल्प होता है कि कौनसा लूप चलाना है 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 की कस्टम यूआरएल स्कीम को कॉल करके अपना टेस्ट पूरा करें या उसे जल्दी खत्म करें 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) {}];
}

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

कस्टम जांच के नतीजे लिखें

गेम लूप के टेस्ट को कॉन्फ़िगर किया जा सकता है, ताकि फ़ाइल सिस्टम पर लागू होता है. इस तरह से, जब टेस्ट चलना शुरू होता है, तो टेस्ट लैब नतीजे की फ़ाइलों को आपके टेस्टिंग पेज पर, GameLoopsResults डायरेक्ट्री में सेव करता है डिवाइस (जिसे आपको खुद बनाना होगा). जांच खत्म होने पर, 'टेस्ट लैब' सुविधा बदलने लगती है GameLoopResults डायरेक्ट्री से आपके प्रोजेक्ट के बकेट में भेजी गई सभी फ़ाइलें. नहीं अपना टेस्ट सेट अप करते समय इन बातों का ध्यान रखें:

  • नतीजे वाली सभी फ़ाइलें अपलोड की जाती हैं. भले ही, उनकी फ़ाइल टाइप, साइज़ या संख्या कुछ भी हो.

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

कस्टम टेस्ट के नतीजे लिखने के लिए, टेस्ट को सेट अप करने का तरीका:

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