इन-ऐप्लिकेशन अपडेट का समर्थन (मूल)

इस गाइड में ऐप्लिकेशन के अंदर की सुविधा को इस्तेमाल करने का तरीका बताया गया है नेटिव कोड (C या C++). उन मामलों के लिए अलग-अलग गाइड उपलब्ध हैं, जहां आपके लागू करने के तरीके का इस्तेमाल किया जाता है Kotlin की प्रोग्रामिंग भाषा या Java प्रोग्रामिंग भाषा और ऐसे मामलों में जहां आपके लागू करने में Unity का इस्तेमाल किया जाता है.

नेटिव SDK टूल की खास जानकारी

Play Core नेटिव SDK टूल, Play Core का हिस्सा है SDK टूल फ़ैमिली. मूल निवास SDK टूल में एक C हेडर फ़ाइल, app_update.h शामिल है. यह फ़ाइल AppUpdateManager Google Play की इन-ऐप्लिकेशन अपडेट लाइब्रेरी से भी डाउनलोड किया जा सकता है. इस हेडर फ़ाइल की मदद से आपका ऐप्लिकेशन ये काम कर सकता है इन-ऐप्लिकेशन अपडेट के लिए, एपीआई को सीधे अपने नेटिव कोड से कॉल करें.

अपना डेवलपमेंट एनवायरमेंट सेट अप करें

Download Play Core Native SDK

Before downloading, you must agree to the following terms and conditions.

Terms and Conditions

Last modified: September 24, 2020
  1. 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.
  2. For purposes of these terms, "APIs" means Google's APIs, other developer services, and associated software, including any Redistributable Code.
  3. “Redistributable Code” means Google-provided object code or header files that call the APIs.
  4. 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.
  5. 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.
Download Play Core Native SDK

play-core-native-sdk-1.14.0.zip

  1. इनमें से कोई एक काम करें:

    • Android Studio का 4.0 या इसके बाद वाला वर्शन इंस्टॉल करें. SDK टूल का इस्तेमाल करना Android SDK प्लैटफ़ॉर्म के वर्शन 10.0 (एपीआई लेवल 29) को इंस्टॉल करने के लिए, मैनेजर के यूज़र इंटरफ़ेस (यूआई) की इमेज.
    • Android SDK टूल के कमांड-लाइन टूल इंस्टॉल करें और इसे इंस्टॉल करने के लिए sdkmanager का इस्तेमाल करें Android SDK प्लैटफ़ॉर्म का वर्शन 10.0 (एपीआई लेवल 29).

  2. इनका इस्तेमाल करके, अपने ऐप्लिकेशन को बेहतर बनाने के लिए Android Studio को तैयार करें नया वर्शन इंस्टॉल करने के लिए, SDK Manager CMake और Android नेटिव डेवलपमेंट किट (NDK). अगर आपको ज़्यादा जानकारी चाहिए, तो नेटिव प्रोजेक्ट बनाना या इंपोर्ट करना, तो एनडीके (NDK) के साथ शुरुआत करना.

  3. ZIP फ़ाइल डाउनलोड करें और उसे अपने प्रोजेक्ट के साथ एक्सट्रैक्ट करें.

    लिंक डाउनलोड करें साइज़ SHA-256 चेकसम
    36 एमआईबी 782a8522d937848c83a715c9a258b95a3ff2879a7cd71855d137b41c00786a5e

  4. नीचे बताए गए तरीके से अपने ऐप्लिकेशन की 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.2.2'
        implementation 'com.google.android.play:integrity:1.4.0'
        implementation 'com.google.android.play:review:2.0.1'

        // 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.1")

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

  5. अपने ऐप्लिकेशन की 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
        ...)

डेटा का संग्रह

Play Core नेटिव SDK टूल, वर्शन से जुड़ा डेटा इकट्ठा कर सकता है, ताकि Google इन कामों को कर सके बेहतर बनाने के लिए, इनमें शामिल हैं:

  • ऐप्लिकेशन के पैकेज का नाम
  • ऐप्लिकेशन का पैकेज वर्शन
  • मुख्य नेटिव SDK टूल का वर्शन चलाएं

यह डेटा, अपना ऐप्लिकेशन पैकेज अपलोड करने पर इकट्ठा किया जाएगा Play Console में जाएं. इस डेटा कलेक्शन प्रोसेस से ऑप्ट-आउट करने के लिए, बिल्ड.gradle फ़ाइल में $playcoreDir/playcore-native-metadata.jar इंपोर्ट करते हैं.

