Эта страница переведена с помощью Cloud Translation API.

Интегрируйте обзоры в приложении (родные)

В этом руководстве описано, как интегрировать отзывы в ваше приложение с помощью нативного кода (C или C++). Для Kotlin или Java , Unity или Unreal Engine существуют отдельные руководства по интеграции.

Обзор нативного SDK

Play Core Native SDK является частью семейства библиотек Google Play Core . Play Core Native SDK включает в себя заголовочный файл C, review.h , который является оберткой ReviewManager из библиотек Java Play In-App Review. Этот заголовочный файл позволяет вашему приложению вызывать API напрямую из вашего нативного кода. Обзор доступных общедоступных функций см. в документации по нативному модулю Play Review .

ReviewManager_requestReviewFlow запускает запрос, который собирает информацию, необходимую для последующего запуска процесса проверки в приложении. Вы можете отслеживать результат запроса с помощью ReviewManager_getReviewStatus . Для получения дополнительной информации обо всех статусах, которые может возвращать ReviewManager_getReviewStatus , см. ReviewErrorCode .

Как функция запроса, так и функция запуска возвращают REVIEW_NO_ERROR в случае успешного выполнения функции.

Настройте среду разработки.

Скачать 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.16.0.zip

Выполните одно из следующих действий:
- Установите Android Studio версии 4.0 или выше. Используйте интерфейс SDK Manager для установки Android SDK Platform версии 10.0 (уровень API 29).
- Установите инструменты командной строки Android SDK и используйте sdkmanager для установки платформы Android SDK версии 10.0 (уровень API 29).
Подготовьте Android Studio к разработке нативных приложений, используя SDK Manager для установки последних версий CMake и Android Native Development Kit (NDK). Дополнительную информацию о создании или импорте нативных проектов см. в разделе «Начало работы с NDK» .

Скачайте zip-файл и распакуйте его вместе с вашим проектом.

Ссылка для скачивания	Размер	Контрольная сумма SHA-256
	54,8 МиБ	008b8fedc6179a6dc6ccc21af75591afc7036f78f3d5559d844f1b923934fef0

Обновите файл build.gradle вашего приложения, как показано ниже:

Классный

    // 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.3.0'
        implementation 'com.google.android.play:integrity:1.6.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")
        ...
    }

Котлин

// 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.3.0")
    implementation("com.google.android.play:integrity:1.6.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"))
    ...
}

Обновите файлы CMakeLists.txt вашего приложения, как показано ниже:

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

Сбор данных

SDK Play Core Native может собирать данные, связанные с версией, чтобы позволить Google улучшить продукт, в том числе:

Название пакета приложения
Версия пакета приложения
Играйте в версию Core Native SDK

Эти данные будут собираться при загрузке пакета вашего приложения в Play Console. Чтобы отказаться от сбора этих данных, удалите импорт $playcoreDir/playcore-native-metadata.jar в файле build.gradle.

Обратите внимание, что сбор данных, связанный с использованием вами Play Core Native SDK, и использование собранных данных компанией Google осуществляется отдельно и независимо от сбора Google зависимостей библиотек, объявленных в Gradle при загрузке пакета вашего приложения в Play Console.

После интеграции Play Core Native SDK в ваш проект добавьте следующую строку в файлы, содержащие вызовы API:

Включить review.h

После интеграции Play Core Native SDK в ваш проект добавьте следующую строку в файлы, содержащие вызовы API:

#include "play/review.h"

Инициализация API для проверки отзывов.

Для использования API необходимо предварительно инициализировать его, вызвав функцию ReviewManager_init , как показано в следующем примере, созданном с помощью 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.
  }
}

Запросить процесс проверки внутри приложения

Следуйте рекомендациям о том, когда запрашивать отзывы внутри приложения, чтобы определить удачные моменты в пользовательском сценарии вашего приложения для запроса отзыва (например, после того, как пользователь закрывает экран сводки в конце уровня игры). Когда ваше приложение приблизится к одной из этих точек, вызовите ReviewManager_requestReviewFlow для асинхронного запроса информации, необходимой вашему приложению для запуска процесса отзыва внутри приложения. Отслеживайте ход выполнения операции ReviewManager_requestReviewFlow , вызывая ReviewManager_getReviewStatus , например, один раз в кадр. Это может занять до нескольких секунд, поэтому следует запускать этот процесс до того, как ваше приложение достигнет момента, когда вы хотите показать процесс отзыва внутри приложения.

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

Обрабатывайте статусы и запускайте процесс проверки в приложении.

При каждом запуске запроса или процесса проверки в приложении вы можете проверить статус с помощью ReviewManager_getReviewStatus . Это позволяет определить логику в зависимости от статуса API. Один из способов решения этой задачи — хранить статус в качестве глобальной переменной и проверять, равен ли статус REVIEW_REQUEST_FLOW_COMPLETED , когда пользователь выполняет определенное действие (например, нажимает кнопку «Следующий уровень» в игре), как показано в следующем примере:

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

Когда статус изменится на REVIEW_REQUEST_FLOW_COMPLETED и ваше приложение будет готово, запустите процесс проверки внутри приложения:

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

После запуска процесса проверки внутри приложения, продолжайте проверять статус выполнения и двигайтесь дальше по цепочке приложений. Распространенный способ решения этой задачи — использование шаблона игрового цикла .

Бесплатные ресурсы

Не забудьте освободить ресурсы, вызвав функцию ReviewManager_destroy после того, как ваше приложение завершит использование API (например, после завершения процесса проверки внутри приложения).

void ReviewManager_destroy();

Следующие шаги

Проверьте процесс написания отзывов внутри приложения, чтобы убедиться в корректной работе интеграции.

Интегрируйте обзоры в приложении (родные) Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Обзор нативного SDK

Настройте среду разработки.

Скачать Play Core Native SDK

Условия и положения

Классный

Котлин

Сбор данных

Включить review.h

Инициализация API для проверки отзывов.

Запросить процесс проверки внутри приложения

Обрабатывайте статусы и запускайте процесс проверки в приложении.

Бесплатные ресурсы

Следующие шаги

Интегрируйте обзоры в приложении (родные)