সাইনআপ এবং API কী

গুগল অ্যাওয়ারনেস এপিআই ব্যবহার করার জন্য, আপনাকে অবশ্যই আপনার অ্যাপে একটি গুগল এপিআই কী যুক্ত করতে হবে। আপনার যে ধরণের এপিআই কী প্রয়োজন তা হল একটি অ্যান্ড্রয়েড এপিআই কী।

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

অ্যান্ড্রয়েড এপিআই কীগুলি নির্দিষ্ট সার্টিফিকেট-প্যাকেজ জোড়ার সাথে লিঙ্ক করা থাকে। অ্যাপটির জন্য আপনার যত ব্যবহারকারীই থাকুক না কেন, প্রতিটি সার্টিফিকেটের জন্য আপনার কেবল একটি কী প্রয়োজন।

আপনার অ্যাপের জন্য একটি কী পেতে আপনাকে বেশ কয়েকটি ধাপ অনুসরণ করতে হবে। এই নির্দেশিকায় সেগুলি বিস্তারিতভাবে বর্ণনা করা হয়েছে এবং নিম্নরূপ সংক্ষেপে বর্ণনা করা হয়েছে:

1. আপনার অ্যাপের সার্টিফিকেট সম্পর্কে তথ্য পান।
2. গুগল ডেভেলপারস কনসোলে একটি প্রকল্প নিবন্ধন করুন এবং প্রকল্পের জন্য একটি পরিষেবা হিসাবে ব্যবহারকারী প্রসঙ্গ API যোগ করুন।
3. চাবি চাও।
4. আপনার অ্যাপে কী যোগ করুন। এটি করার জন্য, আপনার অ্যাপ ম্যানিফেস্টে একটি উপাদান যোগ করুন।

আপনার অ্যাপের সার্টিফিকেটের তথ্য খুঁজুন

API কীটি আপনার অ্যাপের ডিজিটাল সার্টিফিকেটের একটি সংক্ষিপ্ত রূপের উপর ভিত্তি করে তৈরি, যা এর SHA-1 ফিঙ্গারপ্রিন্ট নামে পরিচিত। আপনার সার্টিফিকেটের জন্য SHA-1 ফিঙ্গারপ্রিন্ট প্রদর্শন করতে, প্রথমে নিশ্চিত করুন যে আপনি সঠিক সার্টিফিকেট ব্যবহার করছেন। আপনার কাছে নিম্নলিখিত দুটি সার্টিফিকেট থেকে বেছে নিতে পারেন:

• একটি ডিবাগ সার্টিফিকেট : যখন আপনি একটি ডিবাগ বিল্ড করেন তখন Android SDK টুলগুলি স্বয়ংক্রিয়ভাবে এই সার্টিফিকেট তৈরি করে। এই সার্টিফিকেটটি শুধুমাত্র আপনি যে অ্যাপগুলি পরীক্ষা করছেন সেগুলির সাথে ব্যবহার করুন। ডিবাগ সার্টিফিকেট দিয়ে সাইন করা কোনও অ্যাপ প্রকাশ করার চেষ্টা করবেন না। অ্যান্ড্রয়েড ডেভেলপার ডকুমেন্টেশনের "আপনার ডিবাগ বিল্ড সাইন করুন" বিভাগে ডিবাগ সার্টিফিকেটটি আরও বিশদে বর্ণনা করা হয়েছে।
• একটি রিলিজ সার্টিফিকেট : যখন আপনি একটি রিলিজ বিল্ড করেন তখন Android SDK টুলগুলি এই সার্টিফিকেট তৈরি করে। আপনি keytool প্রোগ্রামের মাধ্যমেও এই সার্টিফিকেট তৈরি করতে পারেন। যখন আপনি আপনার অ্যাপটি বিশ্বের কাছে প্রকাশ করার জন্য প্রস্তুত হন তখন এই সার্টিফিকেটটি ব্যবহার করুন।

keytool সম্পর্কে আরও তথ্যের জন্য, এর Oracle ডকুমেন্টেশন দেখুন।

ডিবাগ সার্টিফিকেট

ডিবাগ সার্টিফিকেট ফিঙ্গারপ্রিন্ট প্রদর্শন করুন

একটি সার্টিফিকেটের SHA-1 ফিঙ্গারপ্রিন্ট প্রদর্শনের জন্য -v প্যারামিটার সহ keytool প্রোগ্রামটি ব্যবহার করুন। এটি করার জন্য, নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:

1. আপনার ডিবাগ কীস্টোর ফাইলটি সনাক্ত করুন। ফাইলটির নাম debug.keystore , এবং এটি আপনার প্রথম প্রকল্প তৈরি করার সময় তৈরি করা হয়েছে। ডিফল্টরূপে, এটি আপনার অ্যান্ড্রয়েড ভার্চুয়াল ডিভাইস (AVD) ফাইলগুলির মতো একই ডিরেক্টরিতে সংরক্ষণ করা হয়:

   • ওএস এক্স এবং লিনাক্স : ~/.android/
   • উইন্ডোজ ভিস্তা এবং উইন্ডোজ ৭ : C:\Users\your_user_name\.android\

2. SHA-1 ফিঙ্গারপ্রিন্টের তালিকা তৈরি করুন:

   • লিনাক্স বা ওএস এক্স এর জন্য, একটি টার্মিনাল উইন্ডো খুলুন এবং নিম্নলিখিতটি লিখুন:

     keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

   • উইন্ডোজ ভিস্তা এবং উইন্ডোজ ৭ এর জন্য, নিম্নলিখিতটি চালান:

     keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

