Android के लिए ऐप्लिकेशन फ़्लिप

अपने Android ऐप्लिकेशन में ऐप्लिकेशन की सेटिंग बदलना

ऐप्लिकेशन की सेटिंग बदलने के लिए, आपको अपने ऐप्लिकेशन में उपयोगकर्ता के ऑथराइज़ेशन कोड में बदलाव करना होगा. ऐसा करने पर ही, Google के डीप लिंक को स्वीकार किया जा सकेगा.

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

इस दस्तावेज़ में, आप अपने Android ऐप्लिकेशन में बदलाव करने का तरीका जानते हैं.

सैंपल आज़माएं

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

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

यह रिपोर्ट कैसे दिखेगी

ऐप्लिकेशन फ़्लिप इंटिग्रेशन के लिए यह तरीका अपनाएं:

1. Google app यह जांच करता है कि आपका ऐप्लिकेशन, डिवाइस में पैकेज का नाम इस्तेमाल करके इंस्टॉल किया गया है या नहीं.
2. Google app, पैकेज साइन की जांच का इस्तेमाल करके, इस बात की पुष्टि करता है कि इंस्टॉल किया गया ऐप्लिकेशन सही है या नहीं.
3. Google app पर, आपके ऐप्लिकेशन में कोई खास गतिविधि शुरू करने के लिए इंटेंट बनाया जाता है. इस इंटेंट में जोड़ने के लिए ज़रूरी अतिरिक्त डेटा शामिल है. यह Android फ़्रेमवर्क के ज़रिए इस इंटेंट का समाधान करके, यह यह देखने के लिए भी जांच करता है कि आपका ऐप्लिकेशन ऐप्लिकेशन फ़्लिप का समर्थन करता है या नहीं.
4. आपका ऐप्लिकेशन इस बात की पुष्टि करता है कि अनुरोध Google app से किया गया है. इसके लिए, आपका ऐप्लिकेशन, पैकेज के हस्ताक्षर और दिए गए क्लाइंट आईडी की जांच करता है.
5. आपका ऐप्लिकेशन आपके OAuth 2.0 सर्वर से अनुमति देने के लिए कोड का अनुरोध करता है. इस फ़्लो के आखिर में, यह ऑथराइज़ेशन कोड या Google app में गड़बड़ी दिखाता है.
6. नतीजे के तौर पर दिखने वाला Google app, खाता लिंक करने की प्रोसेस जारी रखता है. अगर ऑथराइज़ेशन कोड दिया जाता है, तो टोकन एक्सचेंज सर्वर-टू-सर्वर के जैसा ही होता है. यह ठीक वैसा ही होता है जैसा ब्राउज़र पर आधारित OAuth लिंकिंग फ़्लो में होता है.

ऐप्लिकेशन फ़्लिप की सुविधा के लिए, अपने Android ऐप्लिकेशन में बदलाव करें

ऐप्लिकेशन फ़्लिप की सुविधा इस्तेमाल करने के लिए, अपने Android ऐप्लिकेशन में कोड में ये बदलाव करें:

1. अपनी AndroidManifest.xml फ़ाइल में <intent-filter> को एक कार्रवाई स्ट्रिंग के साथ जोड़ें, जो ऐप्लिकेशन फ़्लिप इंटेंट फ़ील्ड में आपकी डाली गई वैल्यू से मेल खाता हो.

   <activity android:name="AuthActivity">
     <!-- Handle the app flip intent -->
     <intent-filter>
       <action android:name="INTENT_ACTION_FROM_CONSOLE"/>
       <category android:name="android.intent.category.DEFAULT"/>
     </intent-filter>
   </activity>
   

2. कॉल करने वाले ऐप्लिकेशन के हस्ताक्षर की पुष्टि करें.

   private fun verifyFingerprint(
           expectedPackage: String,
           expectedFingerprint: String,
           algorithm: String
   ): Boolean {
   
       callingActivity?.packageName?.let {
           if (expectedPackage == it) {
               val packageInfo =
                   packageManager.getPackageInfo(it, PackageManager.GET_SIGNATURES)
               val signatures = packageInfo.signatures
               val input = ByteArrayInputStream(signatures[0].toByteArray())
   
               val certificateFactory = CertificateFactory.getInstance("X509")
               val certificate =
                   certificateFactory.generateCertificate(input) as X509Certificate
               val md = MessageDigest.getInstance(algorithm)
               val publicKey = md.digest(certificate.encoded)
               val fingerprint = publicKey.joinToString(":") { "%02X".format(it) }
   
               return (expectedFingerprint == fingerprint)
           }
       }
       return false
   }
   

