Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

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

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

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

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

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

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

প্রথমে, আপনাকে অবশ্যই আপনার অ্যাপে ফায়ারবেস টেস্ট ল্যাবের কাস্টম ইউআরএল স্কিম নিবন্ধন করতে হবে:

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

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

  3. URL টি স্কিম ক্ষেত্রে, প্রবেশ firebase-game-loop । এছাড়াও আপনি আপনার প্রকল্পের যোগ করে কাস্টম URL স্কিম রেজিস্টার করতে পারেন 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>
    

আপনার অ্যাপটি এখন টেস্ট ল্যাব ব্যবহার করে একটি পরীক্ষা চালানোর জন্য কনফিগার করা হয়েছে।

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

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

আপনার অ্যাপ প্রতিনিধি সালে ওভাররাইড 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 কাস্টম URL স্কিম আনতে ব্যবহৃত বস্তু:

সুইফট

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

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

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

ফায়ারবেস কনসোলে একটি পরীক্ষা চালান

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

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

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

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

    উদাহরণস্বরূপ, যখন আপনি প্রবেশ "1-3, 5" টেস্ট ল্যাব লুপ 1, 2, 3 রানে, আর 5. ডিফল্টরূপে (যদি আপনি প্রেক্ষাপটে ক্ষেত্র কিছু প্রবেশ করো না), টেস্ট ল্যাব শুধুমাত্র লুপ 1 রান।

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

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

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

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

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

আবশ্যক: নির্দিষ্ট করে আইওএস পরীক্ষা আপনি যে প্রকারের চালাতে চান। আপনি পরীক্ষা ধরনের লিখতে পারেন xctest (ডিফল্ট) বা game-loop

--app

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

--scenario-numbers

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

উদাহরণস্বরূপ, --scenario-numbers=1-3,5 রান loops 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://
  • আপনি চলমান করে আপনার কাল্পনিক এর UDID জানতে পারেন 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

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

ডিফল্টরূপে, একটি গেম লুপ পরীক্ষা চলতে থাকে যতক্ষণ না এটি পাঁচ মিনিটের সময়সীমা পর্যন্ত পৌঁছায়, এমনকি যখন সমস্ত লুপগুলি কার্যকর করা হয়। সময়সীমা শেষ হয়ে গেলে, পরীক্ষা শেষ হয় এবং যে কোনও লেন্ডিং লুপ বাতিল করে। তুমি তোমার পরীক্ষা গতি বাড়াতে বা এটা তাড়াতাড়ি শেষ টেস্ট ল্যাব এর কাস্টম URL স্কিম কল করে করতে firebase-game-loop-complete আপনার অ্যাপ্লিকেশনের AppDelegate হবে। উদাহরণ স্বরূপ:

সুইফট

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