Uygulama içi yorumları entegre edin (Yerel)

Bu kılavuzda, yerel (C veya C++) kod kullanarak uygulama içi yorumları uygulamanıza nasıl entegre edebileceğiniz açıklanmaktadır. Kotlin veya Java ya da Unity kullanıyorsanız ayrı entegrasyon kılavuzları vardır.

Yerel SDK'ya genel bakış

Play Core Yerel SDK'sı, Google Play Core kitaplıkları ailesinin bir parçasıdır. Play Core Yerel SDK'sı, Java Play Uygulama İçi İnceleme kitaplıklarındaki ReviewManager dosyasını sarmalayan bir C başlık dosyası (review.h) içerir. Bu başlık dosyası, uygulamanızın API'yi doğrudan yerel kodunuzdan çağırmasına olanak tanır. Kullanılabilen herkese açık işlevlere genel bakış için Play İncelemesi yerel modülü dokümanları başlıklı makaleyi inceleyin.

ReviewManager_requestReviewFlow, daha sonra uygulama içi inceleme akışını başlatmak için gereken bilgileri toplayan bir istek başlatır. ReviewManager_getReviewStatus simgesini kullanarak isteğin sonucunu takip edebilirsiniz. ReviewManager_getReviewStatus işlevinin döndürebileceği tüm durumlar hakkında daha fazla bilgi için ReviewErrorCode bölümüne bakın.

Hem istek hem de başlatma işlevi başarılı olursa REVIEW_NO_ERROR döndürür.

Geliştirme ortamınızı kurma

1. Aşağıdakilerden birini yapın:

   • Android Studio 4.0 veya sonraki bir sürümü yükleyin. Android SDK Platform 10.0 sürümünü (API düzeyi 29) yüklemek için SDK Yöneticisi kullanıcı arayüzünü kullanın.
   • Android SDK komut satırı araçlarını yükleyin ve Android SDK Platform 10.0 sürümünü (API düzeyi 29) yüklemek için sdkmanager kullanın.

2. En son CMake ve Android Native Development Kit'i (NDK) yüklemek için SDK Yöneticisi'ni kullanarak Android Studio'yu yerel geliştirmeye hazırlayın. Yerel projeler oluşturma veya içe aktarma hakkında daha fazla bilgi için NDK'yi kullanmaya başlama başlıklı makaleyi inceleyin.

3. ZIP dosyasını indirip projenizle birlikte ayıklayın.

   İndirme Bağlantısı	Boyut	SHA-256 sağlama
   play-core-native-sdk-1.15.3.zip	37,8 MiB	9db60185185342f28d2c278b60222333608c67bc022e458a25224eaea8c4c4b7