3. इंटेंट पैरामीटर से क्लाइंट आईडी निकालें और पुष्टि करें कि क्लाइंट आईडी अनुमानित मान से मेल खाता है.

   private const val EXPECTED_CLIENT = "<client-id-from-actions-console>"
   private const val EXPECTED_PACKAGE = "<google-app-package-name>"
   private const val EXPECTED_FINGERPRINT = "<google-app-signature>"
   private const val ALGORITHM = "SHA-256"
   ...
   
   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
   
       val clientId = intent.getStringExtra("CLIENT_ID")
   
       if (clientId == EXPECTED_CLIENT &&
           verifyFingerprint(EXPECTED_PACKAGE, EXPECTED_FINGERPRINT, ALGORITHM)) {
   
           // ...authorize the user...
       }
   }
   

4. अनुमति देने के बाद, वह कोड वापस Google को दे दें.

   // Successful result
   val data = Intent().apply {
       putExtra("AUTHORIZATION_CODE", authCode)
   }
   setResult(Activity.RESULT_OK, data)
   finish()
   

5. अगर कोई गड़बड़ी हुई है, तो उसके बजाय गड़बड़ी का नतीजा दिखाएं.

   // Error result
   val error = Intent().apply {
       putExtra("ERROR_TYPE", 1)
       putExtra("ERROR_CODE", 1)
       putExtra("ERROR_DESCRIPTION", "Invalid Request")
   }
   setResult(-2, error)
   finish()
   

लॉन्च इंटेंट का कॉन्टेंट

आपका ऐप्लिकेशन लॉन्च करने वाले Android इंटेंट में ये फ़ील्ड शामिल हैं:

• CLIENT_ID (String): Google client_id आपके ऐप्लिकेशन के साथ रजिस्टर किया गया.
• SCOPE (String[]): दायरों की एक सूची का अनुरोध किया गया.
• REDIRECT_URI (String): रीडायरेक्ट यूआरएल.

रिस्पॉन्स डेटा का कॉन्टेंट

Google app पर सेव किए गए डेटा को आपके ऐप्लिकेशन में सेट किया जाता है. इसके लिए, setResult() को कॉल किया जाता है. इस डेटा में ये चीज़ें शामिल हैं:

• AUTHORIZATION_CODE (String): ऑथराइज़ेशन कोड की वैल्यू.
• resultCode (int): इस प्रोसेस की सफलता या असफलता की जानकारी देता है और इनमें से कोई एक वैल्यू लेता है:
  • Activity.RESULT_OK: इससे पता चलता है कि पुष्टि हो चुकी है और पुष्टि करने के लिए कोड भेजा गया है.
  • Activity.RESULT_CANCELLED: सिग्नल से यह पता चलता है कि उपयोगकर्ता ने प्रोसेस रद्द कर दी है. इस मामले में, Google app आपके अनुमति वाले यूआरएल का इस्तेमाल करके, खाता जोड़ने की कोशिश करेगा.
  • -2: यह बताता है कि कोई गड़बड़ी हुई है. अलग-अलग तरह की गड़बड़ियों के बारे में नीचे बताया गया है.
• ERROR_TYPE (int): गड़बड़ी किस तरह की है, इनमें से कोई एक वैल्यू होती है:
  • 1: वापस पाने में होने वाली गड़बड़ी: Google app, अनुमति देने वाले यूआरएल का इस्तेमाल करके, खाता जोड़ने की कोशिश करेगा.
  • 2: वापस न पाई जा सकने वाली गड़बड़ी: Google app को खाता जोड़ने की प्रोसेस रद्द कर दी गई है.
  • 3: अनुरोध पैरामीटर अमान्य हैं या मौजूद नहीं हैं.
