ক্যোয়ারী প্যারামিটার ব্যবহার করে একটি বিশ্বস্ত ওয়েব কার্যকলাপে তথ্য প্রেরণ করা

André Cipriani Bandarra

তাদের অ্যাপ্লিকেশনগুলিতে বিশ্বস্ত ওয়েব কার্যকলাপ ব্যবহার করার সময়, বিকাশকারীদেরকে অ্যাপ্লিকেশনটির স্থানীয় অংশ থেকে প্রগ্রেসিভ ওয়েব অ্যাপে (PWA) তথ্য প্রেরণ করতে হতে পারে।

এটির জন্য একটি সাধারণ ব্যবহার-ক্ষেত্র হল বিশ্বস্ত ওয়েব কার্যকলাপ থেকে শুরু হওয়া ইনস্টলেশন এবং সেশনগুলি পরিমাপ করতে কাস্টম বিশ্লেষণ বিভাজন প্রয়োগ করা। এটি বাস্তবায়নের জন্য লঞ্চ URL-এ কোয়েরি প্যারামিটার যোগ করা যেতে পারে।

স্টার্ট URL পরিবর্তন করা হচ্ছে

PWA-তে পাস করা প্যারামিটার যদি ব্যবহারকারী এবং লঞ্চ জুড়ে একই থাকে, তাহলে প্যারামিটারটি সরাসরি লঞ্চ URL-এ যুক্ত করা যেতে পারে। এই ব্যবহারের একটি উদাহরণ হল যখন ডেভেলপাররা একটি বিশ্বস্ত ওয়েব কার্যকলাপ থেকে তৈরি নেভিগেশন সেশনের সংখ্যা পরিমাপ করতে চায়৷

Bubblewrap ব্যবহার করে

Bubblewrap হল একটি টুল যা ডেভেলপারদেরকে একটি Android অ্যাপ্লিকেশনের জন্য একটি প্রজেক্ট তৈরি করতে সাহায্য করার জন্য তৈরি করা হয়েছে যা একটি বিশ্বস্ত ওয়েব অ্যাক্টিভিটি ব্যবহার করে একটি বিদ্যমান PWA চালু করে। এটিতে একটি লাইব্রেরি এবং একটি কমান্ড লাইন ইন্টারফেস (CLI) উভয়ই রয়েছে।

একটি নতুন প্রকল্প তৈরি করা হচ্ছে

Bubblewrap CLI ব্যবহার করার সময়, একটি প্রজেক্ট init কমান্ড দিয়ে শুরু করা হয়, এবং একটি ওয়েব ম্যানিফেস্ট থেকে ডিফল্ট মান তৈরি করে, একটি প্যারামিটার হিসাবে প্রদান করা হয়:

bubblewrap init --manifest https://material.money/manifest.json

উইজার্ড ওয়েব ম্যানিফেস্ট থেকে start_url ডিফল্ট হিসাবে ব্যবহার করবে এবং ব্যবহারকারীদের মান নিশ্চিত করতে বলবে, বিকাশকারীদের প্রগ্রেসিভ ওয়েব অ্যাপ শুরু করতে ব্যবহৃত url-এ অতিরিক্ত প্যারামিটার যোগ করার সুযোগ দেবে।

একটি বিদ্যমান প্রকল্প সংশোধন করা হচ্ছে

যখন Bubblewrap একটি প্রকল্প তৈরি করে, তখন সেই নির্দিষ্ট প্রকল্পের তথ্য প্রকল্প ফোল্ডারে twa-manifest.json নামক একটি ফাইলে সংরক্ষণ করা হয়। বিদ্যমান প্রকল্পের জন্য স্টার্ট ইউআরএল পরিবর্তন করতে, বিকাশকারীদের ফাইলটি সংশোধন করতে হবে:

{
  ...
  "startUrl": "/?utm_source=trusted-web-activity",
  ...
}

তারপরে, প্রকল্প ফাইলগুলি পুনরায় তৈরি করুন এবং নতুন শুরু URL প্রয়োগ করুন৷

bubblewrap update

অ্যান্ড্রয়েড স্টুডিও ব্যবহার করে

অ্যান্ড্রয়েড স্টুডিও এবং ডিফল্ট লঞ্চার অ্যাক্টিভিটি ব্যবহার করার সময়, startUrl-কে AndroidManifest.xml-এর মধ্যে একটি মেটা ট্যাগ হিসাবে সংজ্ঞায়িত করা হয় এবং আমরা এটি পরিবর্তন করে বিশ্বস্ত ওয়েব অ্যাক্টিভিটি চালু করতে ব্যবহৃত URL পরিবর্তন করতে পারি:

<activity android:name="com.google.androidbrowserhelper.trusted.LauncherActivity"
    android:label="@string/app_name">
    ...
    <meta-data android:name="android.support.customtabs.trusted.DEFAULT_URL"
        android:value="https://svgomg.firebaseapp.com/?utm_source=trusted-web-activity" />
    ...
