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

Bu sayfada, demo uygulama ve Google Play Console'u kullanarak nasıl uçtan uca test çalıştırılacağı açıklanmaktadır.

Adımlar

SDK'yı indirmek için demo uygulamasını çalıştırın, uygulamanın düzgün şekilde çalıştığını doğrulayın ve uygulamanın Google Play Console'daki kare zamanlama bilgilerini görüntüleyin. Bunun için aşağıdakileri yapın:

  1. SDK .zip dosyasını indirin ve sıkıştırılmış dosyayı açın.
  2. Demo uygulamayı derleyip çalıştırın.
  3. Monitör uygulamasını çalıştırın.
  4. Sürüm derlemesi oluşturun.
  5. Sürüm derlemesini çalıştırın.
  6. Google Play Console'da grafikleri görüntüleyebilirsiniz.

Demo uygulamayı derleme ve çalıştırma

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

Demo uygulamasını çalıştırmak için şunları yapın:

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

    Şekil 1. Test uygulaması başarıyla çalışıyor
  7. Örnek APK, hedef cihazda oluşturulmalı ve yüklenmelidir. Hatalarla karşılaşırsanız aşağıdakileri kontrol edin:

    • Android SDK'nın desteklenen bir sürümüne sahipsiniz. 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 bir giriş yok. Bu konum, Android Studio tarafından belirtilir ve yukarıdaki NDK sürümünü kullanır. Böyle bir giriş varsa tüm satırı temizleyin.
    • Derleme ayarı değişikliklerinden sonra, projeyi temizleyin (Derleme > Projeyi Temizle) ve bağlı C++ projelerini yenileyin (Derleme > Bağlı C++ Projelerini Yenile).

Monitör uygulamasını çalıştırma

Demo uygulamasının veya Tuning Fork özellikli başka bir uygulamanın hata ayıklama derlemesi sayesinde, uygulamayı Google Play sunucusu yerine yerel bir uç noktadan veri gönderip alacak şekilde yapılandırabilirsiniz. Bunu yapmak için İnce Ayarlar çatalı ayarlarında endpoint_uri_override ayarını yapın:

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

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

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

Demo uygulamada bu değişiklikler zaten var (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 görevi görür ve Tuning Fork özellikli bir uygulamanın oluşturduğu verileri gösterir.

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

  1. Tuning Fork Monitor uygulama APK'sını hedef cihaza adb kullanarak yükleyin:
    adb install gamesdk/gamesdk/apks/tools/TuningForkMonitor.apk
    
  2. İzleme uygulamasını açın.
  3. Tuning Fork Monitor uygulamasını cihazın arka planına göndermek için Android Home düğmesine basın.
  4. Demo uygulamasını tekrar ön planda yaklaşık 30 saniye boyunca çalıştırın.
  5. Tuning Fork Monitor uygulamasına geri dönün.
  6. Demo uygulama, Canlı Uygulamalar'ın altında com.tuningfork.insightsdemo 16 adıyla görünür. Uygulama ayrıntılarını ve canlı telemetriyi görmek için bu girişe dokunun.
Şekil 2. Monitör uygulaması, demo uygulamayı algılar
Şekil 3. Monitör uygulaması, demo uygulamasından alınan verileri gösterir

Sürüm derlemesi oluşturma

Android Studio'da demo uygulamanın bir sürüm derlemesini oluşturun. Android vitals'da kare zamanlama 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 uygulama için API anahtarını kısıtlamanız gerekmez.

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

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

    applicationId "com.tuningfork.your-unique-identifier"
    
  4. Projeyi temizleyin (Derleme > Projeyi Temizle) ve bağlı C++ projelerini yenileyin (Derleme > Bağlı C++ Projelerini Yenile).

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

    1. Dosya > Proje Yapısı > Modüller'i seçin.
    2. Signing Configs (Yapılandırmaları İmzalama) sekmesini seçin.
    3. release adlı yeni bir yapılandırma ekleyin.
    4. Yapılandırma için bir anahtar deposu oluşturun.
  6. Sürüm imzalama yapılandırmasını sürüm 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 (Yapılandırmayı İmzalama) kutusunda, sürüm yapılandırma değişkenini seçin.
  7. Android Studio proje penceresinde app dizinini seçin. (Bu seçim, bir sonraki adımda menü seçimini etkinleştirir.)

  8. Etkin derleme varyantını release olarak değiştirin (Derleme > Derleme Varyantını Seçin).

  9. Derleme > Derleme Paketleri/APK'lar > APK'lar oluştur'u seçin. Derleme tamamlandığında, sürüm APK'sını bulmak için bul bağlantısını tıklayın.

  10. Google Play Console'da demo uygulama için yeni bir uygulama oluşturun. Daha fazla bilgi için Uygulama yükleme bölümünü inceleyin.

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

Sürüm derlemesini çalıştırma

Hedef cihazı seçin ve Çalıştır'ı tıklayın Android Studio Çalıştır düğmesi. Google Play Console'a yüklediğiniz, sürüm APK'sının aynısını kullanmanız gerekir.

Demo uygulamasını bir süre çalıştırın. Google Play Console'un verileri görüntülemeye başlaması 30 dakikayı bulabilir. Logcat penceresinde Info 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ünü inceleyin.

... 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 {}

Google Play Console'daki grafikleri 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 testi başarıyla çalıştırdınız. Artık gerekli olmadığı için test uygulaması projesini Google Play Console'da silebilirsiniz.