ترجمت واجهة Cloud Translation API‏ هذه الصفحة.

ابدأ باختبارات Game Loop لنظام iOS

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

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

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

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

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

الخطوة 1: قم بتسجيل مخطط URL المخصص الخاص بـ Test Lab

أولاً ، يجب عليك تسجيل مخطط عنوان URL المخصص لـ Firebase Test Lab في تطبيقك:

في Xcode ، حدد هدف المشروع.
انقر فوق علامة التبويب معلومات، ثم إضافة نوع URL الجديد.

في مجال أنظمة 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>

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

الخطوة 2 (اختياري): تكوين التطبيق الخاص بك لتشغيل حلقات متعددة

إذا كان تطبيقك يحتوي على عدة مخططات عناوين 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 المستخدم لتشغيل التطبيق. يمكنك أيضا الحصول على عدد الحلقة الحالية من خلال تحليل 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 أو مع CLI gcloud بيتا . إذا لم تكن قد قمت بذلك بالفعل ، فقم بإنشاء ملف IPA لتطبيقك (ستحتاج إلى تحديد موقعه لاحقًا).

قم بإنشاء IPA لتطبيقك

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

قم بإجراء اختبار في وحدة تحكم Firebase

إذا كنت لم تقم بذلك بالفعل، فتح وحدة التحكم Firebase وإنشاء المشروع.
على الصفحة مختبر فحص للوحدة Firebase، انقر فوق تشغيل اختبار الخاصة بك أولا> تشغيل لدائرة الرقابة الداخلية لعبة حلقة.
في قسم تحميل التطبيقات، انقر فوق استعراض، ثم حدد ملف IPA التطبيق الخاص بك (إذا كنت لم تقم بذلك بالفعل، إنشاء ملف IPA عن التطبيق الخاص بك).
اختياري: إذا كنت ترغب في تشغيل الحلقات متعددة (ويعرف أيضا باسم سيناريوهات) في وقت أو حدد حلقات محددة لتشغيل، وإدخال الأرقام حلقة في مجال السيناريوهات.
على سبيل المثال، عند إدخال "1-3، 5"، ويدير مختبر فحص الحلقات 1 و 2 و 3 و 5. افتراضيا (إذا لم تقم بإدخال أي شيء في مجال السيناريوهات المحتملة)، اختبار مختبر يعمل فقط حلقة 1.
في قسم الأجهزة، اختر واحدا أو أكثر المادية الأجهزة التي تريد اختبار التطبيق الخاص بك، ثم انقر فوق الاختبارات ابدأ.

قم بإجراء اختبار باستخدام gcloud beta CLI

إذا لم تكن بالفعل، تكوين بيئة gcloud SDK المحلية الخاصة بك، ثم تأكد من تثبيت المكون gcloud بيتا .
تشغيل gcloud beta firebase test ios run الأوامر واستخدام العلامات التالية لتكوين المدى:

علامات اختبارات Game Loop
`--type`	مطلوب: تحديد نوع الاختبار دائرة الرقابة الداخلية الذي تريد تشغيله. يمكنك إدخال أنواع اختبار `xctest` (الافتراضي) أو `game-loop` .
`--app`	المطلوب: مسار المطلق (جوجل سحابة التخزين أو الملفات) إلى ملف IPA التطبيق الخاص بك. هذه العلامة صالحة فقط عند إجراء اختبارات Game Loop.
`--scenario-numbers`	الحلقات (المعروفة أيضًا بالسيناريوهات) التي تريد تشغيلها في تطبيقك. يمكنك إدخال حلقة واحدة ، أو قائمة أو حلقات ، أو نطاق من الحلقات. الحلقة الافتراضية هي 1. على سبيل المثال، `--scenario-numbers=1-3,5` يدير حلقات 1 و 2 و 3 و 5.
`--device-model`	الجهاز المادي الذي تريد تشغيله الاختبار على (معرفة أي الأجهزة المتوفرة التي يمكنك استخدامها).
`--timeout`	المدة القصوى التي تريد تشغيل اختبارك فيها. يمكنك إدخال عدد صحيح لتمثيل المدة بالثواني ، أو عدد صحيح وتعداد لتمثيل المدة كوحدة زمنية أطول. على سبيل المثال: `--timeout=200` القوات اختبار لإنهاء عند تشغيله حتى 200 ثانية. `--timeout=1h` القوات اختبار لإنهاء عند تشغيله تصل إلى ساعة.

على سبيل المثال ، يقوم الأمر التالي بتشغيل اختبار Game Loop الذي ينفذ الحلقات 1 و 4 و 6 و 7 و 8 على iPhone 8 Plus:

gcloud beta firebase test ios run
 --type game-loop --app path/to/my/App.ipa --scenario-numbers 1,4,6-8
 --device-model=iphone8plus

لمزيد من المعلومات عن CLI gcloud، راجع الوثائق المرجعية .

قم بإجراء اختبار محليًا

لإجراء الاختبار محليًا ، قم بتحميل تطبيق الألعاب الخاص بك في جهاز محاكاة وقم بتشغيل:

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

أنهِ الاختبار مبكرًا

بشكل افتراضي ، يستمر اختبار Game Loop في العمل حتى يصل إلى مهلة خمس دقائق ، حتى عندما يتم تنفيذ جميع الحلقات. عند الوصول إلى المهلة ، ينتهي الاختبار ويلغي أي حلقات معلقة. يمكنك تسريع الاختبار أو وضع حد لها في وقت مبكر عن طريق الاتصال مخطط 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) {}];
}

ينهي اختبار Game Loop الحلقة الحالية وينفذ الحلقة التالية. عندما لا يكون هناك المزيد من الحلقات للتشغيل ، ينتهي الاختبار.

اكتب نتائج الاختبار المخصصة

يمكنك تكوين اختبار Game Loop لكتابة نتائج اختبار مخصصة لنظام ملفات جهازك. بهذه الطريقة، عند الاختبار يبدأ تشغيل، مختبر فحص بتخزين الملفات النتيجة في GameLoopsResults دليل على جهاز الاختبار الخاص بك (التي يجب أن تصنع لنفسك). عند انتهاء الاختبار، اختبار مختبر يتحرك كافة الملفات من GameLoopResults الدليل إلى دلو المشروع الخاص بك. ضع ما يلي في الاعتبار عند إعداد اختبارك:

يتم تحميل جميع ملفات النتائج بغض النظر عن نوع الملف أو حجمه أو كميته.
لا يقوم مختبر الاختبار بمعالجة نتائج الاختبار الخاصة بك حتى تنتهي جميع الحلقات في اختبارك من التشغيل ، لذلك إذا كان الاختبار الخاص بك يتضمن حلقات متعددة تكتب المخرجات ، فتأكد من إلحاقها بملف نتيجة فريد أو إنشاء ملف نتيجة لكل حلقة. بهذه الطريقة ، يمكنك تجنب الكتابة فوق النتائج من حلقة سابقة.

لإعداد اختبارك لكتابة نتائج اختبار مخصصة:

في التطبيق الخاص بك Documents الدليل، إنشاء دليل يدعى GameLoopResults .

من أي مكان في رمز التطبيق الخاص بك (على سبيل المثال ، مفوض التطبيق الخاص بك) ، أضف ما يلي:

سويفت

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