iOS এর জন্য গেম লুপ পরীক্ষা দিয়ে শুরু করুন

গেম লুপ পরীক্ষার মাধ্যমে, আপনি আপনার গেম ইঞ্জিনের জন্য নেটিভ পরীক্ষা লিখতে পারেন এবং তারপরে আপনার চয়ন করা ডিভাইসগুলিতে Test Lab চালাতে পারেন। এইভাবে, আপনাকে বিভিন্ন UI বা পরীক্ষার কাঠামোর জন্য লেখার বিষয়ে চিন্তা করতে হবে না। একটি গেম লুপ পরীক্ষা একজন প্রকৃত খেলোয়াড়ের ক্রিয়াগুলিকে অনুকরণ করে, এবং যখন আপনি এটিকে Test Lab চালান, এটি আপনার ব্যবহারকারীদের জন্য আপনার গেমটি ভাল পারফর্ম করছে কিনা তা যাচাই করার একটি দ্রুত এবং মাপযোগ্য উপায় প্রদান করে৷

এই পৃষ্ঠাটি আপনাকে দেখায় কিভাবে একটি গেম লুপ পরীক্ষা চালাতে হয়, তারপর Firebase কনসোলের Test Lab পৃষ্ঠায় আপনার পরীক্ষার ফলাফল দেখুন এবং পরিচালনা করুন। এছাড়াও আপনি ঐচ্ছিক বৈশিষ্ট্যগুলির সাথে আপনার পরীক্ষাগুলিকে আরও কাস্টমাইজ করতে পারেন, যেমন কাস্টম পরীক্ষার ফলাফল লেখা বা আপনার পরীক্ষা তাড়াতাড়ি শেষ করা

একটি গেম লুপ টেস্ট কি?

লুপ হল আপনার গেমিং অ্যাপে আপনার পরীক্ষার সম্পূর্ণ বা আংশিক রান-থ্রু। আপনি স্থানীয়ভাবে একটি সিমুলেটর বা Test Lab ডিভাইসের একটি সেটে একটি গেম লুপ পরীক্ষা চালাতে পারেন৷ গেম লুপ পরীক্ষাগুলি ব্যবহার করা যেতে পারে:

  • আপনার গেমটি চালান যেহেতু একজন শেষ ব্যবহারকারী এটি খেলবেন। আপনি হয় ব্যবহারকারীর ইনপুট স্ক্রিপ্ট করতে পারেন, ব্যবহারকারীকে নিষ্ক্রিয় থাকতে দিন বা ব্যবহারকারীকে একটি AI দিয়ে প্রতিস্থাপন করতে পারেন (উদাহরণস্বরূপ, আপনি যদি একটি গাড়ি রেসিং গেমে AI প্রয়োগ করেন, আপনি ব্যবহারকারীর ইনপুটের দায়িত্বে একজন AI ড্রাইভারকে রাখতে পারেন) .

  • কোন ডিভাইসগুলি এটি সমর্থন করতে পারে তা খুঁজে বের করতে সর্বোচ্চ মানের সেটিংসে আপনার গেমটি চালান৷

  • একটি প্রযুক্তিগত পরীক্ষা চালান, যেমন একাধিক শেডার কম্পাইল করা, সেগুলি কার্যকর করা এবং আউটপুট প্রত্যাশিত কিনা তা পরীক্ষা করা।

ধাপ 1: Test Lab কাস্টম ইউআরএল স্কিম নিবন্ধন করুন

