Oyun döngüsü testleriyle, oyun motorunuza özgü testler yazabilir ve bunları seçtiğiniz cihazlarda Test Lab içinde çalıştırabilirsiniz. Bu sayede, farklı kullanıcı arayüzleri veya test çerçeveleri için yazma konusunda endişelenmenize gerek kalmaz. Oyun döngüsü testi, gerçek bir oyuncunun işlemlerini simüle eder ve Test Lab üzerinde çalıştırıldığında, oyununuzun kullanıcılarınız için iyi performans gösterdiğini doğrulamanın hızlı ve ölçeklenebilir bir yolunu sunar.
Bu sayfada, Game Loop testi çalıştırma, ardından test sonuçlarınızı Firebase konsolunun Test Lab sayfasında görüntüleme ve yönetme hakkında bilgi verilmektedir. Ayrıca, özel test sonuçları yazma veya testinizi erken sonlandırma gibi isteğe bağlı özelliklerle testlerinizi daha da özelleştirebilirsiniz.
Oyun Döngüsü testi nedir?
Döngü, oyun uygulamanızdaki testinizin tam veya kısmi bir çalıştırılmasıdır. Oyun döngüsü testini yerel olarak bir simülatörde veya Test Lab'daki bir cihaz grubunda çalıştırabilirsiniz. Oyun Döngüsü testleri şu amaçlarla kullanılabilir:
Oyununuzu son kullanıcı gibi oynayarak test edin. Kullanıcının girişini komut dosyasıyla yazabilir, kullanıcının boşta kalmasına izin verebilir veya kullanıcıyı bir yapay zeka ile değiştirebilirsiniz (örneğin, araba yarışı oyununda yapay zeka uyguladıysanız kullanıcının girişinden sorumlu bir yapay zeka sürücüsü atayabilirsiniz).
Hangi cihazların destekleyebileceğini öğrenmek için oyununuzu en yüksek kalite ayarında çalıştırın.
Birden fazla gölgelendiriciyi derleme, bunları yürütme ve çıktının beklendiği gibi olup olmadığını kontrol etme gibi teknik bir test yapın.
1. adım: Test Lab uygulamasının özel URL şemasını kaydedin
Öncelikle uygulamanızda Firebase Test Lab'nın özel URL şemasını kaydetmeniz gerekir:
Xcode'da bir proje hedefi seçin.
Bilgi sekmesini tıklayın, ardından yeni bir URL türü ekleyin.
URL Şemaları alanına
firebase-game-loopgirin. Özel URL şemasını, projenizinInfo.plistyapılandırma dosyasına<dict>etiketi içinde herhangi bir yere ekleyerek de kaydedebilirsiniz:<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>
Uygulamanız artık Test Lab kullanarak test çalıştıracak şekilde yapılandırıldı.
2. adım (isteğe bağlı): Uygulamanızı birden fazla döngü çalıştıracak şekilde yapılandırın
Uygulamanızda birden fazla özel URL şeması kayıtlıysa ve testinizde birden fazla döngü (diğer adıyla senaryo) çalıştırmayı planlıyorsanız başlatma sırasında uygulamanızda hangi döngüleri çalıştırmak istediğinizi belirtmeniz gerekir.
Uygulama temsilcinizde application(_:open:options:) yöntemini geçersiz kılın:
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 <UIApplicationOpenURLOptionsKey, id> *)options {
if ([url.scheme isEqualToString:(@"firebase-game-loop")]) {
// ...Enter Game Loop Test logic to override application(_:open:options:).
}
}
Testinizde birden fazla döngü çalıştırdığınızda mevcut döngü, uygulamayı başlatmak için kullanılan URL'ye parametre olarak iletilir. Özel URL şemasını getirmek için kullanılan URLComponents nesnesini ayrıştırarak da mevcut döngü numarasını elde edebilirsiniz:
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).
}
}
}
3. adım: Test oluşturun ve çalıştırın
Test Lab uygulamasının özel URL şemasını kaydettikten sonra testinizi Firebase konsolunda veya gcloud beta CLI ile çalıştırabilirsiniz. Henüz yapmadıysanız uygulamanız için bir IPA dosyası oluşturun (daha sonra bu dosyayı bulmanız gerekir).
Firebase konsolunda test çalıştırma
Henüz yapmadıysanız Firebase konsolunu açıp bir proje oluşturun.
Firebase konsolunun Test Lab sayfasında İlk Testinizi Çalıştırın > iOS Oyun Döngüsü Çalıştırın'ı tıklayın.
Uygulama Yükle bölümünde Gözat'ı tıklayın, ardından uygulamanızın IPA dosyasını seçin (Henüz yapmadıysanız uygulamanız için IPA dosyası oluşturun).
İsteğe bağlı: Aynı anda birden fazla döngü (diğer adıyla senaryo) çalıştırmak veya çalıştırmak için belirli döngüleri seçmek istiyorsanız döngü numaralarını Senaryolar alanına girin.
Örneğin, "1-3, 5" yazdığınızda Test Lab, 1, 2, 3 ve 5 numaralı döngüleri oynatır. Varsayılan olarak (Senaryolar alanına herhangi bir şey girmezseniz) Test Lab yalnızca 1. döngüyü çalıştırır.
Cihazlar bölümünde, uygulamanızı test etmek istediğiniz bir veya daha fazla fiziksel cihazı seçin, ardından Testleri Başlat'ı tıklayın.
gcloud beta KSA ile test çalıştırma
Henüz yapmadıysanız yerel gcloud SDK ortamınızı yapılandırın, ardından gcloud beta bileşenini yüklediğinizden emin olun.
gcloud beta firebase test ios runkomutunu çalıştırın ve çalıştırmayı yapılandırmak için aşağıdaki işaretleri kullanın:
| Oyun Döngüsü testleriyle ilgili işaretler | |
|---|---|
--type
|
Zorunlu: Çalıştırmak istediğiniz iOS testi türünü belirtir. |
--app
|
Zorunlu: Uygulamanızın IPA dosyasına ait mutlak yol (Google Cloud Storage veya dosya sistemi). Bu işaret yalnızca Oyun Döngüsü testleri çalıştırılırken geçerlidir. |
--scenario-numbers
|
Uygulamanızda çalıştırmak istediğiniz döngüler (diğer adıyla senaryolar). Tek bir döngü, döngü listesi veya döngü aralığı girebilirsiniz. Varsayılan döngü sayısı 1'dir.
Örneğin, |
--device-model
|
Testinizi üzerinde çalıştırmak istediğiniz fiziksel cihaz (kullanabileceğiniz mevcut cihazları öğrenin). |
--timeout
|
Testinizin çalıştırılmasını istediğiniz maksimum süre. Süreyi saniye cinsinden ifade etmek için bir tam sayı veya süreyi daha uzun bir zaman birimi olarak ifade etmek için bir tam sayı ve numaralandırma girebilirsiniz. Örneğin:
|
Örneğin, aşağıdaki komut bir iPhone 8 Plus'ta 1, 4, 6, 7 ve 8 döngülerini yürüten bir Oyun Döngüsü testi çalıştırır:
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 hakkında daha fazla bilgi için referans belgelerine bakın.
Yerel olarak test çalıştırma
Testinizi yerel olarak çalıştırmak için oyun uygulamanızı bir simülatöre yükleyin ve şu komutu çalıştırın:
xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://
instruments -s deviceskomutunu çalıştırarak simülatörünüzün UDID'sini bulabilirsiniz.Yalnızca bir simülatör çalışıyorsa SIMULATOR_UDID yerine özel dizeyi
"booted"girin.
Testinizde birden fazla döngü varsa scenario işaretine döngü numarasını ileterek hangi döngüyü çalıştırmak istediğinizi belirtebilirsiniz. Testinizi yerel olarak çalıştırırken aynı anda yalnızca bir döngü çalıştırabileceğinizi unutmayın. Örneğin, 1, 2 ve 5 numaralı döngüleri çalıştırmak istiyorsanız her döngü için ayrı bir komut çalıştırmanız gerekir:
xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=1xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=2xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=5
Testi erken sonlandırma
Varsayılan olarak, tüm döngüler yürütülmüş olsa bile Oyun Döngüsü testi beş dakikalık bir zaman aşımına ulaşana kadar çalışmaya devam eder. Zaman aşımına ulaşıldığında test sona erer ve bekleyen tüm döngüler iptal edilir. Uygulamanızın AppDelegate'inde Test Lab'nin özel URL şemasını
firebase-game-loop-complete çağırarak testinizi hızlandırabilir veya erken sonlandırabilirsiniz. Örneğin:
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) {}];
}
Oyun Döngüsü testiniz, mevcut döngüyü sonlandırır ve bir sonraki döngüyü yürütür. Çalıştırılacak başka döngü kalmadığında test sona erer.
Özel test sonuçları yazma
Oyun döngüsü testinizi, özel test sonuçlarını cihazınızın dosya sistemine yazacak şekilde yapılandırabilirsiniz. Bu sayede test çalışmaya başladığında Test Lab, sonuç dosyalarını test cihazınızda GameLoopsResults dizinine (kendiniz oluşturmanız gerekir) kaydeder. Test sona erdiğinde Test Lab, GameLoopResults dizinindeki tüm dosyaları projenizin paketi içine taşır. Testinizi ayarlarken aşağıdaki noktaları göz önünde bulundurun:
Dosya türü, boyutu veya miktarı ne olursa olsun tüm sonuç dosyaları yüklenir.
Test Lab, testinizdeki tüm döngüler çalışmayı bitirene kadar test sonuçlarınızı işlemez. Bu nedenle, testinizde çıktı yazan birden fazla döngü varsa bunları benzersiz bir sonuç dosyasına eklediğinizden veya her döngü için bir sonuç dosyası oluşturduğunuzdan emin olun. Bu sayede, önceki döngüdeki sonuçların üzerine yazılmasını önleyebilirsiniz.
Özel test sonuçları yazmak için testinizi ayarlamak üzere:
Uygulamanızın
DocumentsdizinindeGameLoopResultsadlı bir dizin oluşturun.Uygulamanızın kodunda herhangi bir yerden (ör. uygulama temsilciniz) aşağıdakileri ekleyin:
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]; } }