• ERROR_CODE (int): एक पूर्णांक, जो गड़बड़ी की तरह बताता है. हर गड़बड़ी कोड का क्या मतलब होता है, यह देखने के लिए गड़बड़ी कोड की टेबल देखें.

• ERROR_DESCRIPTION (String, ज़रूरी नहीं): गड़बड़ी की जानकारी देने वाला ऐसा मैसेज जो इंसान पढ़ सके.

resultCode == Activity.RESULT_OK के लिए, AUTHORIZATION_CODE की वैल्यू ज़रूरी है. अन्य सभी मामलों में, AUTHORIZATION_CODE का मान खाली होना चाहिए. अगर resultCode == -2 है, तो ERROR_TYPE वैल्यू के पॉप्युलेट होने की संभावना होती है.

गड़बड़ी कोड की टेबल

नीचे दी गई टेबल में अलग-अलग गड़बड़ी कोड दिखाए गए हैं. इनमें से हर कोड, वापस पाने लायक या वापस न पाया जा सकने वाला गड़बड़ी का कोड है:

सभी गड़बड़ी कोड के लिए, आपको setResult के ज़रिए गड़बड़ी का नतीजा दिखाना होगा, ताकि यह पक्का हो सके कि सही फ़ॉलबैक ट्रिगर हो.

अपने डिवाइस पर, ऐप्लिकेशन की सेटिंग बदलें

आपने कंसोल पर ऐप्लिकेशन फ़्लिप को कॉन्फ़िगर कर लिया है और अपने ऐप्लिकेशन में कॉन्फ़िगर कर लिया है. इसलिए, अब आप अपने मोबाइल डिवाइस पर ऐप्लिकेशन की सेटिंग बदल सकते हैं. App Flip की जांच करने के लिए, Google Assistant या Google Home ऐप्लिकेशन का इस्तेमाल किया जा सकता है.

Assistant ऐप्लिकेशन से ऐप्लिकेशन की सेटिंग बदलने के लिए, यह तरीका अपनाएं:

1. Actions कंसोल पर जाएँ और अपना प्रोजेक्ट चुनें.
2. सबसे ऊपर मौजूद नेविगेशन में, जांच करें पर क्लिक करें.
3. Assistant ऐप्लिकेशन से, खाता जोड़ने का फ़्लो ट्रिगर करें:
1. Google Assistant ऐप्लिकेशन खोलें.
2. सेटिंग पर क्लिक करें.
3. Assistant टैब पर, होम कंट्रोल पर क्लिक करें.
4. जोड़ें(+) पर क्लिक करें.
5. सेवा देने वाली कंपनियों की सूची में से, अपनी कार्रवाई चुनें. इसे सूची में "[test]" से शुरू किया जाएगा. सूची से अपनी [test] कार्रवाई चुनने पर, आपका ऐप्लिकेशन खुल जाएगा.
6. पुष्टि करें कि आपका ऐप्लिकेशन लॉन्च किया गया हो. साथ ही, अनुमति देने की प्रक्रिया की जांच शुरू करें.

Home ऐप्लिकेशन से, ऐप्लिकेशन की सेटिंग बदलने के लिए यह तरीका अपनाएं:

1. Actions कंसोल पर जाएँ और अपना प्रोजेक्ट चुनें.
2. सबसे ऊपर मौजूद नेविगेशन में, जांच करें पर क्लिक करें.
3. Home ऐप्लिकेशन से खाता जोड़ने के फ़्लो को ट्रिगर करें:
1. Google Home ऐप्लिकेशन खोलें.
2. + बटन पर क्लिक करें.
3. डिवाइस सेट अप करें पर क्लिक करें.
4. क्या पहले से कुछ सेट अप किया हुआ है? पर क्लिक करें
5. सेवा देने वाली कंपनियों की सूची में से, अपना स्मार्ट होम ऐक्शन चुनें. इसे सूची में "[test]" से शुरू किया जाएगा. सूची से अपनी [test] कार्रवाई चुनने पर, आपका ऐप्लिकेशन खुल जाएगा.
6. पुष्टि करें कि आपका ऐप्लिकेशन लॉन्च किया गया हो. साथ ही, अनुमति देने की प्रक्रिया की जांच शुरू करें.