إجراء اختبار حلقة الألعاب

قد يكون من الصعب إجراء اختبارات الألعاب تلقائيًا عندما تكون تطبيقات الألعاب قائمة على أطر عمل واجهة المستخدم. تتيح لك اختبارات Game Loop دمج اختباراتك الأصلية مع Test Lab وتنفيذها بسهولة على الأجهزة التي تختارها. هذا النمط يوضّح هذا الدليل كيفية إعداد اختبار حلقة الألعاب لتشغيله باستخدام Firebase Test Lab.

لمحة عن اختبارات حلقة الألعاب

ما هو اختبار "حلقة الألعاب"؟

يحاكي اختبار حلقة الألعاب إجراءات لاعب حقيقي للتأكّد من أنّ لعبتك تعمل بشكل جيد المستخدمين بطريقة سريعة وقابلة للتوسع. التكرار الحلقي هو إجراء كامل أو جزئي للاختبار على لألعاب الفيديو. يمكنك إجراء اختبار "حلقة الألعاب" محليًا على محاكي أو على مجموعة من الأجهزة في "Test Lab". يمكن استخدام اختبارات Game Loop في ما يلي:

  • شغِّل لعبتك على النحو الذي يريده المستخدم النهائي. يمكنك إما كتابة نص برمجي لإدخال يجب أن يكون المستخدم غير نشِط لفترة قصيرة، أو أن تستبدل المستخدم باستخدام الذكاء الاصطناعي (AI) (على سبيل المثال، في حال تطبيق الذكاء الاصطناعي) في لعبة سباق السيارات، يمكنك استخدام سائق يعتمد على الذكاء الاصطناعي (AI) لتولّي مسؤولية ملاحظات المستخدِم).
  • شغِّل لعبتك بأعلى إعدادات الجودة لمعرفة الأجهزة التي يمكنها تشغيلها.
  • يمكنك إجراء اختبار فني، مثل جمع عدة أدوات تظليل وتنفيذها والتحقق من ذلك. فسيكون الإخراج كما هو متوقع.

الخطوة 1: تسجيل مخطط عنوان URL المخصّص لـ Test Lab

  1. في Xcode، اختَر هدف مشروع.

  2. انقر على علامة التبويب المعلومات، ثم أضِف نوع عنوان URL جديد.

  3. في حقل مخططات عناوين URL، أدخل firebase-game-loop. يمكنك أيضًا تسجيل مخطط عنوان URL المخصص بإضافته إلى عنوان 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>
    

تم إعداد تطبيقك الآن لإجراء اختبار باستخدام Test Lab.

الخطوة 2: ضبط تطبيقك اختياريًا

تنفيذ عدة تكرارات

إذا كنت تخطط لتشغيل تكرارات متعددة (أي سيناريوهات) في الاختبار، يجب تحديد التكرارات التي تريد تشغيلها في التطبيق في وقت التشغيل.

في صفحة التفويض في تطبيقك، يمكنك إلغاء طريقة 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 المستخدَم لتشغيل التطبيق. يمكنك أيضًا الحصول على رقم المحاولة الحالية من خلال تحليل العنصر URLComponents المستخدَم لجلب مخطّط عنوان URL المخصّص:

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

إنهاء الاختبار مبكرًا

بشكل تلقائي، يستمر تشغيل اختبار حلقة الألعاب إلى أن تنتهي صلاحيته. لمدة خمس دقائق، حتى عندما يتم تنفيذ جميع التكرارات. عندما تنتهي المهلة المحددة، وينتهي الاختبار ويلغي أي تكرارات معلقة. يمكنك تسريع الاختبار أو إنهائه مبكرًا من خلال استدعاء مخطّط عنوان URL المخصّصTest Lab firebase-game-loop-complete في AppDelegate لتطبيقك. على سبيل المثال:

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

الخطوة 3: توقيع تطبيقك

  1. يُرجى التأكّد من توقيع جميع العناصر في التطبيق. على سبيل المثال، يمكنك إجراء ذلك عبر Xcode من خلال تحديد إعدادات التوقيع مثل الملف الشخصي لتوفير المتطلبات اللازمة والهوية. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة توقيع الرموز البرمجية من Apple.

الخطوة 4: تجميع تطبيقك لتحميله

أنشئ ملف IPA لتطبيقك (ستحتاج إلى تحديد موقعه لاحقًا).

  1. من القائمة المنسدلة التي تظهر، انقر على المنتج > الأرشفة. اختَر أحدث أرشيف، ثم انقر على توزيع التطبيق.

  2. في النافذة التي تظهر، انقر على التطوير > التالي.

  3. اختياري: للحصول على إصدار أسرع، أزِل العلامة من المربّع بجانب الخيار إعادة الإنشاء من رمز Bitcode، ثم انقر على التالي. Test Lab لا تتطلّب تقليل حجم تطبيقك أو إعادة إنشائه لإجراء اختبار، لذا يمكنك إيقاف هذا الخيار بأمان.

  4. انقر على تصدير، ثم أدخِل دليلاً تريد تنزيلملف IPA الخاص بتطبيقك فيه.

الخطوة 5: التحقّق من توقيع التطبيق

  1. تأكَّد من صحة توقيع التطبيق من خلال فك ضغط ملف .ipa ثم تشغيل codesign --verify --deep --verbose /path/to/MyApp.app ضِمن "MyApp" هو اسم التطبيق داخل المجلد غير المضغوط (يختلف لكل مشروع). الناتج المتوقّع هو MyApp.app: valid on disk.

الخطوة 6: إجراء الاختبار على الجهاز

يمكنك إجراء الاختبار محليًا للتحقّق من سلوكه قبل تنفيذه باستخدام Test Lab لاختبار اللعبة محليًا، حمِّل اللعبة في محاكي وشغِّل ما يلي:

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

الخطوات التالية

إجراء الاختبار باستخدام وحدة تحكُّم Firebase أو gcloud CLI.