প্রথমে, আপনাকে অবশ্যই আপনার অ্যাপে Firebase Test Lab কাস্টম URL স্কিম নিবন্ধন করতে হবে:

  1. এক্সকোডে, একটি প্রকল্প লক্ষ্য নির্বাচন করুন।

  2. তথ্য ট্যাবে ক্লিক করুন, তারপর একটি নতুন URL টাইপ যোগ করুন।

  3. URL স্কিম ক্ষেত্রে, firebase-game-loop লিখুন। আপনি <dict> ট্যাগের মধ্যে যেকোন জায়গায় আপনার প্রকল্পের Info.plist কনফিগারেশন ফাইলে যোগ করে কাস্টম URL স্কিম নিবন্ধন করতে পারেন:

    <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 (ঐচ্ছিক): একাধিক লুপ চালানোর জন্য আপনার অ্যাপ কনফিগার করুন

যদি আপনার অ্যাপের একাধিক কাস্টম ইউআরএল স্কিম নিবন্ধিত থাকে এবং আপনি আপনার পরীক্ষায় একাধিক লুপ (ওরফে দৃশ্যকল্প) চালানোর পরিকল্পনা করেন, তাহলে লঞ্চের সময় আপনি আপনার অ্যাপে কোন লুপ চালাতে চান তা অবশ্যই উল্লেখ করতে হবে।

আপনার অ্যাপ প্রতিনিধিতে, 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
}

উদ্দেশ্য-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:).
  }
}

আপনি যখন আপনার পরীক্ষায় একাধিক লুপ চালান, তখন বর্তমান লুপটি অ্যাপটি চালু করতে ব্যবহৃত URL-এ একটি প্যারামিটার হিসেবে পাস করা হয়। আপনি কাস্টম 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).
}

উদ্দেশ্য-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: একটি পরীক্ষা তৈরি করুন এবং চালান

আপনি Test Lab কাস্টম URL স্কিম নিবন্ধন করার পরে, আপনি Firebase কনসোলে বা gcloud বিটা CLI এর সাথে আপনার পরীক্ষা চালাতে পারেন। যদি আপনি ইতিমধ্যেই না করে থাকেন তবে আপনার অ্যাপের জন্য একটি IPA ফাইল তৈরি করুন (আপনাকে পরে এটি সনাক্ত করতে হবে)।

Firebase কনসোলে একটি পরীক্ষা চালান

  1. আপনি যদি ইতিমধ্যে না করে থাকেন তাহলে Firebase কনসোলটি খুলুন এবং একটি প্রকল্প তৈরি করুন৷

  2. Firebase কনসোলের Test Lab পৃষ্ঠায়, আপনার প্রথম পরীক্ষা চালান > একটি iOS গেম লুপ চালান ক্লিক করুন।

  3. আপলোড অ্যাপ বিভাগে, ব্রাউজ ক্লিক করুন, তারপরে আপনার অ্যাপের IPA ফাইল নির্বাচন করুন (যদি আপনি ইতিমধ্যে না থাকেন তবে আপনার অ্যাপের জন্য একটি IPA ফাইল তৈরি করুন )।

  4. ঐচ্ছিক : আপনি যদি একবারে একাধিক লুপ (ওরফে দৃশ্যকল্প) চালাতে চান বা চালানোর জন্য নির্দিষ্ট লুপ নির্বাচন করতে চান, তাহলে দৃশ্যকল্প ক্ষেত্রে লুপ সংখ্যা লিখুন।

    উদাহরণ স্বরূপ, আপনি যখন "1-3, 5" লিখবেন, Test Lab লুপ 1, 2, 3, এবং 5 চালায়। ডিফল্টরূপে (যদি আপনি দৃশ্যকল্প ক্ষেত্রে কিছু না লিখে থাকেন), Test Lab শুধুমাত্র লুপ 1 চালায়।

  5. ডিভাইস বিভাগে, আপনি আপনার অ্যাপ পরীক্ষা করতে চান এমন এক বা একাধিক শারীরিক ডিভাইস নির্বাচন করুন, তারপরে টেস্ট শুরু করুন-এ ক্লিক করুন।

