Tính năng mới tại Google I/O 2025: Sử dụng tính năng ghi nhớ thiết bị (thử nghiệm) để phát hiện và ngăn chặn hành vi sai trái tái diễn cũng như các hành động khác mà bạn chỉ định, đồng thời vẫn đảm bảo quyền riêng tư của người dùng.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Hướng dẫn này cho bạn biết cách thiết lập dự án Android gốc để sử dụng API Tính toàn vẹn của Play từ C hoặc C++. Trước khi có thể gọi API, trước tiên, bạn phải tích hợp SDK gốc của Play Core bằng cách định cấu hình môi trường phát triển và cập nhật các tệp build.gradle và CMakeLists.txt như minh hoạ trong phần sau. Để biết thêm thông tin chi tiết, hãy xem Tài liệu tham khảo về API gốc.
Tải xuống Play Core Native SDK
Trước khi tải xuống, bạn phải đồng ý với các điều khoản và điều kiện sau.
Ðiều khoản và điều kiện
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.
Cài đặt Android Studio phiên bản 4.0 trở lên. Sử dụng giao diện người dùng Trình quản lý SDK để cài đặt Nền tảng SDK Android phiên bản 10.0 (API cấp 29).
Chuẩn bị Android Studio cho việc phát triển bằng mã gốc bằng cách dùng Trình quản lý SDK để cài đặt CMake và Bộ phát triển mã gốc Android (NDK) mới nhất. Để biết thêm thông tin về việc tạo hoặc nhập các dự án gốc, xem Bắt đầu với NDK.
Cập nhật tệp build.gradle của ứng dụng như minh hoạ dưới đây:
Groovy
// App build.gradleplugins{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.defplaycoreDir=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.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'implementationfiles("$playcoreDir/playcore-native-metadata.jar")...}
Kotlin
// App build.gradleplugins{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.valplaycoreDir=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.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"))...}
Cập nhật các tệp CMakeLists.txt của ứng dụng như bên dưới:
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
...)
Thu thập dữ liệu
SDK gốc của Play Core có thể thu thập một số dữ liệu liên quan đến phiên bản để cho phép Google cải thiện sản phẩm, trong đó có:
Tên gói của ứng dụng
Phiên bản gói của ứng dụng
Phiên bản SDK gốc của Play Core
Dữ liệu này sẽ được thu thập khi bạn tải gói ứng dụng lên Play Console. Để chọn không tham gia quá trình thu thập dữ liệu này, hãy xoá việc nhập $playcoreDir/playcore-native-metadata.jar trong tệp build.gradle.
Hãy lưu ý rằng quá trình thu thập dữ liệu này liên quan đến việc bạn sử dụng SDK gốc Play Core và việc Google sử dụng dữ liệu đã thu thập là hoạt động riêng biệt và độc lập với việc thu thập các phần phụ thuộc của thư viện được khai báo trong Gradle khi bạn tải gói ứng dụng lên Play Console.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-08-21 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-21 UTC."],[],[],null,["# Native setup\n\nThis guide shows you how to set up your native Android project to use the Play\nIntegrity API from C or C++. Before you can make calls to the API, you must\nfirst integrate the Play Core Native SDK by configuring your development\nenvironment and updating your `build.gradle` and `CMakeLists.txt` files as shown\nin the following section. For more details see our [Native API Reference](/reference/native/play/core/group/integrity).\n\n\nDownload Play Core Native SDK\n-----------------------------\n\nBefore downloading, you must agree to the following terms and conditions. \n\nTerms and Conditions\n--------------------\n\nLast modified: September 24, 2020\n\n1. By using the Play Core Software Development Kit, you agree to these terms in addition to the [Google APIs Terms of Service](https://developers.google.com/terms) (\"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.\n2. For purposes of these terms, \"APIs\" means Google's APIs, other developer services, and associated software, including any Redistributable Code.\n3. \"Redistributable Code\" means Google-provided object code or header files that call the APIs.\n4. 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.\n5. 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 \u003chttps://developer.android.com/guide/playcore/license\u003e. Changes will not be retroactive. \nI have read and agree with the above terms and conditions \nDownload Play Core Native SDK [Download Play Core Native SDK](https://dl.google.com/games/play/core/play-core-native-sdk-1.15.4.zip)\n\n*play-core-native-sdk-1.15.4.zip*\n\n1. Do either of the following:\n\n - Install [Android Studio](/studio) version 4.0 or higher. Use the SDK Manager UI to install Android SDK Platform version 10.0 (API level 29).\n - Install the [Android SDK command-line tools](/studio#command-tools) and use [`sdkmanager`](/studio/command-line/sdkmanager) to install Android SDK Platform version 10.0 (API level 29).\n2. Prepare Android Studio for native development by using the\n [SDK Manager](/studio/intro/update#sdk-manager) to install the latest\n CMake and Android Native Development Kit (NDK). For more information on\n creating or importing native projects, see\n [Getting Started with the NDK](/ndk/guides).\n\n3. Download the zip file and extract it alongside your project.\n\n | Download Link | Size | SHA-256 Checksum |\n |---------------------------------|----------|------------------------------------------------------------------|\n | play-core-native-sdk-1.15.4.zip | 39.6 MiB | 92b43246860d4ce4772a3a0786212d9b4781920e112d81b93ca1c5ebd8da89cb |\n\n4. Update your app's `build.gradle` file as shown below:\n\n ### Groovy\n\n ```groovy\n // App build.gradle\n\n plugins {\n id 'com.android.application'\n }\n\n // Define a path to the extracted Play Core SDK files.\n // If using a relative path, wrap it with file() since CMake requires absolute paths.\n def playcoreDir = file('\u003cvar translate=\"no\"\u003e../path/to/playcore-native-sdk\u003c/var\u003e')\n\n android {\n defaultConfig {\n ...\n externalNativeBuild {\n cmake {\n // Define the PLAYCORE_LOCATION directive.\n arguments \"-DANDROID_STL=c++_static\",\n \"-DPLAYCORE_LOCATION=$playcoreDir\"\n }\n }\n ndk {\n // Skip deprecated ABIs. Only required when using NDK 16 or earlier.\n abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'\n }\n }\n buildTypes {\n release {\n // Include Play Core Library proguard config files to strip unused code while retaining the Java symbols needed for JNI.\n proguardFile '$playcoreDir/proguard/common.pgcfg'\n proguardFile '$playcoreDir/proguard/gms_task.pgcfg'\n proguardFile '$playcoreDir/proguard/\u003cvar translate=\"no\"\u003eper-feature-proguard-files\u003c/var\u003e'\n ...\n }\n debug {\n ...\n }\n }\n externalNativeBuild {\n cmake {\n path 'src/main/CMakeLists.txt'\n }\n }\n }\n\n dependencies {\n // Import these feature-specific AARs for each Google Play Core library.\n implementation 'com.google.android.play:app-update:2.1.0'\n implementation 'com.google.android.play:asset-delivery:2.3.0'\n implementation 'com.google.android.play:integrity:1.4.0'\n implementation 'com.google.android.play:review:2.0.2'\n\n // Import these common dependencies.\n implementation 'com.google.android.gms:play-services-tasks:18.0.2'\n implementation files(\"$playcoreDir/playcore-native-metadata.jar\")\n ...\n }\n \n ```\n\n ### Kotlin\n\n ```kotlin\n // App build.gradle\n\n plugins {\n id(\"com.android.application\")\n }\n\n // Define a path to the extracted Play Core SDK files.\n // If using a relative path, wrap it with file() since CMake requires absolute paths.\n val playcoreDir = file(\"\u003cvar translate=\"no\"\u003e../path/to/playcore-native-sdk\u003c/var\u003e\")\n\n android {\n defaultConfig {\n ...\n externalNativeBuild {\n cmake {\n // Define the PLAYCORE_LOCATION directive.\n arguments += listOf(\"-DANDROID_STL=c++_static\", \"-DPLAYCORE_LOCATION=$playcoreDir\")\n }\n }\n ndk {\n // Skip deprecated ABIs. Only required when using NDK 16 or earlier.\n abiFilters.clear()\n abiFilters += listOf(\"armeabi-v7a\", \"arm64-v8a\", \"x86\", \"x86_64\")\n }\n }\n buildTypes {\n release {\n // Include Play Core Library proguard config files to strip unused code while retaining the Java symbols needed for JNI.\n proguardFile(\"$playcoreDir/proguard/common.pgcfg\")\n proguardFile(\"$playcoreDir/proguard/gms_task.pgcfg\")\n proguardFile(\"$playcoreDir/proguard/\u003cvar translate=\"no\"\u003eper-feature-proguard-files\u003c/var\u003e\")\n ...\n }\n debug {\n ...\n }\n }\n externalNativeBuild {\n cmake {\n path = \"src/main/CMakeLists.txt\"\n }\n }\n }\n\n dependencies {\n // Import these feature-specific AARs for each Google Play Core library.\n implementation(\"com.google.android.play:app-update:2.1.0\")\n implementation(\"com.google.android.play:asset-delivery:2.3.0\")\n implementation(\"com.google.android.play:integrity:1.4.0\")\n implementation(\"com.google.android.play:review:2.0.2\")\n\n // Import these common dependencies.\n implementation(\"com.google.android.gms:play-services-tasks:18.0.2\")\n implementation(files(\"$playcoreDir/playcore-native-metadata.jar\"))\n ...\n }\n ```\n5. Update your app's `CMakeLists.txt` files as shown below:\n\n ```\n cmake_minimum_required(VERSION 3.6)\n\n ...\n\n # Add a static library called “playcore” built with the c++_static STL.\n include(${PLAYCORE_LOCATION}/playcore.cmake)\n add_playcore_static_library()\n\n // In this example “main” is your native code library, i.e. libmain.so.\n add_library(main SHARED\n ...)\n\n target_include_directories(main PRIVATE\n ${PLAYCORE_LOCATION}/include\n ...)\n\n target_link_libraries(main\n android\n playcore\n ...)\n ```\n\nData Collection\n---------------\n\nThe Play Core Native SDK may collect version related data to allow Google to\nimprove the product, including:\n\n- App's package name\n- App's package version\n- Play Core Native SDK's version\n\nThis data will be collected when you upload [your app package](/studio/publish/upload-bundle)\nto the Play Console. To opt-out of this data collection process, remove the\n`$playcoreDir/playcore-native-metadata.jar` import in the build.gradle file.\n\nNote, this data collection related to your use of the Play Core Native SDK and\nGoogle's use of the collected data is separate and independent of Google's\ncollection of library dependencies declared in Gradle when you upload your app\npackage to the Play Console."]]