ध्यान दें, यह डेटा कलेक्शन, Play Core नेटिव SDK टूल और Google, इकट्ठा किए गए डेटा का अलग-अलग तरीके से इस्तेमाल करता है. यह Google के डेटा से अलग होता है ऐप्लिकेशन अपलोड करते समय, Gradle में बताई गई लाइब्रेरी डिपेंडेंसी का कलेक्शन पैकेज को Play Console से जोड़ना होगा.

Play Core नेटिव SDK टूल को अपने प्रोजेक्ट में इंटिग्रेट करने के बाद, एपीआई कॉल वाली फ़ाइलों की नीचे दी गई लाइन में:

#include "play/app_update.h"

इन-ऐप्लिकेशन अपडेट एपीआई शुरू करें

जब भी आप इन-ऐप अपडेट एपीआई का इस्तेमाल करें, तो पहले इसे कॉल करके AppUpdateManager_init() फ़ंक्शन का इस्तेमाल किया गया था, जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है android_native_app_glue.h:

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

  AppUpdateErrorCode error_code =
    AppUpdateManager_init(app->activity->vm, app->activity->clazz);
  if (error_code == APP_UPDATE_NO_ERROR) {
    // You can use the API.
  }
}

देखें कि अपडेट उपलब्ध है या नहीं

अपडेट का अनुरोध करने से पहले, देख लें कि आपके ऐप्लिकेशन के लिए कोई अपडेट उपलब्ध है या नहीं है. AppUpdateManager_requestInfo() एक एसिंक्रोनस अनुरोध शुरू करता है, जो लॉन्च करने के लिए ज़रूरी जानकारी इकट्ठा करता है इन-ऐप्लिकेशन अपडेट फ़्लो को बाद में अपडेट कर सकें. फ़ंक्शन APP_UPDATE_NO_ERROR दिखाता है, अगर अनुरोध सफलतापूर्वक शुरू हो जाता है.

AppUpdateErrorCode error_code = AppUpdateManager_requestInfo()

if (error_code == APP_UPDATE_NO_ERROR) {
    // The request has successfully started, check the result using
    // AppUpdateManager_getInfo.
}

मौजूदा प्रोसेस और अनुरोध के नतीजे को ट्रैक करने के लिए: AppUpdateManager_getInfo(). गड़बड़ी कोड के अलावा, यह फ़ंक्शन एक गड़बड़ी वाला मैसेज दिखाता है AppUpdateInfo ओपेक स्ट्रक्चर, जिसका इस्तेमाल अपडेट के बारे में जानकारी फिर से पाने के लिए किया जा सकता है अनुरोध. उदाहरण के लिए, हो सकता है कि आप इस फ़ंक्शन को हर गेम लूप में कॉल करना चाहें जब तक यह info के लिए अशून्य परिणाम नहीं देता:

AppUpdateInfo* info;
GameUpdate() {

   // Keep calling this in every game loop until info != nullptr
   AppUpdateErrorCode error_code = AppUpdateManager_getInfo(&info);


   if (error_code == APP_UPDATE_NO_ERROR && info != nullptr) {
       // Successfully started, check the result in the following functions
   }
...
}

अपडेट की पुरानी जानकारी देखें

यह देखने के अलावा कि कोई अपडेट उपलब्ध है या नहीं, शायद आपको देखें कि उपयोगकर्ता को आखिरी बार अपडेट की सूचना मिलने के बाद कितना समय हुआ है Play Store से. इससे आपको यह फ़ैसला लेने में मदद मिलेगी कि आपको फ़्लेक्सिबल अपडेट या तुरंत एक अपडेट. उदाहरण के लिए, आपको कुछ दिन इंतज़ार करना पड़ सकता है को अपडेट करने के बारे में सूचना दी थी. तुरंत अपडेट करने की ज़रूरत नहीं होती.

इस्तेमाल की जाने वाली चीज़ें AppUpdateInfo_getClientVersionStalenessDays() Play पर अपडेट उपलब्ध होने के बाद से दिनों की संख्या देखने के लिए स्टोर:

int32_t staleness_days = AppUpdateInfo_getClientVersionStalenessDays(info);

अपडेट की प्राथमिकता देखें

Google Play Developer API की मदद से, हर अपडेट की प्राथमिकता सेट की जा सकती है. इससे आपके ऐप्लिकेशन को यह तय करने में मदद मिलती है कि उपयोगकर्ता को अपडेट का सुझाव किस तरह देना है. उदाहरण के लिए, अपडेट की प्राथमिकता सेट करने के लिए, यह रणनीति देखें:

  • यूज़र इंटरफ़ेस (यूआई) में छोटे-मोटे सुधार: कम प्राथमिकता वाला अपडेट; अनुरोध के मुताबिक, महीने के हिसाब से और न ही तुरंत अपडेट होता है. सिर्फ़ तब अपडेट करें, जब उपयोगकर्ता इंटरैक्ट न कर रहा हो को कैसे ट्रैक करें.
  • परफ़ॉर्मेंस में सुधार: सामान्य प्राथमिकता वाला अपडेट; महीने के हिसाब से पेमेंट के विकल्प का अनुरोध करें अपडेट.
  • सुरक्षा से जुड़ा गंभीर अपडेट: ज़्यादा प्राथमिकता वाला अपडेट; तुरंत अनुरोध करें अपडेट.

