Android

قم بدمج رحلة Human Token في تطبيق Android الخاص بك باستخدام Custom Tabs.

Markdown

تقوم Custom Tabs بتشغيل رحلة Human Token في تبويب متصفح داخل تطبيقك. عند انتهاء الرحلة، يعيد المتصفح التوجيه إلى مخطط URL المخصص الخاص بك ويعترضه تطبيقك.

المتطلبات الأساسية

• Android 8 (API 26) أو أحدث
• androidx.browser:browser:1.5.0
• مخطط URL فريد لتطبيقك (مثل myapp)

الخطوة 1: إضافة التبعية

في ملف build.gradle الخاص بك:

implementation("androidx.browser:browser:1.5.0")

الخطوة 2: تحديد مخطط URL الخاص بك

اختر مخططًا فريدًا (مثل myapp). يُستخدم هذا كـ callbackUri عند إنشاء العملية:

callbackUri: myapp://callback

الخطوة 3: إنشاء النشاط

import android.content.Intent
import android.net.Uri
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import androidx.browser.customtabs.CustomTabsIntent

class HumanTokenActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        val url = intent.getStringExtra(EXTRA_PROCESS_URL) ?: return finish()

        CustomTabsIntent.Builder()
            .build()
            .launchUrl(this, Uri.parse(url))
    }

    override fun onNewIntent(intent: Intent) {
        super.onNewIntent(intent)
        intent.data?.let { uri ->
            if (uri.scheme == "myapp") {
                // Journey completed — send processId to your backend
                val processId = uri.getQueryParameter("id")
                handleResult(processId)
            }
        }
    }

    private fun handleResult(processId: String?) {
        // Fetch the result from your backend via Get Process
        finish()
    }

    companion object {
        const val EXTRA_PROCESS_URL = "process_url"
    }
}

الخطوة 4: تكوين AndroidManifest.xml

<uses-feature android:name="android.hardware.camera" android:required="false" />
<uses-permission android:name="android.permission.CAMERA" />

<activity
    android:name=".HumanTokenActivity"
    android:launchMode="singleTop"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:scheme="myapp" android:host="callback" />
    </intent-filter>
</activity>

يضمن singleTop أن يستدعي Android دالة onNewIntent() على النشاط الحالي بدلاً من إنشاء نشاط جديد.

الخطوة 5: بدء الرحلة

val intent = Intent(this, HumanTokenActivity::class.java)
    .putExtra(HumanTokenActivity.EXTRA_PROCESS_URL, processLink)
startActivity(intent)

ملخص الملفات

الملف	الغرض
build.gradle	تبعية androidx.browser
HumanTokenActivity.kt	تشغيل Custom Tabs + معالجة إعادة التوجيه
AndroidManifest.xml	مرشح Intent لمخطط URL الخاص بك