</activity>

দ্রষ্টব্য: Bubblewrap সমস্ত অ্যাপ্লিকেশন জুড়ে URL গুলি একই মূলের সাথে মেলে তা নিশ্চিত করার যত্ন নেয় এবং তাই, স্টার্ট URL এর জন্য একটি আপেক্ষিক ব্যবহার করে৷ AndroidManifest.xml পরিবর্তন করার সময়, স্কিমা এবং ডোমেন সহ সম্পূর্ণ URL ব্যবহার করতে হবে।

গতিশীলভাবে স্টার্ট URL পরিবর্তন করা হচ্ছে

অন্যান্য ক্ষেত্রে, বিকাশকারীরা প্যারামিটার তৈরি করতে চাইতে পারে যা ব্যবহারকারী বা সেশন জুড়ে পরিবর্তিত হয়, উদাহরণস্বরূপ। বেশিরভাগ ক্ষেত্রে, এটি প্রগ্রেসিভ ওয়েব অ্যাপে পাস করার জন্য অ্যাপ্লিকেশনটির অ্যান্ড্রয়েড দিক থেকে বিশদ সংগ্রহ করা জড়িত।

ধাপ 1: একটি কাস্টম লঞ্চার অ্যাক্টিভিটি তৈরি করুন

public class CustomQueryStringLauncherActivity extends LauncherActivity {
    private String getDynamicParameterValue() {
        return String.valueOf((int)(Math.random() * 1000));
    }

    @Override
    protected Uri getLaunchingUrl() {
        // Get the original launch Url.
        Uri uri = super.getLaunchingUrl();

        // Get the value we want to use for the parameter value
        String customParameterValue = getDynamicParameterValue();

        // Append the extra parameter to the launch Url
        return uri
                .buildUpon()
                .appendQueryParameter("my_parameter", customParameterValue)
                .build();
    }
}

ধাপ 2: কাস্টম লঞ্চার অ্যাক্টিভিটি ব্যবহার করতে AndroidManifest.xml পরিবর্তন করুন

<activity android:name="com.myapp.CustomQueryStringLauncherActivity"
    android:label="@string/app_name">
    ...
    <meta-data android:name="android.support.customtabs.trusted.DEFAULT_URL"
        android:value="https://squoosh.app/?utm_source=trusted-web-activity" />
    ...
</activity>

দ্রষ্টব্য: Bubblewrap এই মুহূর্তে গতিশীলভাবে কোয়েরি প্যারামিটার তৈরি করা সমর্থন করে না। এই বৈশিষ্ট্যটির প্রয়োজন আছে এমন ডেভেলপারদের কাছ থেকে আমরা শুনতে আগ্রহী। Bubblewrap সমস্যা ট্র্যাকার দেখুন এবং আপনার ব্যবহার-কেস সম্পর্কে আমাদের বলুন।

উপসংহার

একটি অ্যাপ্লিকেশনের নেটিভ অংশ থেকে ওয়েব অংশে তথ্য প্রেরণ ক্যোয়ারী প্যারামিটার ব্যবহার করে অর্জন করা যেতে পারে। যখন একটি প্যারামিটার কোয়েরি স্ট্রিং-এ যোগ করা হয়, তখন এটি পৃষ্ঠায় চলমান স্ক্রিপ্টগুলিতে অ্যাক্সেসযোগ্য হবে এবং ব্যবহারকারীরা যখন একটি ভিন্ন পৃষ্ঠায় নেভিগেট করেন বা বিকাশকারী একটি শেয়ার অ্যাকশন প্রয়োগ করেন তখন এটি রেফারেলের অংশ হতে পারে।

বিকাশকারীদের অবশ্যই সেই প্রভাবগুলি সম্পর্কে সচেতন হতে হবে এবং rel=noreferrer লিঙ্ক ব্যবহার করে বা পৃষ্ঠা অবস্থান API ব্যবহার করে URL পরিষ্কার-পরিচ্ছন্ন করে তাদের প্রশমিত করতে পারে।

ট্রাস্টেড ওয়েব অ্যাক্টিভিটি প্রোটোকল বর্তমানে ওয়েব পার্ট আহ্বান করার পরে অ্যাপ্লিকেশনের নেটিভ অংশের সাথে বার্তা আদান-প্রদান করার কোনো ব্যবস্থা প্রদান করে না।

আমরা বিশ্বাস করি বিদ্যমান বা আসন্ন ওয়েব প্ল্যাটফর্ম এপিআইগুলি বিকাশকারীদের দ্বারা প্রয়োজনীয় বেশিরভাগ ব্যবহারের ক্ষেত্রে সক্ষম করে। আপনি যদি নতুন বা আসন্ন ওয়েব এপিআই খুঁজছেন, নতুন ক্ষমতা স্থিতি পৃষ্ঠাটি দেখুন।