प्राथमिकता तय करने के लिए Google Play, 0 से 5 के बीच की कोई वैल्यू इस्तेमाल करता है. वैल्यू के तौर पर 0 की वैल्यू दी जाती है 'डिफ़ॉल्ट' और 5 का मतलब सबसे ज़्यादा प्राथमिकता है. किसी अपडेट करें, इसके तहत inAppUpdatePriority फ़ील्ड का इस्तेमाल करें Edits.tracks.releases में अपडेट किया गया है. रिलीज़ में जोड़े गए सभी नए वर्शन को रिलीज़ की समान प्राथमिकता माना जाता है. प्राथमिकता सिर्फ़ तब सेट की जा सकती है, जब नई रिलीज़ को रोल आउट करना है और बाद में इसे बदला नहीं जा सकता.

Play में बताए गए तरीके से, Google Play Developer API का इस्तेमाल करके प्राथमिकता सेट करें डेवलपर एपीआई दस्तावेज़ में दिया गया है. इन-ऐप्लिकेशन अपडेट की प्राथमिकता यहां दी गई: Edit.tracks संसाधन को इसमें पास किया गया Edit.tracks: update तरीका. इस उदाहरण में, वर्शन कोड के साथ ऐप्लिकेशन रिलीज़ करने के बारे में बताया गया है 88 और inAppUpdatePriority 5:

{
  "releases": [{
      "versionCodes": ["88"],
      "inAppUpdatePriority": 5,
      "status": "completed"
  }]
}

अपने ऐप्लिकेशन के कोड में, दिए गए अपडेट का प्राथमिकता लेवल देखा जा सकता है. इसके लिए, AppUpdateInfo_getPriority():

int32_t priority = AppUpdateInfo_getPriority(info);

अपडेट शुरू करें

अपडेट उपलब्ध होने की पुष्टि करने के बाद, अपडेट का अनुरोध करने के लिए: AppUpdateManager_requestStartUpdate(). अपडेट का अनुरोध करने से पहले, एक अप-टू-डेट AppUpdateInfo ऑब्जेक्ट पाएं और एक बनाएं AppUpdateOptions ऑब्जेक्ट का इस्तेमाल करके, अपडेट फ़्लो को कॉन्फ़िगर करें. AppUpdateOptions ऑब्जेक्ट तय करता है इन-ऐप्लिकेशन अपडेट फ़्लो के लिए उपलब्ध विकल्प. इनमें यह जानकारी भी शामिल होती है कि अपडेट को सुविधाजनक या तुरंत.

यहां दिए गए उदाहरण में, ज़रूरत के हिसाब से अपडेट करने के लिए AppUpdateOptions ऑब्जेक्ट बनाया गया है फ़्लो:

// Creates an AppUpdateOptions configuring a flexible in-app update flow.
AppUpdateOptions* options;
AppUpdateErrorCode error_code = AppUpdateOptions_createOptions(APP_UPDATE_TYPE_FLEXIBLE, &options);

नीचे दिए गए उदाहरण में, किसी वैल्यू को तुरंत सेट करने के लिए AppUpdateOptions ऑब्जेक्ट बनाया गया है अपडेट का फ़्लो:

// Creates an AppUpdateOptions configuring an immediate in-app update flow.
AppUpdateOptions* options;
AppUpdateErrorCode error_code = AppUpdateOptions_createOptions(APP_UPDATE_TYPE_IMMEDIATE, &options);

AppUpdateOptions ऑब्जेक्ट में एक AllowAssetPackDeletion फ़ील्ड भी है जो तय करता है कि अपडेट की मदद से ऐसेट को पैक मिलेंगे. यह डिफ़ॉल्ट रूप से फ़ील्ड false पर सेट होता है, लेकिन आप AppUpdateOptions_setAssetPackDeletionAllowed() इसके बजाय इसे true पर सेट करें:

bool allow = true;
AppUpdateErrorCode error_code = AppUpdateOptions_setAssetPackDeletionAllowed(options, allow);

