अपग्रेड पार्टी एक खोज प्रवाह है जो एंड्रॉइड उपयोगकर्ताओं के लिए नई सुविधाओं को उजागर करता है जब भी उन्हें कोई प्रमुख ओएस अपग्रेड प्राप्त होता है।
एक प्रमुख एंड्रॉइड ऑपरेटिंग सिस्टम अपग्रेड आपके उपयोगकर्ताओं के लिए एक निराशाजनक अनुभव हो सकता है। अपग्रेड पार्टी प्रवाह उपयोगकर्ता जुड़ाव बढ़ाता है और उपयोगकर्ताओं को यह समझने में मदद करता है कि अपने नए ताज़ा ओएस को कैसे नेविगेट किया जाए।
नवीनतम ओएस संस्करण में अपग्रेड करने के बाद, उपयोगकर्ताओं को नए ओएस में उनका स्वागत करने और नई सुविधाओं के साथ कार्ड प्रवाह प्रदर्शित करने के लिए एक पुश अधिसूचना प्राप्त होती है।
अपने एंड्रॉइड ओएस के लिए अपग्रेड पार्टी को सक्षम करने के लिए, एंड्रॉइड अपग्रेड पार्टी फॉर्म को सक्रिय करने के लिए अनुरोध का उपयोग करके पंजीकरण करें।
अपग्रेड पार्टी अनुभव को अनुकूलित करें
आप अपग्रेड पार्टी अनुभव को निम्नलिखित तरीकों से अनुकूलित कर सकते हैं:
- अप्रासंगिक विशेषताएँ हटाएँ.
- टेक्स्ट ब्लॉक में भाषा अपडेट करें.
- अपने ब्रांड से मेल खाने के लिए एनिमेशन, रंग और फ़ॉन्ट को संशोधित करें।
प्रवाह को अनुकूलित करने के लिए, अपग्रेड पार्टी स्टाइल गाइड में दिशानिर्देशों की समीक्षा करें और एंड्रॉइड अपग्रेड पार्टी फॉर्म को सक्रिय करने के अनुरोध में अपनी अनुकूलन जानकारी शामिल करें।
आमंत्रण स्टाइल गाइड को अपग्रेड करें
अपने ब्रांड (स्क्रीन, रंग, फ़ॉन्ट) के अनुरूप अपग्रेड आमंत्रण लुक को संशोधित करने के लिए इस स्टाइल गाइड का उपयोग करें। हम आकार और संरचना को मूल डिज़ाइन के करीब रखने की अत्यधिक अनुशंसा करते हैं।
अपग्रेड आमंत्रण प्रवाह में निम्नलिखित तीन घटक शामिल हैं:
- परिचय स्क्रीन
- फ़ीचर स्क्रीन
- आउटरो स्क्रीन
प्रत्येक स्क्रीन पर एक एनीमेशन प्रत्येक सुविधा को समझाने में मदद करता है।
परिचय स्क्रीन
इंट्रो स्क्रीन में एक छोटा एनीमेशन होता है जो उपयोगकर्ता का स्वागत करता है और उन्हें इंट्रो स्क्रीन पर दिखाए गए प्रवाह को शुरू करने के लिए प्रोत्साहित करता है।
लेआउट
डिवाइस एनीमेशन में हमेशा निम्न शामिल होते हैं:
- सफ़ेद पृष्ठभूमि और रंगीन आकृतियाँ
- डिवाइस फ़्रेम
- यूआई सामग्री
स्टाइल
यदि आप मटेरियल यू स्टाइल को अनुकूलित करना चुनते हैं, तो आप उदाहरण में दिखाए गए डिफ़ॉल्ट रंगों और आकृतियों का उपयोग कर सकते हैं।
यदि आप अपने स्वयं के ब्रांड रंग का उपयोग करते हैं, तो सुनिश्चित करें कि यह यूआई पृष्ठभूमि के साथ अच्छी तरह से काम करता है।
गति
विकल्प 1: होम स्क्रीन पर एक घड़ी के साथ
- नंबर स्क्रीन में प्रवेश करते हैं.
- संख्याएँ आकार में घटती हुई केंद्र की ओर बढ़ती हैं। मोबाइल फ़ोन फ़्रेम प्रकट होता है.
- फ़ोन का आकार छोटा हो जाता है. आकृतियाँ स्क्रीन में प्रवेश करने लगती हैं।
- एनीमेशन पूरा हो गया है. आकृतियाँ धीरे-धीरे चलती रहती हैं।
विकल्प 2: होम स्क्रीन पर कोई घड़ी नहीं
- मोबाइल फ़ोन स्क्रीन में प्रवेश करता है.
- आकार में वृद्धि करते हुए फोन केंद्र की ओर चला जाता है। आकृतियाँ स्क्रीन में प्रवेश करने लगती हैं।
- फ़ोन अधिकतम आकार तक पहुँच जाता है और आकृतियाँ बदलती रहती हैं।
फ़ीचर स्क्रीन
प्रत्येक फीचर स्क्रीन नए ओएस में एक फीचर को हाइलाइट करती है।
लेआउट
डिवाइस एनीमेशन में हमेशा निम्न शामिल होते हैं:
- रंगीन पृष्ठभूमि
- डिवाइस फ़्रेम
- यूआई सामग्री
स्टाइल
- ऐसा पृष्ठभूमि रंग चुनें जो यूआई सामग्री और सामान्य स्वरूप के साथ अच्छा काम करता हो।
- स्क्रीन के अंदर, ऐसे फ़ॉन्ट आकार सेट करें जो आसानी से सुपाठ्य हों। यदि आवश्यक हो, तो बड़े फ़ॉन्ट आकार सेट करें।
गति
स्पर्श इंटरैक्शन सहित प्रत्येक सुविधा के प्रवाह का एनीमेशन रिकॉर्ड करें। रिकॉर्डिंग को लोटी फ़ाइलों के रूप में निर्यात करें।
आउटरो स्क्रीन
आउट्रो स्क्रीन प्रवाह को पूरा करती है। यह उपयोगकर्ताओं को इंगित करता है कि वे सभी स्क्रीन देख चुके हैं।
लेआउट
डिवाइस एनीमेशन में हमेशा निम्न शामिल होते हैं:
- पृष्ठभूमि पर आधा वृत्त (साथ ही एनिमेटेड आकृतियाँ)
- डिवाइस फ़्रेम
- यूआई सामग्री
स्टाइल
- ऐसा पृष्ठभूमि रंग चुनें जो यूआई सामग्री और सामान्य स्वरूप के साथ अच्छा काम करता हो।
- अर्धवृत्ताकार आकृति का प्रयोग करें।
गति
मानक आउट्रो स्क्रीन एनीमेशन प्रवाह का पालन करें:
- मोबाइल फ़ोन थोड़ा ऊपर चला जाता है.
- पृष्ठभूमि में एक वृत्त दिखाई देता है.
- मोबाइल फोन के पीछे से आकृतियाँ निकलती हैं।
- आकृतियाँ कंफ़ेद्दी की तरह पृष्ठभूमि से बाहर उड़ती हैं।
एसडीके के साथ अपग्रेड पार्टी को ट्रिगर करें
डिफ़ॉल्ट रूप से, एंड्रॉइड ओएस अपग्रेड होते ही उपयोगकर्ताओं को नवीनतम सुविधाओं के साथ कार्ड प्रवाह दिखाने वाला एक पुश नोटिफिकेशन भेजता है। यदि आप अपने स्वयं के पुश नोटिफिकेशन या ऐप से प्रवाह को ट्रिगर करना पसंद करते हैं, तो एंड्रॉइड एसडीके का उपयोग करें।
आवश्यक शर्तें
सुनिश्चित करें कि आपके ऐप की बिल्ड फ़ाइल निम्नलिखित मानों का उपयोग करती है:
- 14 या उच्चतर का
minSdkVersion
- 28 या उच्चतर का
compileSdkVersion
अपना ऐप कॉन्फ़िगर करें
- दी गई ज़िप फ़ाइल से लाइब्रेरी निकालें, और इसे अपने रिपॉजिटरी में रखें।
Google ग्रोथ SDK के लिए निर्भरताएँ अपने मॉड्यूल की ऐप-स्तरीय ग्रैडल फ़ाइल में जोड़ें, सामान्यतः
app/build.gradle
:dependencies { implementation files('<PATH_TO_BINARY>/play-services-growth-16.1.0-eap04.aar') }
निम्नलिखित पुस्तकालयों को निर्भरता के रूप में शामिल करें:
com.google.android.gms:play-services-base:18.0.1 com.google.android.gms:play-services-basement:18.0.0 com.google.android.gms:play-services-tasks:18.0.1
एपीआई का प्रयोग करें
क्लाइंट को प्रारंभ करने के लिए,
UpgradeParty
क्लास का उपयोग करें औरactivity
पैरामीटर सेट करें।import com.google.android.gms.growth.UpgradeParty; UpgradeParty.getClient(activity);
परिणामी UpgradePartyClient
एपीआई कार्यक्षमता को उजागर करता है।
अपग्रेडपार्टी के लिए पात्र है
Task<Boolean> isEligibleForUpgradeParty();
एक Task
ऑब्जेक्ट लौटाता है जो एसिंक्रोनस रूप से सत्यापित करता है कि उपयोगकर्ता अपग्रेड पार्टी के लिए योग्य है या नहीं। परिणामी बूलियन मान इंगित करता है कि उपयोगकर्ता पात्र है या नहीं।
अपग्रेडपार्टी का आह्वान करें
Task<Void> invokeUpgradeParty();
एक अपग्रेड पार्टी Activity
आह्वान करता है। परिणामी Task
ऑब्जेक्ट इंगित करता है कि गतिविधि शुरू करते समय कोई त्रुटि हुई या नहीं।
त्रुटियाँ
com.google.android.gms.common.api.ApiException
प्रकार के अपवाद के साथ दोनों API विधियाँ विफल हो सकती हैं। ऐसे मामलों में, कॉल करने वाले से बाद में पुनः प्रयास करने की अपेक्षा की जाती है।
अपेक्षित सामान्य स्थिति कोड में शामिल हैं:
-
INTERNAL_ERROR
: अंतर्निहित तर्क के प्रवाह में किसी भी त्रुटि का प्रतिनिधित्व करता है। -
TIMEOUT
: तब दिखाया जाता है जब अनुरोध को समय पर ढंग से प्रबंधित नहीं किया जा सका। -
API_NOT_CONNECTED
: इसका मतलब है कि एपीआई उपलब्ध नहीं है (उदाहरण के लिए,UpgradeParty
मॉड्यूल अभी तक तैयार नहीं है)। -
DEVELOPER_ERROR
: तब दिखाया जाता है जब कॉलिंग पैकेज कोUpgradeParty
क्लास तक पहुंचने की अनुमति नहीं होती है।
एसडीके उदाहरण
एसडीके को आमंत्रित करने वाले ऐप का निम्नलिखित उदाहरण देखें:
import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import com.google.android.gms.growth.UpgradeParty;
import com.google.android.gms.growth.UpgradePartyClient;
public class SampleActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
final UpgradePartyClient client = UpgradeParty.getClient(this);
// Hide the invocation button initially
View startUpgradePartyButton = findViewById(R.id.__some_button__);
startUpgradePartyButton.setVisibility(View.GONE);
// Register an onClick handler to invoke the Upgrade Party Activity
startUpgradePartyButton
.setOnClickListener(
view -> {
client
.invokeUpgradeParty()
.addOnCompleteListener(
task -> {
if (!task.isSuccessful()) {
// Do something with error, see task.getException()
}
});
});
}
// Check if eligible for an Upgrade Party
client
.isEligibleForUpgradeParty()
.addOnCompleteListener(
task -> {
if (!task.isSuccessful()) {
// Do something with error, see task.getException()
} else {
// Show/Hide invocation button, based on the result
int visibility =
task.getResult() ? View.VISIBLE : View.GONE;
startUpgradePartyButton..setVisibility(visibility);
}
});
}
अपग्रेड पार्टी प्रवाह का परीक्षण करें
अपग्रेड पार्टी प्रवाह का परीक्षण करने के लिए इन चरणों का पालन करें जो आपके उपयोगकर्ता एंड्रॉइड ओएस को अपग्रेड करते समय देखते हैं:
- परीक्षण एंड्रॉइड डिवाइस पर, सेटिंग्स > Google > अपग्रेड पार्टी डिबग पर जाएं।
- रिपोर्ट अपग्रेड चुनें और फिर अपग्रेड पार्टी खोलें । यह डिवाइस ओएस संस्करण के आधार पर प्रासंगिक प्रवाह शुरू करता है। उदाहरण के लिए, एंड्रॉइड 12 अपग्रेड पार्टी एंड्रॉइड 12 ओएस चलाने वाले डिवाइस पर चलती है।