4. Uygulamanızın build.gradle dosyasını aşağıdaki gibi güncelleyin:

   Groovy

       // App build.gradle
   
       plugins {
         id 'com.android.application'
       }
   
       // Define a path to the extracted Play Core SDK files.
       // If using a relative path, wrap it with file() since CMake requires absolute paths.
       def playcoreDir = file('../path/to/playcore-native-sdk')
   
       android {
           defaultConfig {
               ...
               externalNativeBuild {
                   cmake {
                       // Define the PLAYCORE_LOCATION directive.
                       arguments "-DANDROID_STL=c++_static",
                                 "-DPLAYCORE_LOCATION=$playcoreDir"
                   }
               }
               ndk {
                   // Skip deprecated ABIs. Only required when using NDK 16 or earlier.
                   abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
               }
           }
           buildTypes {
               release {
                   // Include Play Core Library proguard config files to strip unused code while retaining the Java symbols needed for JNI.
                   proguardFile '$playcoreDir/proguard/common.pgcfg'
                   proguardFile '$playcoreDir/proguard/gms_task.pgcfg'
                   proguardFile '$playcoreDir/proguard/per-feature-proguard-files'
                   ...
               }
               debug {
                   ...
               }
           }
           externalNativeBuild {
               cmake {
                   path 'src/main/CMakeLists.txt'
               }
           }
       }
   
       dependencies {
           // Import these feature-specific AARs for each Google Play Core library.
           implementation 'com.google.android.play:app-update:2.1.0'
           implementation 'com.google.android.play:asset-delivery:2.2.2'
           implementation 'com.google.android.play:integrity:1.4.0'
           implementation 'com.google.android.play:review:2.0.2'
   
           // Import these common dependencies.
           implementation 'com.google.android.gms:play-services-tasks:18.0.2'
           implementation files("$playcoreDir/playcore-native-metadata.jar")
           ...
       }
       

   Kotlin

   // App build.gradle
   
   plugins {
       id("com.android.application")
   }
   
   // Define a path to the extracted Play Core SDK files.
   // If using a relative path, wrap it with file() since CMake requires absolute paths.
   val playcoreDir = file("../path/to/playcore-native-sdk")
   
   android {
       defaultConfig {
           ...
           externalNativeBuild {
               cmake {
                   // Define the PLAYCORE_LOCATION directive.
                   arguments += listOf("-DANDROID_STL=c++_static", "-DPLAYCORE_LOCATION=$playcoreDir")
               }
           }
           ndk {
               // Skip deprecated ABIs. Only required when using NDK 16 or earlier.
               abiFilters.clear()
               abiFilters += listOf("armeabi-v7a", "arm64-v8a", "x86", "x86_64")
           }
       }
       buildTypes {
           release {
               // Include Play Core Library proguard config files to strip unused code while retaining the Java symbols needed for JNI.
               proguardFile("$playcoreDir/proguard/common.pgcfg")
               proguardFile("$playcoreDir/proguard/gms_task.pgcfg")
               proguardFile("$playcoreDir/proguard/per-feature-proguard-files")
               ...
           }
           debug {
               ...
           }
       }
       externalNativeBuild {
           cmake {
               path = "src/main/CMakeLists.txt"
           }
       }
   }
   
   dependencies {
       // Import these feature-specific AARs for each Google Play Core library.
       implementation("com.google.android.play:app-update:2.1.0")
       implementation("com.google.android.play:asset-delivery:2.2.2")
       implementation("com.google.android.play:integrity:1.4.0")
       implementation("com.google.android.play:review:2.0.2")
   
       // Import these common dependencies.
       implementation("com.google.android.gms:play-services-tasks:18.0.2")
       implementation(files("$playcoreDir/playcore-native-metadata.jar"))
       ...
   }

5. Uygulamanızın CMakeLists.txt dosyalarını aşağıdaki gibi güncelleyin:

   cmake_minimum_required(VERSION 3.6)
   
   ...
   
   # Add a static library called “playcore” built with the c++_static STL.
   include(${PLAYCORE_LOCATION}/playcore.cmake)
   add_playcore_static_library()
   
   // In this example “main” is your native code library, i.e. libmain.so.
   add_library(main SHARED
           ...)
   
   target_include_directories(main PRIVATE
           ${PLAYCORE_LOCATION}/include
           ...)
   
   target_link_libraries(main
           android
           playcore
           ...)
   

Veri Toplama

Play Core Yerel SDK'sı, Google'ın ürünü iyileştirmesine olanak tanımak için sürümle ilgili veriler toplayabilir. Buna aşağıdakiler dahildir:

• Uygulamanın paket adı
• Uygulamanın paket sürümü
• Play Core Yerel SDK'sının sürümü

Bu veriler, uygulama paketinizi Play Console'a yüklediğinizde toplanır. Bu veri toplama sürecini devre dışı bırakmak için build.gradle dosyasından $playcoreDir/playcore-native-metadata.jar içe aktarma işlemini kaldırın.

Play Core Native SDK'yı kullanımınızla ilgili bu veri toplama işleminin ve Google'ın toplanan verileri kullanımının, uygulama paketinizi Play Console'a yüklediğinizde Gradle'de beyan edilen kitaplık bağımlılıklarının Google tarafından toplanmasından ayrı ve bağımsız olduğunu unutmayın.

Play Core Yerel SDK'sını projenize entegre ettikten sonra API çağrıları içeren dosyalara aşağıdaki satırı ekleyin:

review.h dosyasını ekleyin.

Play Core Yerel SDK'sını projenize entegre ettikten sonra, API çağrıları içerecek dosyalara aşağıdaki satırı ekleyin:

#include "play/review.h"

Review API'yi başlatma

API'yi kullanmak istediğinizde, android_native_app_glue.h ile oluşturulan aşağıdaki örnekte gösterildiği gibi, önce ReviewManager_init işlevini çağırarak API'yi başlatmanız gerekir:

void android_main(android_app* app) {
  app->onInputEvent = HandleInputEvent;

  ReviewErrorCode error_code = ReviewManager_init(app->activity->vm, app->activity->clazz);
  if (error_code == REVIEW_NO_ERROR) {
    // You can use the API.
  }
}

Uygulama içi inceleme akışını isteme

Kullanıcıdan yorum isteğinde bulunmak için uygulamanızın kullanıcı akışında uygun noktaları belirlemek üzere ne zaman uygulama içi yorum isteğinde bulunacağınız ile ilgili talimatları uygulayın (örneğin, kullanıcı bir oyundaki seviyenin sonunda özet ekranını kapattıktan sonra). Uygulamanız bu noktalardan birine yaklaştığında, uygulamanızın uygulama içi inceleme akışı başlatmak için ihtiyaç duyduğu bilgileri eşzamansız olarak istemek üzere ReviewManager_requestReviewFlow işlevini çağırın. Örneğin, her karede bir kez ReviewManager_getReviewStatus çağrısı yaparak ReviewManager_requestReviewFlow işleminin ilerleme durumunu izleyin. Bu işlem birkaç saniye sürebileceğinden, uygulamanız uygulama içi inceleme akışını göstermek istediğiniz noktaya ulaşmadan önce bu işlemi başlatmanız gerekir.

ReviewErrorCode error_code = ReviewManager_requestReviewFlow();
if (error_code == REVIEW_NO_ERROR) {
    // The request has successfully started, check the status using
    // ReviewManager_getReviewStatus.
} else {
    // Error such as REVIEW_PLAY_STORE_NOT_FOUND indicating that the in-app
    // review isn't currently possible.
}

Durumları yönetme ve uygulama içi inceleme akışını başlatma

Bir istek başlatıldığında veya uygulama içi inceleme akışı başlatıldığında ReviewManager_getReviewStatus simgesini kullanarak durumu kontrol edebilirsiniz. Bu sayede mantığı API durumuna göre tanımlayabilirsiniz. Bu konuya yaklaşmanın bir yolu, durumu genel bir değişken olarak tutmak ve kullanıcı belirli bir işlem yaptığında (ör. bir oyunda "Sonraki Seviye" düğmesine dokunma) durumun REVIEW_REQUEST_FLOW_COMPLETED olup olmadığını kontrol etmektir. Aşağıdaki örnekte bu yaklaşım gösterilmektedir:

ReviewStatus status;
ReviewErrorCode error_code = ReviewManager_getReviewStatus(&status);
if (error_code != REVIEW_NO_ERROR) {
    // There was an error with the most recent operation.
    return;
}

switch (status) {
    case REVIEW_REQUEST_FLOW_PENDING:
        // Request is ongoing. The flow can't be launched yet.
        break;
    case REVIEW_REQUEST_FLOW_COMPLETED:
        // Request completed. The flow can be launched now.
        break;
    case REVIEW_LAUNCH_FLOW_PENDING:
        // The review flow is ongoing, meaning the dialog might be displayed.
        break;
    case REVIEW_LAUNCH_FLOW_COMPLETED:
        // The review flow has finished. Continue with your app flow (for
        // example, move to the next screen).
        break;
    default:
        // Unknown status.
        break;
}

Durum REVIEW_REQUEST_FLOW_COMPLETED olduğunda ve uygulamanız hazır olduğunda uygulama içi inceleme akışını başlatın:

// This call uses android_native_app_glue.h.
ReviewErrorCode error_code = ReviewManager_launchReviewFlow(app->activity->clazz);
if (error_code != REVIEW_NO_ERROR) {
    // There was an error while launching the flow.
    return;
}

Uygulama içi inceleme akışını başlattıktan sonra tamamlanma durumunu kontrol etmeye devam edin ve uygulama akışınıza devam edin. Bunu yapmanın yaygın bir yolu, oyun döngüsü kalıbını takip etmektir.

Ücretsiz kaynaklar

Uygulamanız API'yi kullanmayı bitirdikten sonra (örneğin, uygulama içi inceleme akışı tamamlandıktan sonra) ReviewManager_destroy işlevini çağırarak kaynakları serbest bırakmayı unutmayın.

void ReviewManager_destroy();

Sonraki adımlar

Entegrasyonunuzun doğru çalıştığını doğrulamak için uygulamanızın uygulama içi inceleme akışını test edin.