जब आपके पास अप-टू-डेट AppUpdateInfo ऑब्जेक्ट और सही तरीके से कॉन्फ़िगर किया गया हो AppUpdateOptions ऑब्जेक्ट, इस पर AppUpdateManager_requestStartUpdate() को कॉल करें Android गतिविधि jobject में पास होते हुए, एसिंक्रोनस रूप से अपडेट फ़्लो का अनुरोध करें फ़ाइनल पैरामीटर के लिए.

AppUpdateErrorCode request_error_code =
AppUpdateManager_requestStartUpdate(info, options, app->activity->clazz);

संसाधनों को खाली करने के लिए, AppUpdateInfo के इंस्टेंस और AppUpdateOptions जिसे अब आपको कॉल करने की ज़रूरत नहीं है AppUpdateInfo_destroy() और AppUpdateOptions_destroy(), क्रम से.

AppUpdateInfo_destroy(info);
AppUpdateOptions_destroy(options);

तुरंत अपडेट करने के लिए, Google Play उपयोगकर्ता की पुष्टि करने वाला पेज दिखाता है. जब उपयोगकर्ता अनुरोध स्वीकार कर लेता है, तब Google Play अपने-आप अपडेट को फ़ोरग्राउंड में इंस्टॉल करता है. इसके बाद, अपडेट किए गए ऐप्लिकेशन पर ऐप्लिकेशन को रीस्टार्ट करता है इंस्टॉलेशन सफल होने पर,

ज़रूरत के हिसाब से अपडेट करने के लिए, AppUpdateInfo को अप-टू-डेट रखने का अनुरोध किया जा सकता है ऑब्जेक्ट के ज़रिए अपडेट की मौजूदा स्थिति को ट्रैक किया जा सकता है. ऐसा तब तक किया जाता है, जब तक उपयोगकर्ता ऐप के साथ सहभागिता करें. डाउनलोड पूरा हो जाने के बाद, आपको ये काम ज़रूर करने होंगे अपडेट को पूरा करने के लिए, कॉल करें AppUpdateManager_requestCompleteUpdate(), जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है:

AppUpdateStatus status = AppUpdateInfo_getStatus(info);
if (status == APP_UPDATE_DOWNLOADED) {
    AppUpdateErrorCode error_code = AppUpdateManager_requestCompleteUpdate();
    if (error_code != APP_UPDATE_NO_ERROR)
    {
      // There was an error while completing the update flow.
    }
}

संसाधनों को खाली करने के लिए, AppUpdateManager_destroy() काम करने की ज़रूरत नहीं पड़ेगी.

गड़बड़ी ठीक करना

इस सेक्शन में, आम तौर पर होने वाली गड़बड़ियों के समाधान के बारे में बताया गया है. AppUpdateErrorCode मान:

  • -110, APP_UPDATE_INITIALIZATION_NEEDED का गड़बड़ी कोड बताता है कि एपीआई को शुरू नहीं किया गया है. AppUpdateManager_init() को इस नंबर पर कॉल करें एपीआई को शुरू करते हैं.
  • -4, APP_UPDATE_INVALID_REQUEST का गड़बड़ी कोड बताता है कि कुछ अपडेट फ़्लो के अनुरोध के पैरामीटर गलत हैं. यह पक्का करने के लिए जांच करें कि AppUpdateInfo और AppUpdateOptions ऑब्जेक्ट खाली नहीं हैं और सही तरीके से फ़ॉर्मैट किया गया हो.
  • -5, APP_UPDATE_UNAVAILABLE का गड़बड़ी कोड बताता है कि लागू होने वाला अपडेट उपलब्ध है. पक्का करें कि टारगेट वर्शन और टारगेट वर्शन एक जैसे हों पैकेज का नाम, ऐप्लिकेशन आईडी, और हस्ताक्षर कुंजी. अगर कोई अपडेट उपलब्ध है, तो ऐप्लिकेशन की कैश मेमोरी मिटाएं और AppUpdateManager_requestAppUpdateInfo() को दोबारा कॉल करें AppUpdateInfo रीफ़्रेश करें.
  • -6, APP_UPDATE_NOT_ALLOWED का गड़बड़ी कोड बताता है कि अपडेट टाइप AppUpdateOption ऑब्जेक्ट से मिली अनुमति की अनुमति नहीं है. जांच लें कि AppUpdateInfo ऑब्जेक्ट बताता है कि इस टाइप के अपडेट को पहले अनुमति दी गई है अपडेट करना शुरू कर रहे हैं.

अगले चरण

अपने ऐप्लिकेशन के इन-ऐप्लिकेशन अपडेट की जांच करना पुष्टि करें कि आपका इंटिग्रेशन सही तरीके से काम कर रहा है.