অথেনটিকেটর মেটাডেটা ফাইল যুক্ত করা

সিঙ্ক অ্যাডাপ্টর এবং একাউন্ট ফ্রেমওয়ার্কের মধ্যে আপনার অথেনটিকেটর উপাদান যুক্ত করতে, আপনার প্রয়োজন মেটাডেটা সহকারে এই ফ্রেমওয়ার্কগুলো সরবরাহ করা যা উপাদান বর্ণনা করে। এই মেটাডেটা একাউন্ট টাইপ ঘোষণা করে যা আপনি আপনার সিঙ্ক একাউন্টের জন্য তৈরী করেছেন এবং ইউজার ইন্টারফেস ডিক্লেয়ার করে যে যদি আপনি আপনার একাউন্ট টাইপ ইউজারের কাছে দৃশ্যমান করতে চান সিস্টেম এটা প্রদর্শন করে। এই মেটাডেটা আপনার অ্যাপ প্রজেক্টের /res/xml/ডিরেক্টরির মধ্যে স্টোর হওয়া একটি XML ফাইলে ডিক্লয়ার করুন। আপনি ফাইলটির যে কোন নাম দিতে পারেন, যদিও এটা সাধারনত authenticator.xml নামে পরিচিত।

এই XML ফাইল একটি একক এলিমেন্ট < account-authenticator>ধারন করে যার নিচের গুণগুলো রয়েছে:

android:accountType

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

যদি আপনার সার্ভার লগ-ইন না চায়, আপনাকে তখনও একটি একাউন্ট টাইপ সরবরাহ করতে হবে। ভ্যালুর জন্য, একটি ডোমেইন নেম ব্যবহার করুন যা আপনি নিয়ন্ত্রণ করেন। যখন ফ্রেমওয়ার্ক আপনার সিঙ্ক অ্যাডাপটর পরিচালনা করতে এটা ব্যবহার করে, ভ্যালু আপনার সার্ভারে পাঠানো হয় না।

android:icon

একটি আইকন ধারণ করা Drawable রিসোর্স এর প্রতি নির্দেশক। আপনি যদি res/xml/syncadapter.xml এর মধ্যে বিশেষত্ব android:userVisible="true" নির্দিষ্ট করার মাধ্যমে সিঙ্ক অ্যাডাপটর দৃশ্যমান করেন, তখন আপনাকে অবশ্যই এই আইকন রিসোর্স সরবরাহ করতে হবে। এটা সিস্টেমের সেটিংস অ্যাপের একাউন্টস (Accounts) সেকশনে দেখা যায়।

android:smallIcon

একটি ছোট আকারের আইকন ধারণ করা Drawable রিসোর্স এর প্রতি নির্দেশক। স্ক্রিনের আকারের উপর ভিত্তি করে এই রিসোর্স সিস্টেমের সেটিংস অ্যাপের একাউন্টস (Accounts) সেকশনের মধ্যে থাকা android:icon এর পরিবর্তে ব্যবহৃত হয়।

android:label

স্থানীয়করণযোগ্য স্ট্রিং যা ইউজারের একাউন্ট টাইপ পরীক্ষা করে। আপনি যদি res/xml/syncadapter.xml এর মধ্যে বিশেষত্ব android:userVisible="true" নির্দিষ্ট করার মাধ্যমে সিঙ্ক অ্যাডাপটর দৃশ্যমান করেন, তখন আপনাকে এই স্ট্রিং সরবরাহ করতে হবে। এটা সিস্টেমের সেটিংস অ্যাপের একাউন্টস (Accounts) সেকশনে দেখা যায়, অথেনটিকেটরের জন্য যে আইকন নির্ধারণ করেছেন তার পাশে দেখা যায়।

নিচের চিত্রটি অথেনটিকেটরের জন্য XML ফাইল দেখায় যা আপনি পূর্বে তৈরী করেছেন:

<?xml version="1.0" encoding="utf-8"?>
<account-authenticator
        xmlns:android="http://schemas.android.com/apk/res/android"
        android:accountType="example.com"
        android:icon="@drawable/ic_launcher"
        android:smallIcon="@drawable/ic_launcher"
        android:label="@string/app_name"/>