Demo uygulamayı çalıştırın

Bu sayfada, bir demo uygulaması ve Google Play Console'u kullanarak nasıl uçtan uca test yapacağınız açıklanmaktadır.

Adımlar

SDK'yı indirmek, demo uygulamasını çalıştırmak, uygulamanın doğru çalıştığını doğrulamak ve Google Play Console'da uygulamadan kare zamanlaması bilgilerini görüntülemek için aşağıdakileri yapın:

  1. Android Açık Kaynak Projesi Games SDK deposunun ana dalını klonlayın.
  2. Demo uygulamasını oluşturup çalıştırın.
  3. İzleme uygulamasını çalıştırın.
  4. Sürüm derlemesi oluşturun.
  5. Sürüm derlemesini çalıştırın.
  6. Grafikleri Google Play Console'da görüntüleyin.

Demo uygulamasını oluşturup çalıştırma

Her şeyin doğru şekilde oluşturulduğundan emin olmak için Android Studio'da APT Insights Demo uygulamasını çalıştırın. Bu proje, yerel kod oluşturma için CMake'i kullanır ve gamesdk.cmake dosyasının nasıl kullanılacağını gösterir. Bu dosya, başlamanın en kolay yoludur.

Demo uygulamasını çalıştırmak için aşağıdakileri yapın:

  1. Android Studio'yu açın.
  2. Dosya > Aç'ı tıklayın ve gamesdk/samples/tuningfork/insightsdemo/build.gradle seçeneğini belirleyin.
  3. Android Studio'nun projeyi senkronize etmesini bekleyin.
  4. Örneği çalıştırmak için bir cihaz bağlayın (veya sanal cihaz oluşturun). Cihazda geliştirici seçeneklerini ve USB üzerinden hata ayıklamayı etkinleştirin.
  5. Hedef cihazı seçin ve ÇalıştırAndroid Studio'daki Çalıştır düğmesi tıklayın. Daha fazla bilgi için Uygulamanızı oluşturma ve çalıştırma başlıklı makaleyi inceleyin.

    1.şekil Test uygulaması başarıyla çalıştırıldı
  6. Örnek APK, hedef cihazda oluşturulup yüklenmelidir. Hatalarla karşılaşırsanız aşağıdakileri kontrol edin:

    • Android SDK'nın desteklenen bir sürümüne sahip olmanız gerekir. Daha fazla bilgi için uygulama modülü build.gradle dosyasındaki compileSdkVersion alanına bakın. SDK Yöneticisi'ndeki SDK Platformları sekmesinden SDK sürümünü güncelleyebilirsiniz.
    • Android NDK'nın desteklenen bir sürümüne sahipsiniz. Daha fazla bilgi için uygulama modülü build.gradle dosyasındaki ndkVersion alanına bakın. SDK Yöneticisi'ndeki SDK Araçları sekmesinden NDK'nın belirli bir sürümünü yükleyebilirsiniz.
    • Projedeki local.properties dosyasında ndk.dir için giriş yoktur. Bu konum, Android Studio tarafından belirtilir ve yukarıdaki NDK sürümünü kullanır. Bu giriş varsa satırın tamamını temizleyin.
    • Derleme ayarlarında değişiklik yaptıktan sonra projeyi temizleyin (Build > Clean Project) ve bağlı C++ projelerini yenileyin (Build > Refresh Linked C++ Projects).

İzleme uygulamasını çalıştırma

Demo uygulamasının veya Tuning Fork'un etkinleştirildiği başka bir uygulamanın hata ayıklama sürümüyle, uygulamayı Google Play sunucusu yerine yerel bir uç noktadan veri gönderecek ve alacak şekilde yapılandırabilirsiniz. Bunu yapmak için Tuning Fork ayarlarında endpoint_uri_override değerini ayarlayın:

#ifndef NDEBUG
   settings.endpoint_uri_override = "http://localhost:9000";
#endif

Ayrıca, AndroidManifest.xml dosyasına aşağıdaki izinleri de eklemeniz gerekir:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Demo uygulamasında bu değişiklikler zaten yapılmış durumda (bkz. insightsdemo.cpp).

Bu özelliği, bir uygulamanın doğru verileri gönderip aldığını doğrulamak için kullanabilirsiniz. Bunu doğrulamak için demo uygulamasını ve Tuning Fork Monitor uygulamasını aynı anda çalıştırın. Bu izleme uygulaması, yerel bir sunucu gibi davranır ve Tuning Fork'un etkinleştirildiği bir uygulamanın ürettiği verileri gösterir.

