Ta strona została przetłumaczona przez Cloud Translation API.

Integracja opinii w aplikacji (natywna)

Z tego przewodnika dowiesz się, jak zintegrować opinie w aplikacji z jej treścią za pomocą kodu natywnego (C lub C++). W przypadku języka Kotlin, Java lub Unity dostępne są osobne przewodniki po integracji.

Omówienie natywnego pakietu SDK

Pakiet Play Core Native SDK należy do bibliotek podstawowych Google Play. Podstawowy pakiet SDK Play zawiera plik nagłówkowy C (review.h), który pakuje ReviewManager z bibliotek Java Play In-App Review. Umożliwia on aplikacji wywoływanie interfejsu API bezpośrednio z kodu natywnego. Omówienie dostępnych funkcji publicznych znajdziesz w dokumentacji modułu natywnego Opinie w Google Play.

ReviewManager_requestReviewFlow uruchamia żądanie, które zbierze informacje wymagane do późniejszego uruchomienia procesu sprawdzania w aplikacji. Rezultat możesz śledzić za pomocą narzędzia ReviewManager_getReviewStatus. Więcej informacji o wszystkich stanach, które ReviewManager_getReviewStatus może zwracać, znajdziesz w sekcji ReviewErrorCode.

Zarówno żądania, jak i funkcje uruchamiania zwracają wartość REVIEW_NO_ERROR, jeśli ta funkcja się powiedzie.

Konfigurowanie środowiska programistycznego

下载 Play Core Native SDK

您必须先接受以下条款及条件才能下载。

条款及条件

Last modified: September 24, 2020

By using the Play Core Software Development Kit, you agree to these terms in addition to the Google APIs Terms of Service ("API ToS"). If these terms are ever in conflict, these terms will take precedence over the API ToS. Please read these terms and the API ToS carefully.
For purposes of these terms, "APIs" means Google's APIs, other developer services, and associated software, including any Redistributable Code.
“Redistributable Code” means Google-provided object code or header files that call the APIs.
Subject to these terms and the terms of the API ToS, you may copy and distribute Redistributable Code solely for inclusion as part of your API Client. Google and its licensors own all right, title and interest, including any and all intellectual property and other proprietary rights, in and to Redistributable Code. You will not modify, translate, or create derivative works of Redistributable Code.
Google may make changes to these terms at any time with notice and the opportunity to decline further use of the Play Core Software Development Kit. Google will post notice of modifications to the terms at https://developer.android.com/guide/playcore/license. Changes will not be retroactive.

我已阅读并同意上述条款及条件

下载 Play Core Native SDK

play-core-native-sdk-1.14.0.zip

Wykonaj jedną z tych czynności:
- Zainstaluj Android Studio w wersji 4.0 lub nowszej. Użyj interfejsu Menedżera pakietów SDK, aby zainstalować Android SDK Platform w wersji 10.0 (poziom API 29).
- Zainstaluj narzędzia wiersza poleceń pakietu Android SDK i użyj sdkmanager, aby zainstalować Android SDK Platform w wersji 10.0 (poziom API 29).
Przygotuj Android Studio do tworzenia aplikacji natywnych, korzystając z Menedżera SDK, aby zainstalować najnowszy pakiet NDK (CMake i Android Native Development Kit). Więcej informacji o tworzeniu i importowaniu projektów natywnych znajdziesz w artykule Wprowadzenie do pakietu NDK.

Pobierz plik ZIP i rozpakuj go wraz ze swoim projektem.

Link do pobrania	Rozmiar	Suma kontrolna SHA-256
	36 MiB	782a8522d937848c83a715c9a258b95a3ff2879a7cd71855d137b41c00786a5e

Zaktualizuj plik build.gradle aplikacji w ten sposób:

Odlotowy

    // 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.0.0'
        implementation 'com.google.android.play:asset-delivery:2.0.0'
        implementation 'com.google.android.play:integrity:1.0.1'
        implementation 'com.google.android.play:review:2.0.0'

        // 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.0.0")
    implementation("com.google.android.play:asset-delivery:2.0.0")
    implementation("com.google.android.play:integrity:1.0.1")
    implementation("com.google.android.play:review:2.0.0")

    // Import these common dependencies.
    implementation("com.google.android.gms:play-services-tasks:18.0.2")
    implementation(files("$playcoreDir/playcore-native-metadata.jar"))
    ...
}

