গেম লুপ টেস্ট চালানো

বিভিন্ন UI ফ্রেমওয়ার্কে গেমিং অ্যাপ তৈরি করা হলে, গেম টেস্টিং অটোমেট করা কঠিন হতে পারে। Game Loop টেস্ট আপনাকে নেটিভ টেস্টকে Test Lab-এর সাথে ইন্টিগ্রেট করতে এবং আপনার বেছে নেওয়া ডিভাইসে সহজেই রান করতে দেয়। Firebase Test Lab ব্যবহার করে রান করানোর জন্য কীভাবে গেম লুপ টেস্ট প্রস্তুত করতে হয় তা এই নির্দেশিকা বর্ণনা করে।

গেম লুপ টেস্ট সম্পর্কে

গেম লুপ টেস্ট কী?

আপনার গেম দ্রুত ও স্কেলেবল উপায়ে ব্যবহারকারীদের জন্য ভালোভাবে পারফর্ম করছে কিনা তা যাচাই করতে, গেম লুপ টেস্ট একজন আসল প্লেয়ারের অ্যাকশনকে সিমুলেট করে। লুপ হল আপনার গেমিং অ্যাপে আপনার টেস্টের সম্পূর্ণ বা আংশিক রান-থ্রু। আপনি Test Lab-এ সিমুলেটর বা ডিভাইসের সেটে লোকালি গেম লুপ টেস্ট রান করতে পারবেন। Game Loop টেস্ট এইসব কাজে ব্যবহার করা যেতে পারে:

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

ধাপ ১: Test Lab-এর কাস্টম URL স্কিম রেজিস্টার করুন

  1. Xcode-এ, প্রোজেক্ট টার্গেট বেছে নিন।

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

  3. URL স্কিম ফিল্ডে firebase-game-loop লিখুন। এছাড়াও, আপনার প্রোজেক্টের Info.plist কনফিগারেশন ফাইলে <dict> ট্যাগের মধ্যে যেকোনও জায়গায় কাস্টম 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 ব্যবহার করে টেস্ট চালানোর জন্য আপনার অ্যাপ এখন কনফিগার করা হয়েছে।

ধাপ ২: বিকল্প হিসেবে আপনার অ্যাপ কনফিগার করুন

একাধিক লুপ রান করা

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

আপনার অ্যাপ ডেলিগেটে, 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:).
  }
}

আপনার পরীক্ষায় একাধিক লুপ চালালে, বর্তমান লুপটি অ্যাপ লঞ্চ করার জন্য ব্যবহৃত URL-এ প্যারামিটার হিসেবে পাস করা হয়। এছাড়াও, কাস্টম URL স্কিম আনতে ব্যবহৃত 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-এর কাস্টম URL স্কিম 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 টেস্ট কনফিগার করতে পারবেন। এইভাবে, পরীক্ষা চালানো শুরু হলে, 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. এক্সপোর্ট করুন বিকল্পে ক্লিক করুন, তারপর একটি ডিরেক্টরি লিখুন যেখানে আপনি আপনার অ্যাপের 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 কমান্ড চালিয়ে আপনার সিমুলেটরের UDID খুঁজে পেতে পারেন।

  • যদি শুধুমাত্র একটি সিমুলেটর চালু থাকে, তাহলে 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 CLI ব্যবহার করে আপনার পরীক্ষা চালান।