Oyun uygulamaları farklı kullanıcı arayüzü çerçeveleri üzerine inşa edildiğinde oyun testini otomatikleştirmek zor olabilir. Game Loop testleri, yerel testlerinizi Test Lab ile entegre etmenize ve seçtiğiniz cihazlarda kolayca çalıştırmanıza olanak tanır. Bu kılavuzda, Firebase Test Lab kullanılarak çalıştırılacak bir Oyun Döngüsü testinin nasıl hazırlanacağı açıklanmaktadır.
Oyun Döngüsü testleri hakkında
Oyun Döngüsü testi nedir?
Oyun döngüsü testi, oyununuzun kullanıcılarınız için hızlı ve ölçeklenebilir bir şekilde iyi performans gösterdiğini doğrulamak amacıyla gerçek bir oyuncunun işlemlerini simüle eder. Döngü, oyun uygulamanızda testinizin tam veya kısmi bir şekilde çalıştırılmasıdır. Oyun döngüsü testini yerel olarak bir simülatörde veya Test Lab'teki bir cihaz grubunda çalıştırabilirsiniz. Oyun döngüsü testleri aşağıdaki amaçlarla kullanılabilir:
- Oyununuzu son kullanıcılar gibi oynayın. Kullanıcının girişini komut dosyası olarak yazabilir, kullanıcının boşta kalmasına izin verebilir veya kullanıcıyı yapay zekayla değiştirebilirsiniz (örneğin, bir araba yarışı oyununda yapay zeka uyguladıysanız kullanıcının girişinden sorumlu bir yapay zeka sürücü kullanabilirsiniz).
- Hangi cihazların destekleyebileceğini öğrenmek için oyununuzu en yüksek kalite ayarıyla çalıştırın.
- Birden fazla gölgelendiriciyi derleme, yürütme ve sonucun beklendiği gibi olup olmadığını kontrol etme gibi teknik bir test çalıştırın.
1. adım: Test Lab'nin özel URL şemasını kaydedin
Xcode'da bir proje hedefi seçin.
Bilgi sekmesini tıklayın ve yeni bir URL türü ekleyin.
URL Şemaları alanına
firebase-game-loop
girin. Özel URL şemasını, projenizinInfo.plist
yapılandırma dosyasına<dict>
etiketinin herhangi bir yerine 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: İsteğe bağlı olarak uygulamanızı yapılandırın
Birden fazla döngü çalıştırma
Testinizde birden fazla döngü (diğer adıyla senaryo) çalıştırmayı planlıyorsanız uygulamanızda başlatma sırasında 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 geçerli döngü, uygulamayı başlatmak için kullanılan URL'ye parametre olarak iletilir. Özel URL şemasını almak için kullanılan URLComponents
nesnesini ayrıştırarak da geçerli 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).
}
}
}
Testi erken sonlandırma
Varsayılan olarak, bir Oyun Döngüsü testi tüm döngüler yürütülmüş olsa bile beş dakikalık 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 sınıfında Test Lab'ın ö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 sonraki döngüyü yürütür. Çalıştırılabilecek başka döngü kalmadığında test sona erer.
Özel test sonuçları yazma
Oyun döngüsü testinizi, cihazınızın dosya sistemine özel test sonuçları yazacak şekilde yapılandırabilirsiniz. Bu sayede, test çalışmaya başladığında Test Lab, sonuç dosyalarını test cihazınızdaki bir GameLoopsResults
dizininde depolar (bu dizini kendiniz oluşturmanız gerekir). Test sona erdiğinde Test Lab, GameLoopResults
dizinindeki tüm dosyaları projenizin paketine taşır. Testinizi oluştururken aşağıdakileri göz önünde bulundurun:
Tüm sonuç dosyaları, dosya türü, boyutu veya miktarından bağımsız olarak yüklenir.
Test Lab, testinizdeki tüm döngüler çalıştırılana kadar test sonuçlarınızı işlemez. Bu nedenle, testinizde çıkış 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.
Testinizi özel test sonuçları yazacak şekilde ayarlamak için:
Uygulamanızın
Documents
dizinindeGameLoopResults
adlı bir dizin oluşturun.Uygulamanızın kodunun herhangi bir yerinden (ö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]; } }
3. Adım: Uygulamanızı imzalama
Uygulamadaki tüm yapıların imzalandığından emin olun. Örneğin, temel hazırlama profili ve kimlik gibi imzalama ayarlarını belirterek bunu Xcode üzerinden yapabilirsiniz. Daha fazla bilgi için: Apple Kod İmzası
4. Adım: Uygulamanızı yükleme için paketleyin
Uygulamanız için bir IPA dosyası oluşturun (daha sonra bu dosyayı bulmanız gerekir).
Açılan açılır menüden Ürün > Arşivle'yi tıklayın. En son arşivi seçip Uygulamayı Dağıt'ı tıklayın.
Açılan pencerede Geliştirme > Sonraki'yi tıklayın.
İsteğe bağlı: Daha hızlı bir derleme elde etmek için Bit kodundan yeniden derle seçeneğinin seçimini kaldırın ve Sonraki'yi tıklayın. Test Lab, test çalıştırmak için uygulamanızı inceltmenizi veya yeniden oluşturmanızı gerektirmez. Bu nedenle, bu seçeneği güvenle devre dışı bırakabilirsiniz.
Dışa aktar'ı tıklayın ve ardından uygulamanızın IPA dosyasını indirmek istediğiniz dizini girin.
5. Adım: Uygulama imzasını doğrulayın
- .ipa dosyasının sıkıştırmasını açıp
codesign --verify --deep --verbose /path/to/MyApp.app
komutunu çalıştırarak uygulama imzasını doğrulayın. "Uygulamam", sıkıştırması açılmış klasördeki uygulamanın adıdır (her proje için değişir). Beklenen çıkışMyApp.app: valid on disk
.
6. adım: Testinizi yerel olarak çalıştırın
Testinizi Test Lab ile çalıştırmadan önce davranışını kontrol etmek için yerel olarak çalıştırabilirsiniz. Yerel olarak test etmek 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 devices
komutunu çalıştırarak simülasyon cihazınızın UDID'sini bulabilirsiniz.Yalnızca bir simülatör çalışıyorsa SIMULATOR_UDID yerine
"booted"
özel dizesini girin.
Testiniz birden fazla döngü içeriyorsa döngü numarasını scenario
işaretine 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. 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=1
xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=2
xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=5
Sonraki adımlar
Testinizi Firebase konsolunu veya gcloud KSA'yı kullanarak çalıştırın.