আপনি নিম্নলিখিতগুলির মতো আউটপুট দেখতে পাবেন:

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3

মুক্তির সার্টিফিকেট

রিলিজ সার্টিফিকেটের আঙুলের ছাপ প্রদর্শন করুন

একটি সার্টিফিকেটের SHA-1 ফিঙ্গারপ্রিন্ট প্রদর্শনের জন্য -v প্যারামিটার সহ keytool প্রোগ্রামটি ব্যবহার করুন। এটি করার জন্য, নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:

1. আপনার রিলিজ সার্টিফিকেট কীস্টোর ফাইলটি সনাক্ত করুন। রিলিজ কীস্টোরের জন্য কোনও ডিফল্ট অবস্থান বা নাম নেই। রিলিজের জন্য আপনার অ্যাপ তৈরি করার সময় যদি আপনি কোনও নির্দিষ্ট না করেন, তাহলে বিল্ডটি আপনার .apk স্বাক্ষরবিহীন রেখে যায় এবং এটি প্রকাশ করার আগে আপনাকে এটিতে স্বাক্ষর করতে হবে। রিলিজ সার্টিফিকেটের জন্য, আপনার সার্টিফিকেটের উপনাম, কীস্টোরের পাসওয়ার্ড এবং সার্টিফিকেটেরও প্রয়োজন।

2. একটি কীস্টোরের সমস্ত কীগুলির উপনাম তালিকাভুক্ত করতে নিম্নলিখিতটি লিখুন:

   keytool -list -keystore your_keystore_name
         

3. your_keystore_name সম্পূর্ণরূপে যোগ্য পাথ এবং কীস্টোরের নাম দিয়ে প্রতিস্থাপন করুন। .keystore এক্সটেনশনটি অন্তর্ভুক্ত করুন। অনুরোধ করা হলে কীস্টোরের পাসওয়ার্ড লিখুন। তারপর, keytool কীস্টোরের সমস্ত উপনাম প্রদর্শন করে।

4. টার্মিনাল অথবা কমান্ড প্রম্পটে নিম্নলিখিতটি লিখুন:

         keytool -list -v -keystore your_keystore_name -alias your_alias_name
         

5. your_keystore_name পরিবর্তে keystore এর সম্পূর্ণ যোগ্য পাথ এবং নাম দিন। .keystore এক্সটেনশনটি অন্তর্ভুক্ত করুন।
6. your_alias_name সার্টিফিকেট তৈরি করার সময় যে উপনামটি দিয়েছিলেন তা দিয়ে প্রতিস্থাপন করুন।

আপনি নিম্নলিখিতগুলির মতো আউটপুট দেখতে পাবেন:

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

SHA1 দিয়ে শুরু হওয়া লাইনটিতে সার্টিফিকেটের SHA-1 ফিঙ্গারপ্রিন্ট থাকে। ফিঙ্গারপ্রিন্ট হল কোলন দ্বারা পৃথক করা ২০টি দুই-অঙ্কের হেক্সাডেসিমেল সংখ্যার ক্রম।

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

গুগল ডেভেলপারস কনসোল থেকে একটি API কী পান

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

চাবি নাও।

অথবা, একটি API কী পেতে এই পদক্ষেপগুলি অনুসরণ করুন:

1. গুগল ডেভেলপারস কনসোলে যান।
2. একটি প্রকল্প নির্বাচন করুন, অথবা একটি নতুন প্রকল্প তৈরি করুন।
3. সচেতনতা API সক্রিয় করতে চালিয়ে যান ক্লিক করুন।

4. "শংসাপত্র" পৃষ্ঠায়, একটি অ্যান্ড্রয়েড কী তৈরি করুন এবং API শংসাপত্র সেট করুন।

   দ্রষ্টব্য: যদি আপনার কাছে একটি বিদ্যমান অ্যান্ড্রয়েড কী থাকে, তাহলে আপনি এটি ব্যবহার করতে পারেন।

5. 'কি তৈরি করুন' ডায়ালগে, আপনাকে আপনার ব্যবহার কেবলমাত্র Android অ্যাপের মধ্যেই সীমাবদ্ধ রাখতে হবে। এটি করার জন্য, আপনার অ্যাপের SHA-1 ফিঙ্গারপ্রিন্ট এবং প্যাকেজের নাম লিখুন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

   BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
   
   com.example.android.awareness-example
   

6. তৈরি করুন এ ক্লিক করুন। আপনার নতুন অ্যান্ড্রয়েড API কী আপনার প্রকল্পের API কীগুলির তালিকায় প্রদর্শিত হবে। একটি API কী হল অক্ষরের একটি স্ট্রিং, যেমন নিম্নলিখিত:

   AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0
   

এখন যেহেতু আপনার কাছে একটি API কী আছে, আপনি এটি আপনার অ্যাপের ম্যানিফেস্টে যোগ করতে পারেন, যেমনটি শুরু করার নির্দেশিকায় বর্ণিত হয়েছে।

অতিরিক্ত API সক্রিয় করুন

Awareness API আপনাকে একাধিক ধরণের প্রাসঙ্গিক ডেটা অ্যাক্সেস করতে দেয়, যেমন beacons । এই ধরণের ডেটা ব্যবহার করার জন্য, আপনাকে Google Developers Console-এ সংশ্লিষ্ট API গুলি সক্ষম করতে হবে।

সেবা	সচেতনতা API পদ্ধতি	সক্রিয় করার জন্য API
বীকন	SnapshotApi.getBeaconState() , FenceApi.BeaconFence	কাছাকাছি বার্তা API