Demo uygulamasının düzgün çalıştığını doğrulamak için izleme uygulamasını ve demo uygulamasını aynı anda çalıştırmak üzere aşağıdakileri yapın:

  1. adb'yi kullanarak Tuning Fork Monitor uygulaması APK'sını hedef cihaza yükleyin:
    adb install gamesdk/gamesdk/apks/tools/TuningForkMonitor.apk
    
  2. İzleme uygulamasını açın.
  3. Android ana sayfa düğmesine basarak Tuning Fork Monitor uygulamasını cihazda arka plana gönderin.
  4. Demo uygulamasını yaklaşık 30 saniye boyunca ön planda tekrar çalıştırın.
  5. Tuning Fork Monitor uygulamasına geri dönün.
  6. Demo uygulaması, Live Applications (Canlı Uygulamalar) bölümünde com.tuningfork.insightsdemo 16 olarak görünür. Uygulama ayrıntılarını ve canlı telemetriyi görmek için bu girişe dokunun.
Şekil 2. İzleme uygulaması, demo uygulamasını algılar.
3.şekil İzleme uygulaması, demo uygulamasındaki verileri gösterir.

Sürüm derlemesi oluşturma

Android Studio'da demo uygulamasının yayın sürümünü oluşturun. Android vitals'da kare zamanlaması grafiklerini etkinleştirmek için bu derlemeyi Google Play Console'a yüklersiniz.

  1. Google Cloud Console'da Android Performance Parameters API'yi etkinleştirin. Bu API, uygulamanın Google Play ile iletişim kurmasını sağlar. Demo uygulaması için API anahtarını kısıtlamanız gerekmez.

  2. Önceki adımdaki API anahtarınızı api_key alanına kopyaladığınızdan emin olun.gamesdk/samples/tuningfork/insightsdemo/app/src/main/assets/tuningfork/tuningfork_settings.txt

  3. Demo uygulamasının uygulama kimliği ayrılmış olduğundan bu kimliği kullanan bir APK yükleyemezsiniz. Bu kimliği uygulamanın build.gradle dosyasında değiştirin:

    applicationId "com.tuningfork.your-unique-identifier"
    
  4. Projeyi temizleyin (Build > Clean Project) ve bağlı C++ projelerini yenileyin (Build > Refresh Linked C++ Projects).

  5. Sürüm derlemeleri için imzalama yapılandırması oluşturun.

    1. Dosya > Proje Yapısı > Modüller'i seçin.
    2. İmzalama Yapılandırmaları sekmesini seçin.
    3. release adlı yeni bir yapılandırma ekleyin.
    4. Yapılandırma için anahtar deposu oluşturun.
  6. Yayın imzalama yapılandırmasını yayın derleme varyantıyla ilişkilendirin.

    1. Dosya > Proje Yapısı > Derleme Varyantları'nı seçin.
    2. Derleme Türleri sekmesini seçin.
    3. release adlı derleme türünü seçin.
    4. Signing Config (İmzalama Yapılandırması) kutusunda yayın yapılandırması değişkenini seçin.
  7. Android Studio proje penceresinde app dizinini seçin. (Bu seçim, sonraki adımda menü seçimini etkinleştirir.)

  8. Etkin derleme varyantını release olarak değiştirin (Build > Select Build Variant).

  9. Build > Build Bundles(s)/APK(s) > Build APK(s)'i (Derleme > Paketleri/APK'ları Derle > APK'ları Derle) seçin. Derleme tamamlandığında yayın APK'sını bulmak için bul bağlantısını tıklayın.

  10. Google Play Console'da demo uygulaması için yeni bir uygulama oluşturun. Daha fazla bilgi için Uygulama yükleme başlıklı makaleyi inceleyin.

  11. Sürüm APK'sını Dahili test kanalına yükleyin. Daha fazla bilgi için Sürüm hazırlama ve kullanıma sunma başlıklı makaleyi inceleyin.

Yayınlanan derlemeyi çalıştırın

Hedef cihazı seçin ve ÇalıştırAndroid Studio&#39;daki Çalıştır düğmesi tıklayın. Google Play Console'a yüklediğiniz APK'yı kullanmanız gerekir.

Demo uygulamasının bir süre çalışmasına izin verin. Google Play Console'un verileri göstermeye başlaması 30 dakikayı bulabilir. Logcat penceresinde Bilgi günlük düzeyini seçerek verilerin sunucuya yüklendiğini doğrulayın. Günlükte hatalar görürseniz Sık karşılaşılan hataları giderme bölümüne bakın.

... I/TuningFork:Web: Connecting to:
    https://performanceparameters.googleapis.com/v1/applications/com.tuningfork.yourapp/apks/24:uploadTelemetry
... I/TuningFork: Scene loading 30 (true) took 166 ms
... I/TuningFork:Web: Response code: 200
... I/TuningFork:Web: Response message: OK
... I/TuningFork.GE: UPLOAD request returned 200 {}

Grafikleri Google Play Console'da görüntüleme

Google Play Console'u açıp test uygulamasını seçin. Kare süresi grafiğini görmek için Android Vitals > Performans > Analizler'i seçin.

Şekil 4. Android vitals grafiği

Tuning Fork kitaplığıyla uçtan uca bir testi başarıyla çalıştırdınız. Artık gerekmediği için Google Play Console'da test uygulaması projesini silebilirsiniz.