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

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

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

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

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

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

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

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

ধাপ ১: Test Lab কাস্টম URL স্কিম নিবন্ধন করুন

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

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

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

  3. URL Schemes ক্ষেত্রে, 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 ব্যবহার করে একটি পরীক্ষা চালানোর জন্য কনফিগার করা হয়েছে।

ধাপ ২ (ঐচ্ছিক): একাধিক লুপ চালানোর জন্য আপনার অ্যাপটি কনফিগার করুন

যদি আপনার অ্যাপে একাধিক কাস্টম URL স্কিম নিবন্ধিত থাকে এবং আপনি আপনার পরীক্ষায় একাধিক লুপ (যেমন পরিস্থিতি) চালানোর পরিকল্পনা করেন, তাহলে লঞ্চের সময় আপনার অ্যাপে কোন লুপগুলি চালাতে চান তা নির্দিষ্ট করতে হবে।

আপনার অ্যাপ ডেলিগেটে, 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-এ একটি প্যারামিটার হিসেবে পাস করা হয়। আপনি কাস্টম 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).
        }
    }
}

ধাপ ৩: একটি পরীক্ষা তৈরি করুন এবং চালান

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

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

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

  2. Firebase কনসোলের Test Lab পৃষ্ঠায়, Run Your First Test > Run an iOS Game Loop এ ক্লিক করুন।

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

  4. ঐচ্ছিক : যদি আপনি একসাথে একাধিক লুপ (যেমন পরিস্থিতি) চালাতে চান অথবা নির্দিষ্ট লুপ নির্বাচন করতে চান, তাহলে "Scenarios" ক্ষেত্রে লুপ নম্বরগুলি লিখুন।

    উদাহরণস্বরূপ, যখন আপনি "1-3, 5" লিখবেন, তখন Test Lab লুপ 1, 2, 3, এবং 5 চালাবে। ডিফল্টরূপে (যদি আপনি Scenarios ক্ষেত্রে কিছু না প্রবেশ করান), 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 ফ্ল্যাগে পাস করে কোন লুপটি চালাতে চান তা নির্দিষ্ট করতে পারেন। মনে রাখবেন যে স্থানীয়ভাবে আপনার পরীক্ষা চালানোর সময় আপনি একবারে কেবল একটি লুপ চালাতে পারবেন। উদাহরণস্বরূপ, যদি আপনি লুপ ১, ২ এবং ৫ চালাতে চান, তাহলে আপনাকে প্রতিটি লুপের জন্য একটি পৃথক কমান্ড চালাতে হবে:

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

অবজেক্টিভ-সি 

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

    অবজেক্টিভ-সি 

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