gcloud বিটা CLI দিয়ে একটি পরীক্ষা চালান

  1. যদি আপনি ইতিমধ্যেই না করে থাকেন, তাহলে আপনার স্থানীয় gcloud SDK পরিবেশ কনফিগার করুন, তারপর gcloud বিটা উপাদানটি ইনস্টল করতে ভুলবেন না।

  2. gcloud beta firebase test ios run কমান্ডটি চালান এবং রান কনফিগার করতে নিম্নলিখিত পতাকাগুলি ব্যবহার করুন:

গেম লুপ পরীক্ষার জন্য পতাকা
--type

প্রয়োজনীয় : আপনি যে ধরনের iOS পরীক্ষা চালাতে চান তা নির্দিষ্ট করে। আপনি পরীক্ষার ধরন লিখতে পারেন xctest (ডিফল্ট) বা game-loop

--app

প্রয়োজনীয় : আপনার অ্যাপের IPA ফাইলের সম্পূর্ণ পথ ( Google Cloud Storage বা ফাইল সিস্টেম)। গেম লুপ পরীক্ষা চালানোর সময় এই পতাকাটি শুধুমাত্র বৈধ।

--scenario-numbers

লুপগুলি (ওরফে দৃশ্যকল্পগুলি) আপনি আপনার অ্যাপে চালাতে চান৷ আপনি একটি লুপ, একটি তালিকা বা লুপ, বা লুপের একটি পরিসর লিখতে পারেন। ডিফল্ট লুপ হল 1।

উদাহরণস্বরূপ, --scenario-numbers=1-3,5 রান লুপ 1, 2, 3, এবং 5।

--device-model

আপনি যে শারীরিক ডিভাইসে আপনার পরীক্ষা চালাতে চান (আপনি কোন উপলব্ধ ডিভাইস ব্যবহার করতে পারেন তা খুঁজে বের করুন)।

--timeout

সর্বোচ্চ সময়কাল আপনি আপনার পরীক্ষা চালানোর জন্য চান. আপনি সেকেন্ডে সময়কাল প্রতিনিধিত্ব করতে একটি পূর্ণসংখ্যা লিখতে পারেন, অথবা একটি পূর্ণসংখ্যা এবং গণনা সময়কালের একটি দীর্ঘ একক হিসাবে উপস্থাপন করতে পারেন।

যেমন:

  • --timeout=200 আপনার পরীক্ষাটি 200 সেকেন্ড পর্যন্ত চলে গেলে তা বন্ধ করতে বাধ্য করে।
  • --timeout=1h আপনার পরীক্ষা বন্ধ করতে বাধ্য করে যখন এটি এক ঘন্টা পর্যন্ত চলে।

উদাহরণস্বরূপ, নিম্নলিখিত কমান্ডটি একটি গেম লুপ পরীক্ষা চালায় যা একটি আইফোন 8 প্লাসে লুপ 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 কমান্ড চালিয়ে আপনার সিমুলেটরের UDID খুঁজে পেতে পারেন।

  • যদি শুধুমাত্র একটি সিমুলেটর চালু থাকে, তাহলে 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

একটি পরীক্ষা তাড়াতাড়ি শেষ করুন

ডিফল্টরূপে, একটি গেম লুপ পরীক্ষা চলতে থাকে যতক্ষণ না এটি পাঁচ মিনিটের একটি টাইমআউটে পৌঁছায়, এমনকি যখন সমস্ত লুপগুলি কার্যকর করা হয়। যখন টাইমআউট হয়ে যায়, পরীক্ষা শেষ হয় এবং যেকোন মুলতুবি লুপ বাতিল করে। আপনি আপনার অ্যাপের AppDelegate-এ Test Lab এর কাস্টম URL স্কিম 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)
}

উদ্দেশ্য-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. আপনার অ্যাপের কোডের যেকোনো স্থান থেকে (যেমন, আপনার অ্যাপ প্রতিনিধি), নিম্নলিখিত যোগ করুন:

    সুইফট

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

    উদ্দেশ্য-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];
        }
    }