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

Bu sayfada, bir demo uygulama ve Google Play Console'u kullanarak uçtan uca testin nasıl ç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 Google Play Console'da uygulamanın kare zamanlaması bilgilerini görüntüleyin:

1. SDK .zip dosyasını indirin ve sıkıştırılmış dosyayı açın.
2. Demo uygulamayı derleyip ç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. Google Play Console'da grafikleri görüntüleyebilirsiniz.

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

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 aşağıdakileri 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'yi seçin.
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 . Daha fazla bilgi için Uygulamanızı oluşturma ve çalıştırma başlıklı makaleyi inceleyin.

   

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 sürümünü SDK Yöneticisi'ndeki SDK Platformları sekmesinden 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. Bu girişe sahipseniz 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).

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

Demo uygulamasının veya başka bir Tuning Fork özellikli uygulamanın hata ayıklama derlemesini kullanarak uygulamayı, Google Play sunucusu yerine yerel bir uç noktadan veri gönderip alacak şekilde yapılandırabilirsiniz. Bunu yapmak için Tuning Fork ayarlarında endpoint_uri_override'yi ayarlayın:

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

AndroidManifest.xml dosyasına aşağıdaki izinleri de dahil etmeniz gerekir:

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

Bu değişiklikler demo uygulamada 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 ürettiği verileri gösterir.

İzleme uygulamasını ve demo uygulamasını aynı anda çalıştırarak demo uygulamanın düzgün çalıştığını doğrulamak için aşağıdakileri yapın:

1. Tuning Fork Monitor uygulaması APK'sını adb kullanarak hedef cihaza 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 uygulamayı ön planda tekrar yaklaşık 30 saniye çalıştırın.
5. Tuning Fork Monitor uygulamasına geri dönün.
6. Demo uygulama, 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.

Sürüm derlemesi oluşturma

Android Studio'da demo uygulamanın 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ımdaki API anahtarınızı gamesdk/samples/tuningfork/insightsdemo/app/src/main/assets/tuningfork/tuningfork_settings.txt bölümündeki 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 (Derleme > Bağlı C++ Projelerini Yenile) yenileyin.

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ı > Varyant Oluştur'u seçin.
   2. Derleme Türleri sekmesini seçin.
   3. release adlı derleme türünü seçin.
   4. İmzalama Yapılandırması 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ı Seçin).

9. Derleme > Derleme Paketi/APK'sı > APK'lar oluştur'u seçin. Derleme tamamlandığında, yayınlanan APK'yı 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 edinmek 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 . Google Play Console'a yüklediğiniz APK'nın aynısını kullanmanız gerekir.

Demo uygulamayı 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ü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 {}

Google Play Console'da 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'dan silebilirsiniz.