Catch up on highlights from Firebase at Google I/O 2023. Learn more

गेम लूप टेस्ट चलाएं

जब गेमिंग ऐप अलग-अलग UI फ्रेमवर्क पर बनाए जाते हैं तो गेम टेस्टिंग को ऑटोमेट करना मुश्किल हो सकता है। गेम लूप परीक्षण आपको टेस्ट लैब के साथ अपने मूल परीक्षणों को एकीकृत करने और उन्हें आपके द्वारा चुने गए उपकरणों पर आसानी से चलाने की अनुमति देते हैं। यह मार्गदर्शिका बताती है कि फायरबेस टेस्ट लैब का उपयोग करके चलाने के लिए गेम लूप टेस्ट कैसे तैयार किया जाए।

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

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

गेम लूप टेस्ट यह सत्यापित करने के लिए एक वास्तविक खिलाड़ी के कार्यों का अनुकरण करता है कि आपका गेम आपके उपयोगकर्ताओं के लिए तेज़ और स्केलेबल तरीके से अच्छा प्रदर्शन करता है। एक लूप आपके गेमिंग ऐप पर आपके परीक्षण का पूर्ण या आंशिक रन-थ्रू है। आप टेस्ट लैब में सिम्युलेटर या उपकरणों के एक सेट पर स्थानीय रूप से गेम लूप टेस्ट चला सकते हैं। गेम लूप टेस्ट का उपयोग इसके लिए किया जा सकता है:

  • अपने खेल के माध्यम से चलाएं क्योंकि एक अंतिम उपयोगकर्ता इसे खेलेगा। आप या तो उपयोगकर्ता के इनपुट को स्क्रिप्ट कर सकते हैं, उपयोगकर्ता को निष्क्रिय रहने दें, या उपयोगकर्ता को AI से बदल दें (उदाहरण के लिए, यदि आपने AI को कार रेसिंग गेम में लागू किया है, तो आप उपयोगकर्ता के इनपुट के लिए AI ड्राइवर को रख सकते हैं) .
  • यह पता लगाने के लिए कि कौन से डिवाइस इसका समर्थन कर सकते हैं, अपने गेम को उच्चतम गुणवत्ता सेटिंग पर चलाएं।
  • एक तकनीकी परीक्षण चलाएँ, जैसे कि कई शेड्स को संकलित करना, उन्हें निष्पादित करना और यह जाँचना कि आउटपुट अपेक्षित है।

चरण 1 : टेस्ट लैब की कस्टम यूआरएल स्कीम रजिस्टर करें

  1. एक्सकोड में, एक परियोजना लक्ष्य का चयन करें।

  2. जानकारी टैब पर क्लिक करें, फिर एक नया URL प्रकार जोड़ें।

  3. URL योजना फ़ील्ड में, firebase-game-loop दर्ज करें। आप कस्टम URL योजना को <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>
    

आपका ऐप अब परीक्षण लैब का उपयोग करके परीक्षण चलाने के लिए कॉन्फ़िगर किया गया है।

चरण 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 &lt;UIApplicationOpenURLOptionsKey, id&gt; *)options {
  if ([url.scheme isEqualToString:(@"firebase-game-loop")]) {
      // ...Enter Game Loop Test logic to override application(_:open:options:).
  }
}

जब आप अपने परीक्षण में एकाधिक लूप चलाते हैं, तो वर्तमान लूप ऐप लॉन्च करने के लिए उपयोग किए जाने वाले यूआरएल के पैरामीटर के रूप में पास किया जाता है। कस्टम URL योजना लाने के लिए उपयोग किए गए URLComponents ऑब्जेक्ट को पार्स करके आप वर्तमान लूप संख्या भी प्राप्त कर सकते हैं:

तीव्र

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

एक परीक्षण जल्दी समाप्त करें

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

तीव्र

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

आपका गेम लूप परीक्षण वर्तमान लूप को समाप्त करता है और अगले लूप को निष्पादित करता है। जब चलाने के लिए और लूप नहीं होते हैं, तो परीक्षण समाप्त हो जाता है।

कस्टम परीक्षा परिणाम लिखें

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

  • फ़ाइल प्रकार, आकार या मात्रा की परवाह किए बिना सभी परिणाम फ़ाइलें अपलोड की जाती हैं।

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

कस्टम परीक्षण परिणाम लिखने के लिए अपना परीक्षण सेट करने के लिए:

  1. अपने ऐप की Documents निर्देशिका में, GameLoopResults नामक एक निर्देशिका बनाएँ।

  2. अपने ऐप के कोड में कहीं से भी (जैसे, आपका ऐप प्रतिनिधि), निम्नलिखित जोड़ें:

    तीव्र

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

    उद्देश्य सी

    /// 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. सुनिश्चित करें कि ऐप में सभी कलाकृतियों पर हस्ताक्षर किए गए हैं। उदाहरण के लिए, आप प्रोविजनिंग प्रोफाइल और पहचान जैसी हस्ताक्षर सेटिंग्स निर्दिष्ट करके एक्सकोड के माध्यम से ऐसा कर सकते हैं। अधिक जानकारी के लिए, देखें: Apple कोड डिज़ाइनिंग

चरण 4 : अपलोड करने के लिए अपने ऐप को पैकेज करें

अपने ऐप के लिए एक IPA फ़ाइल जनरेट करें (आपको बाद में इसका पता लगाने की आवश्यकता होगी)।

  1. दिखाई देने वाले ड्रॉप-डाउन मेनू से, Product > Archive पर क्लिक करें। सबसे हालिया संग्रह का चयन करें, फिर ऐप वितरित करें पर क्लिक करें।

  2. दिखाई देने वाली विंडो में, Development > Next पर क्लिक करें।

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

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

चरण 5 : ऐप हस्ताक्षर सत्यापित करें

  1. .Ipa फ़ाइल को अनज़िप करके ऐप सिग्नेचर को सत्यापित करें और फिर codesign --verify --deep --verbose /path/to/MyApp.app चलाएँ जहाँ "MyApp" अनज़िप फ़ोल्डर के अंदर ऐप का नाम है (प्रत्येक प्रोजेक्ट के लिए भिन्न होता है) ). अपेक्षित आउटपुट MyApp.app: valid on disk है।

चरण 6 : अपना परीक्षण स्थानीय स्तर पर चलाएँ

टेस्ट लैब के साथ चलाने से पहले आप अपना परीक्षण स्थानीय स्तर पर चलाकर उसके व्यवहार की जांच कर सकते हैं। स्थानीय रूप से परीक्षण करने के लिए, अपने गेमिंग ऐप को एक सिम्युलेटर में लोड करें और चलाएं:

xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://
  • आप अपने सिम्युलेटर के UDID को 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

अगले कदम

Firebase कंसोल या gcloud CLI का उपयोग करके अपना परीक्षण चलाएँ।