Zaktualizuj pliki CMakeLists.txt aplikacji w ten sposób:

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
        ...)

Zbieranie danych

Podstawowy pakiet SDK w Google Play może gromadzić dane związane z wersją, aby umożliwić Google ulepszanie tej usługi. Obejmuje to:

Nazwa pakietu aplikacji
Wersja pakietu aplikacji
Wersja pakietu SDK podstawowego natywnego pakietu SDK

Te dane będą gromadzone, gdy prześlesz pakiet aplikacji do Konsoli Play. Aby zrezygnować z tego procesu gromadzenia danych, usuń import $playcoreDir/playcore-native-metadata.jar z pliku build.gradle.

Pamiętaj, że zbieranie danych związanych z korzystaniem przez Ciebie z podstawowego pakietu SDK Play oraz przez Google jest niezależne od zbioru zależności bibliotek zadeklarowanych przez Google w Gradle podczas przesyłania pakietu aplikacji do Konsoli Play.

Gdy zintegrujesz pakiet Play Core Native SDK z projektem, umieść ten wiersz w plikach zawierających wywołania interfejsu API:

Dołącz opinię.h

Po integracji podstawowego pakietu SDK Play z projektem umieść ten wiersz w plikach, które będą zawierać wywołania interfejsu API:

#include "play/review.h"

Inicjowanie interfejsu Review API

Jeśli chcesz użyć interfejsu API, musisz najpierw go zainicjować, wywołując funkcję ReviewManager_init, jak pokazano w poniższym przykładzie utworzonym za pomocą android_native_app_glue.h:

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

Poproś o proces sprawdzania w aplikacji

Postępuj zgodnie ze wskazówkami na temat tego, kiedy zgłaszać prośby o sprawdzenie aplikacji, aby określić, które z nich pozwolą Ci zachęcić użytkownika do sprawdzenia aplikacji (np. gdy zamknie ekran z podsumowaniem na końcu poziomu gry). Gdy aplikacja zbliży się do jednego z tych punktów, wywołaj metodę ReviewManager_requestReviewFlow, aby asynchronicznie zażądać informacji, których aplikacja potrzebuje do uruchomienia procesu sprawdzania w aplikacji. Monitoruj postęp operacji ReviewManager_requestReviewFlow, wywołując metodę ReviewManager_getReviewStatus, np. raz na każdą klatkę. Może to potrwać kilka sekund, dlatego należy rozpocząć ten proces, zanim aplikacja osiągnie punkt, w którym chcesz pokazać proces sprawdzania w aplikacji.

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

Obsługuj stany i uruchamiaj proces sprawdzania w aplikacji

Za każdym razem, gdy rozpoczęta zostanie prośba lub proces sprawdzania w aplikacji, możesz sprawdzić jej stan, klikając ReviewManager_getReviewStatus. Pozwala to określić logikę w zależności od stanu interfejsu API. Jednym ze sposobów, aby rozwiązać ten problem, jest zachowanie stanu jako zmiennej globalnej i sprawdzenie, czy stan wynosi REVIEW_REQUEST_FLOW_COMPLETED, gdy użytkownik wykonuje określoną czynność (np. klika przycisk „Następny poziom” w grze), jak pokazano w tym przykładzie:

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;
}

Gdy stan aplikacji to REVIEW_REQUEST_FLOW_COMPLETED, a aplikacja jest gotowa, rozpocznij proces jej sprawdzania:

// 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;
}

Po uruchomieniu procesu sprawdzania aplikacji obserwuj stan jej zakończenia i kontynuuj proces sprawdzania aplikacji. Często stosowanym sposobem jest użycie wzorca Pętla gry.

Bezpłatne zasoby

Nie zapomnij zwolnić zasobów przez wywołanie funkcji ReviewManager_destroy, gdy aplikacja przestanie korzystać z interfejsu API (np. po zakończeniu procesu sprawdzania w aplikacji).

void ReviewManager_destroy();

Dalsze kroki

Przetestuj proces sprawdzania aplikacji, aby sprawdzić, czy integracja działa prawidłowo.