Oyun uygulamaları farklı özelliklerde geliştirildiğinde oyun testlerini otomatikleştirmek Kullanıcı arayüzü çerçeveleri. Oyun Döngüsü testleri yerel testlerinizi Test Lab ve seçtiğiniz cihazlarda kolayca çalıştırabilirsiniz. Bu kılavuzunda, 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 gerçek bir oyuncunun eylemlerini simüle ederek oyununuzun şu uzun süre boyunca iyi performans gösterdiğini doğrular hızlı ve ölçeklenebilir bir şekilde sunabilirsiniz. Döngü, web sitenizde yaptığınız testin tamamen ya da kısmen oyun uygulaması. Oyun Döngüsü testi bir simülatörde veya Test Lab ürününde bir grup cihazda yerel olarak çalıştırabilirsiniz. Oyun Döngüsü testleri şu amaçlarla kullanılabilir:
- Oyununuzu, bir son kullanıcının oynayacağı şekilde ilerletin. İsterseniz kullanıcıyı boşta bırakmasına izin vermeli veya kullanıcıyı yapay zeka ile değiştirmelidir (örneğin, yapay zeka uyguladıysanız) Örneğin, bir araba yarışı oyununda kullanıcının girişinden sorumlu bir yapay zeka sürücüsü belirleyebilirsiniz.
- Oyununuzu en yüksek kalite ayarında çalıştırarak hangi cihazların destekleyebileceğini öğrenin.
- Birden fazla gölgelendiriciyi derleme, yürütme ve gölgelendirmeyi kontrol etme gibi teknik bir test çalıştırın çıktısı beklendiği gibidir.
1. Adım: Test Lab özel URL şemasını kaydedin
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-loop
yazın. Özel URL şemasını projenizin listesine ekleyerek de kaydedebilirsiniz.<dict>
etiketinin herhangi bir yerindeInfo.plist
yapılandırma dosyası:<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 ile test çalıştıracak şekilde yapılandırılmış.
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 senaryolar) çalıştırmayı planlıyorsanız çalıştırmak istediğiniz döngüleri görebilirsiniz.
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ü bir olarak
parametresini uygulamayı başlatmak için kullanılan URL'ye ekleyin. Ayrıca, bu bilgileri
döngü sayısını şu şekilde ayrıştırarak:
Özel URL şemasını getirmek için kullanılan URLComponents
nesne:
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
Oyun Döngüsü testi varsayılan olarak zaman aşımına ulaşılana kadar çalışmaya devam eder
beş dakikaya kadar bir süre ayırmak zorunda kalacaksınız.
ulaşıldığında test sonlandırılır ve beklemedeki döngüler iptal edilir. Hızınızı artırın
Test Lab öğesinin özel URL şemasını çağırarak testinizi başlatın veya erken sonlandırın
Uygulamanızın AppDelegate'inde firebase-game-loop-complete
. Ö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 uygulamanıza özel test sonuçlarını yazacak şekilde
cihazın dosya sisteminden
emin olun. Bu şekilde, test çalışmaya başladığında Test Lab
sonuç dosyalarını testinizdeki bir GameLoopsResults
dizininde depolar
cihaz (kendiniz oluşturmanız gerekir). Test sona erdiğinde Test Lab, taşınır.
GameLoopResults
dizinindeki tüm dosyaları projenizin paketine aktarın. Sakla
testinizi oluştururken aşağıdakileri göz önünde bulundurun:
Tüm sonuç dosyaları; dosya türü, boyutu veya miktarına bakılmaksızın yüklenir.
Test Lab, test sayfanızdaki tüm döngüler tamamlanana kadar test sonuçlarınızı işlemez. Bir testin çalışması tamamlandığında, testinizde bunları benzersiz bir sonuç dosyasına eklediğinizden veya bir dosyası oluşturabilirsiniz. Bu şekilde, bir kaynaktan alınan sonuçların üzerine yazmaktan son döngüde olacaktır.
Testinizi özel test sonuçları yazacak şekilde ayarlamak için:
Uygulamanızın
Documents
dizinindeGameLoopResults
.Uygulamanızın kodunda herhangi bir yere (ör. uygulama temsilcinizin) takip etmek için:
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ı imzalayın
Uygulamadaki tüm yapıların imzalandığından emin olun. Örneğin, şunları yapabilirsiniz: Xcode üzerinden kontrol edebilirsiniz. Daha fazla bilgi için Apple Kod İmzalama başlıklı makaleyi inceleyin.
4. Adım: Uygulamanızı yükleme için paketleyin
Uygulamanız için bir IPA dosyası oluşturun (dosyayı daha sonra bulmanız gerekecektir).
Görüntülenen açılır menüde Ürün > Arşivleyin. En son arşivi seçin ve Uygulamayı Dağıt'ı tıklayın.
Görüntülenen pencerede Geliştirme > Sonraki.
İsteğe bağlı: Daha hızlı bir derleme oluşturmak için Bit kodundan yeniden derle seçeneğini, ardından İleri'yi tıklayın. Test Lab. uygulamanızı inceltmenizi veya yeniden oluşturmanızı gerektirmez. Böylece, bu seçeneği güvenli bir şekilde devre dışı bırakabilir.
Export'u (Dışa Aktar) tıklayın, ardından indirmek istediğiniz dizini girin. uygulamanızın IPA dosyasına gidin.
5. Adım: Uygulama imzasını doğrulayın
- Uygulama imzasını doğrulamak için .ipa dosyasını açın ve "Uygulamam" adlı
codesign --verify --deep --verbose /path/to/MyApp.app
dosyasını çalıştırın. sıkıştırılmış klasörün içindeki uygulama adıdır (her proje için değişiklik gösterir). Beklenen çıkış:MyApp.app: valid on disk
.
6. Adım: Testinizi yerel olarak çalıştırın
Testinizi yerel olarak çalıştırarak davranışını kontrol etmek için Test Lab Yerel olarak test etmek için oyun uygulamanızı bir simülasyon aracında yükleyip şu komutu çalıştırın:
xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://
Simülatörünüzün UDID'sini şu komutu çalıştırarak bulabilirsiniz:
instruments -s devices
komutudur.Yalnızca bir simülatör çalışıyorsa özel dizeyi girin SIMULATOR_UDID yerine
"booted"
.
Testiniz birden fazla döngü içeriyorsa hangi döngüyü çalıştırmak istediğinizi belirtebilirsiniz
döngü numarasını scenario
işaretine ileterek. Şunları yapabilirsiniz:
Testinizi yerel olarak çalıştırırken aynı anda yalnızca bir döngü çalıştırın. Örneğin,
döngüyü ç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
Firebase konsolunu kullanarak testinizi çalıştırma veya gcloud KSA'yı kullanın.