Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

इस पेज पर, Game Loop टेस्ट चलाने का तरीका बताया गया है. साथ ही, टेस्ट के नतीजों को Test Lab पेज पर, Firebase कंसोल में देखने और मैनेज करने का तरीका भी बताया गया है. आपके पास, टेस्ट को पसंद के मुताबिक बनाने के लिए, ज़रूरी नहीं वाली सुविधाएं भी होती हैं. जैसे, टेस्ट के नतीजों को पसंद के मुताबिक लिखना या टेस्ट को समय से पहले खत्म करना.

Game Loop टेस्ट क्या है?

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

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

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

सबसे पहले, आपको अपने ऐप्लिकेशन में Firebase Test Lab's कस्टम यूआरएल स्कीम को रजिस्टर करना होगा:

Xcode में, किसी प्रोजेक्ट टारगेट को चुनें.
जानकारी टैब पर क्लिक करें. इसके बाद, नया यूआरएल टाइप जोड़ें.
यूआरएल स्कीम फ़ील्ड में, 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).
        }
    }
}

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

Test Lab के कस्टम यूआरएल स्कीम को रजिस्टर करने के बाद, आप अपना टेस्ट Firebase कंसोल या gcloud beta CLI की मदद से चला सकते हैं. अगर आपने अब तक अपने ऐप्लिकेशन के लिए कोई IPA फ़ाइल जनरेट नहीं की है, तो उसे जनरेट करें. आपको बाद में इसकी ज़रूरत पड़ेगी.

अपने ऐप्लिकेशन के लिए IPA जनरेट करना

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

Firebase कंसोल में टेस्ट चलाना

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

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

gcloud beta CLI की मदद से टेस्ट चलाना

अगर आपने अब तक अपने स्थानीय gcloud SDK एनवायरमेंट को कॉन्फ़िगर नहीं किया है, तो उसे कॉन्फ़िगर करें. इसके बाद, gcloud beta कॉम्पोनेंट इंस्टॉल करना न भूलें.
gcloud beta firebase test ios run कमांड चलाएं. साथ ही, रन को कॉन्फ़िगर करने के लिए, इन फ़्लैग का इस्तेमाल करें:

Game Loop टेस्ट के लिए फ़्लैग
`--type`	ज़रूरी है: यह बताता है कि आपको किस तरह का iOS टेस्ट चलाना है. टेस्ट टाइप `xctest` (डिफ़ॉल्ट) या `game-loop` डाले जा सकते हैं.
`--app`	ज़रूरी है: आपके ऐप्लिकेशन की IPA फ़ाइल का पूरा पाथ (Google Cloud Storage या फ़ाइल सिस्टम). यह फ़्लैग, सिर्फ़ Game Loop टेस्ट चलाने पर मान्य होता है.
`--scenario-numbers`	वे लूप (यानी, सिनेरियो) जिन्हें आपको अपने ऐप्लिकेशन में चलाना है. इसमें एक लूप, लूप की सूची या लूप की रेंज डाली जा सकती है. डिफ़ॉल्ट लूप 1 होता है. उदाहरण के लिए, `--scenario-numbers=1-3,5` से लूप 1, 2, 3, और 5 चलते हैं.
`--device-model`	वह फ़िज़िकल डिवाइस जिस पर आपको अपना टेस्ट चलाना है यह पता करें कि आपके पास कौनसे डिवाइस उपलब्ध हैं
`--timeout`	वह ज़्यादा से ज़्यादा समय जिसके लिए आपको अपना टेस्ट चलाना है. इसमें सेकंड में समय दिखाने के लिए कोई पूर्णांक या समय की बड़ी यूनिट के तौर पर समय दिखाने के लिए कोई पूर्णांक और एन्यूमरेशन डाला जा सकता है. उदाहरण के लिए: `--timeout=200` से, आपका टेस्ट 200 सेकंड तक चलने के बाद, बंद हो जाता है. `--timeout=1h` से, आपका टेस्ट एक घंटे तक चलने के बाद, बंद हो जाता है.

उदाहरण के लिए, यहां दिया गया कमांड, iPhone 8 Plus पर Game Loop टेस्ट चलाता है. इसमें लूप 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 CLI के बारे में ज़्यादा जानने के लिए, रेफ़रंस दस्तावेज़ देखें.

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

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

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

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

टेस्ट को समय से पहले खत्म करना

डिफ़ॉल्ट रूप से, Game Loop टेस्ट पांच मिनट के टाइम आउट तक चलता रहता है. भले ही, सभी लूप एक्ज़ीक्यूट हो गए हों. टाइम आउट होने पर, टेस्ट खत्म हो जाता है और बाकी बचे लूप रद्द हो जाते हैं. अपने ऐप्लिकेशन के 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) {}];
}

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

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

Game Loop टेस्ट को, डिवाइस के फ़ाइल सिस्टम में टेस्ट के नतीजों को पसंद के मुताबिक लिखने के लिए कॉन्फ़िगर किया जा सकता है. इससे, टेस्ट शुरू होने पर, Test Lab नतीजों की फ़ाइलों को आपके टेस्टिंग डिवाइस पर मौजूद GameLoopsResults डायरेक्ट्री में सेव करता है. यह डायरेक्ट्री आपको खुद बनानी होगी. टेस्ट खत्म होने पर, Test Lab आपके प्रोजेक्ट के बकेट में GameLoopResults डायरेक्ट्री की सभी फ़ाइलों को ले जाता है. टेस्ट सेट अप करते समय, इन बातों का ध्यान रखें:

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

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

अपने ऐप्लिकेशन की Documents डायरेक्ट्री में, GameLoopResults नाम की डायरेक्ट्री बनाएं.

अपने ऐप्लिकेशन के कोड में कहीं से भी (जैसे, अपने ऐप्लिकेशन डेलिगेट), यह जोड़ें:

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