iOS নমুনা অ্যাপ তৈরি করুন

bookmark_border সেভ করা পৃষ্ঠা গুছিয়ে রাখতে 'সংগ্রহ' ব্যবহার করুন আপনার পছন্দ অনুযায়ী কন্টেন্ট সেভ করুন ও সঠিক বিভাগে রাখুন।

এই নমুনা iOS অ্যাপ্লিকেশন Google Home API ব্যবহার করে। প্রথমবার অ্যাপটি তৈরি এবং চালানোর জন্য এই নির্দেশিকাটি ব্যবহার করুন।

পূর্বশর্ত

iOS-এর জন্য হোম API ব্যবহার করার জন্য আপনার ন্যূনতম প্রয়োজনীয়তা রয়েছে তা নিশ্চিত করুন।

নমুনা অ্যাপটি তৈরি এবং ইনস্টল করতে, আপনার এটিতে Xcode সংস্করণ 15.3+ ইনস্টল করা একটি কম্পিউটারের প্রয়োজন হবে৷

এক্সকোড ডাউনলোড করুন

অ্যাপটি পরীক্ষা করতে আপনার প্রয়োজন হবে:

1. একটি Google অ্যাকাউন্ট ।
2. ফিজিক্যাল ডিভাইস কনফিগারেশন ফাইল তৈরি করতে অ্যাপল ডেভেলপার প্রোগ্রামে একটি অ্যাপল আইডি নথিভুক্ত করা হয়েছে। যদি ইতিমধ্যে তৈরি না করা হয়, তালিকাভুক্তি একটি অতিরিক্ত খরচ বহন করে এবং সম্পূর্ণ হতে 48 ঘন্টা পর্যন্ত সময় লাগতে পারে।
3. একটি iOS ডিভাইস (কোনও সিমুলেটর নয়) যেটি iOS 16.4+ পরীক্ষামূলক অ্যাকাউন্টের সাথে সেট আপ চলছে।
4. একটি Wi-Fi নেটওয়ার্ক।
5. একটি Google হাব যা হোম API সমর্থন করে ।
6. একটি থ্রেড বর্ডার রাউটার যদি আপনার ডিভাইসে থ্রেডের প্রয়োজন হয় এবং আপনার হাবের সেই ক্ষমতা না থাকে।
7. অন্তত একটি সমর্থিত ডিভাইস প্রকার ।

বিকাশের জন্য, আপনার একটি ম্যাকের প্রয়োজন হবে যা নিম্নলিখিত প্রয়োজনীয়তাগুলি পূরণ করে:

• macOS Sonoma বা তার পরে
• Xcode 15.3 বা তার পরে

অ্যাপল স্থাপনার কনফিগারেশন ফাইল তৈরি করুন

প্রথমত, একটি অ্যাপের জন্য অ্যাপ অ্যাটেস্ট ক্ষমতা সক্ষম করা প্রয়োজন। ফলস্বরূপ, এটি সিমুলেটর ডিভাইসে স্থাপন করা যাবে না। এর জন্য আপনাকে অ্যাপ অ্যাটেস্ট এনটাইটেলমেন্ট সহ একটি প্রভিশনিং প্রোফাইল তৈরি করতে হবে।

দ্বিতীয়ত, অ্যাপ এবং MatterExtension মধ্যে যোগাযোগের জন্য অ্যাপ গ্রুপগুলিকে সক্রিয় করা প্রয়োজন। এর জন্য আপনাকে একটি অ্যাপ গ্রুপ শনাক্তকারী নিবন্ধন করতে হবে।

আরও বিশদ বিবরণের জন্য, অ্যাপল-এর ​​প্রভিশনিং প্রোফাইলে একটি ডেভেলপমেন্ট প্রভিশনিং প্রোফাইল তৈরি করুন দেখুন।

নিম্নলিখিতগুলি একটি অ্যাপ স্থাপন করার জন্য প্রয়োজনীয় ন্যূনতম পদক্ষেপগুলির রূপরেখা দেয়:

1. MatterExtension সাথে যোগাযোগ করতে আপনার অ্যাপের জন্য একটি অ্যাপ গ্রুপ শনাক্তকারী তৈরি করুন।
   1. অ্যাপল ডেভেলপার পোর্টালে সাইন ইন করুন।
   2. একটি অ্যাপ গ্রুপ শনাক্তকারী যোগ করুন। উদাহরণস্বরূপ, এটি group.com.company.commissioning হিসাবে ফর্ম্যাট করা যেতে পারে।
2. বিকাশকারী অ্যাকাউন্টে আপনার পরীক্ষা ডিভাইস নিবন্ধন করুন .

3. আপনার অ্যাপ টার্গেটের জন্য একটি প্রোফাইল তৈরি করুন।

   1. আপনার অ্যাপের জন্য একটি অ্যাপ্লিকেশন বান্ডেল শনাক্তকারীর বিষয়ে সিদ্ধান্ত নিন। সনাক্তকারী অনন্য এবং বর্ণনামূলক হওয়া উচিত। উদাহরণস্বরূপ, এটি হিসাবে ফর্ম্যাট করা যেতে পারেcom.company.HomeApiSample . এই শনাক্তকারীটি এই বিভাগের বাকি অংশ জুড়ে ব্যবহার করা হবে।
   2. আপনার অ্যাপ আইডি নিবন্ধন করুন । অনুরোধ করা হলে, অ্যাপ অ্যাটেস্ট এবং অ্যাপ গ্রুপের ক্ষমতা যোগ করুন।

   3. নতুন তৈরি অ্যাপ আইডি সম্পাদনা করুন এবং নিবন্ধিত অ্যাপ গ্রুপ শনাক্তকারী যোগ করতে অ্যাপ গ্রুপের ক্ষমতা কনফিগার করুন।

   4. আপনার অ্যাপ ডেভেলপমেন্টের জন্য একটি ডেভেলপমেন্ট প্রভিশনিং প্রোফাইল তৈরি করুন । এটিকে আপনার নতুন তৈরি করা অ্যাপ আইডি এবং নির্বাচিত পরীক্ষা ডিভাইসের সাথে সংযুক্ত করুন। অ্যাপটিতে স্বাক্ষর করার জন্য আপনার কাছে একটি বিকাশকারী শংসাপত্র রয়েছে তা নিশ্চিত করুন।

      • আপনি যদি এখনও একটি তৈরি না করে থাকেন তবে নির্দেশাবলীর জন্য বিকাশকারী আইডি শংসাপত্র তৈরি করুন দেখুন৷

4. আপনার MatterExtension লক্ষ্যের জন্য একটি প্রোফাইল তৈরি করুন।

   1. আপনার MatterExtension জন্য একটি অ্যাপ্লিকেশন বান্ডেল শনাক্তকারীর বিষয়ে সিদ্ধান্ত নিন। আইডেন্টিফায়ার অ্যাপ আইডেন্টিফায়ার থেকে উত্তরাধিকারসূত্রে পাওয়া উচিত। উদাহরণস্বরূপ, এটি হিসাবে ফর্ম্যাট করা যেতে পারে com.company.HomeApiSample.MatterExtension .
   2. আপনার অ্যাপ আইডি নিবন্ধন করুন । অনুরোধ করা হলে, অ্যাপ গ্রুপ ক্ষমতা যোগ করুন।
   3. নতুন তৈরি অ্যাপ আইডি সম্পাদনা করুন এবং পূর্ববর্তী ধাপে তৈরি নিবন্ধিত অ্যাপ গ্রুপ শনাক্তকারী যোগ করতে অ্যাপ গ্রুপের ক্ষমতা কনফিগার করুন।
   4. MatterExtension জন্য একটি ডেভেলপমেন্ট প্রভিশনিং প্রোফাইল তৈরি করুন ।

OAuth ক্লায়েন্ট আইডি তৈরি করুন এবং হোম API সক্ষম করুন

Google এর প্রমাণীকরণ ব্যাকএন্ডে নিজেকে সনাক্ত করতে আপনার অ্যাপের একটি OAuth ক্লায়েন্ট আইডি প্রয়োজন। iOS এবং অ্যাপ্লিকেশানগুলির জন্য, OAuth ক্লায়েন্ট আইডি অ্যাপ্লিকেশনের ধরনটি iOS হিসাবে কনফিগার করা আবশ্যক৷ অ্যাপটি হোম এপিআই-তেও কল করবে। এই কার্যকারিতা সক্ষম করার জন্য, Google Cloud প্রকল্পে API সক্রিয় করা আবশ্যক৷

OAuth ক্লায়েন্ট আইডি তৈরি করুন

1. Google ক্লাউড কনসোলে, প্রকল্প নির্বাচক ড্যাশবোর্ডে যান এবং OAuth শংসাপত্র তৈরি করতে আপনি যে প্রকল্পটি ব্যবহার করতে চান সেটি নির্বাচন করুন৷
2. উপরের বাম দিকের মেনু বোতামে ক্লিক করে APIs এবং পরিষেবা পৃষ্ঠাতে যান > সমস্ত পণ্য দেখুন > APIs এবং পরিষেবাগুলি ।
3. নেভিগেশন মেনুতে, শংসাপত্রে ক্লিক করুন।

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

   1. আপনার ব্যবহারের ক্ষেত্রে নির্ভর করে, অভ্যন্তরীণ বা বাহ্যিক নির্বাচন করুন এবং তারপরে তৈরি করুন ক্লিক করুন। OAuth সম্মতি স্ক্রিন প্যানে প্রদর্শিত হয়।
   2. অন-স্ক্রীন নির্দেশাবলী অনুসারে অ্যাপ তথ্য পৃষ্ঠায় তথ্য লিখুন এবং তারপর সংরক্ষণ করুন এবং চালিয়ে যান ক্লিক করুন। স্কোপস ফলক প্রদর্শন করে।
   3. আপনাকে কোনো স্কোপ যোগ করতে হবে না, তাই সংরক্ষণ করুন এবং চালিয়ে যান এ ক্লিক করুন। পরীক্ষা ব্যবহারকারী ফলক প্রদর্শন করে।
   4. আপনি যদি একটি অভ্যন্তরীণ সম্মতি স্ক্রিন তৈরি করতে বেছে নেন, তাহলে আপনার অ্যাপে অ্যাক্সেস পরীক্ষা করার জন্য আপনাকে অবশ্যই ব্যবহারকারীদের যোগ করতে হবে। ব্যবহারকারী যোগ করুন ক্লিক করুন। ব্যবহারকারী যোগ করুন ফলক প্রদর্শন করে। পরীক্ষা ব্যবহারকারীদের আপনার অ্যাপে অনুমতি দেওয়ার বিশেষাধিকার রয়েছে। খালি ক্ষেত্রে, এক বা একাধিক Google অ্যাকাউন্ট ইমেল ঠিকানা যোগ করুন এবং তারপর যোগ করুন ক্লিক করুন।
   5. সংরক্ষণ করুন এবং চালিয়ে যান ক্লিক করুন। সারাংশ ফলক প্রদর্শন করে।
   6. আপনার OAuth সম্মতি স্ক্রীন তথ্য পর্যালোচনা করুন, এবং তারপর ড্যাশবোর্ডে ফিরে যান ক্লিক করুন।

5. বাম মেনু প্যানেলে, আপনার OAuth ক্লায়েন্ট আইডি তৈরি করতে শংসাপত্রে ক্লিক করুন।

   

   

   1. ক্রিয়েট ক্রেডেনশিয়াল বোতামে ক্লিক করুন এবং OAuth ক্লায়েন্ট আইডি নির্বাচন করুন।
      1. অ্যাপ্লিকেশন প্রকারের অধীনে, iOS নির্বাচন করুন।
   2. আপনার অ্যাপ শনাক্তকারী এবং অ্যাপল ডেভেলপার টিম আইডি সহ বান্ডেল আইডি লিখুন। অন্যান্য ক্ষেত্রগুলি ঐচ্ছিক এবং খালি রাখা যেতে পারে৷
   3. CREATE এ ক্লিক করুন এবং তৈরি করা ক্লায়েন্ট আইডি বা PLIST ডাউনলোড করুন । এটি পরে অনুমতি প্রবাহ কার্যকারিতা সক্ষম করতে ব্যবহার করা হবে৷ আরও তথ্যের জন্য, অনুমোদনের শংসাপত্র তৈরি করুন বিভাগটি দেখুন।

হোম API সক্রিয় করুন

হোম APIগুলিতে অ্যাক্সেস সক্ষম করুন৷

1. APIs এবং পরিষেবাগুলি ট্যাবে, সক্রিয় APIs এবং পরিষেবাগুলিতে ক্লিক করুন৷
2. পৃষ্ঠার শীর্ষে APIS এবং পরিষেবাগুলি সক্ষম করুন ক্লিক করুন৷
3. HOME API অনুসন্ধান করুন এবং এটি নির্বাচন করুন।
4. Home API বিস্তারিত পৃষ্ঠায়, ENABLE এ ক্লিক করুন।

সোর্স কোড ডাউনলোড করুন

নমুনা অ্যাপের সোর্স কোড GitHub এ উপলব্ধ।

আপনি যেখানে প্রকল্পটি সংরক্ষণ করতে চান সেখানে নেভিগেট করুন, তারপরে এটি ক্লোন করুন:

git clone https://github.com/google-home/google-home-api-sample-app-ios.git

Xcode-এ প্রজেক্ট লোড করতে, File > Open এ ক্লিক করুন এবং ক্লোন করা রিপোজিটরির রুটে GoogleHomeAPISampleIOS.xcodeproj নির্বাচন করুন।

SDK সেট আপ করুন

নমুনা অ্যাপ্লিকেশন প্রকল্প নির্মাণ করার জন্য কিছু অতিরিক্ত তথ্য প্রয়োজন. এর মধ্যে রয়েছে স্থানীয়ভাবে SDK ফ্রেমওয়ার্ক ফাইল যোগ করা, আপনার ডেভেলপার অ্যাকাউন্ট শনাক্তকারীর তথ্য তৈরি করা এবং আপনার OAuth ক্লায়েন্ট আইডি তৈরি করা।

অ্যাপটি তৈরি করুন

Home APIs iOS SDK ডাউনলোড করতে, আপনাকে প্রথমে Google Home Developers-এ সাইন ইন করতে হবে।

এখন সাইন ইন করুন!

নমুনা অ্যাপ্লিকেশনের জন্য আপনার Xcode প্রকল্প কনফিগার করুন:

1. Xcode নেভিগেশন প্যানে, প্রকল্প কনফিগারেশন সম্পাদনা করতে GoogleHomeAPISampleIOS ফাইলটি নির্বাচন করুন।

   

   

2. উপরের সাধারণ ট্যাবে ক্লিক করুন এবং বাম দিকে লক্ষ্য GoogleHomeAPISampleIOS নির্বাচন করুন।

3. যতক্ষণ না আপনি ফ্রেমওয়ার্ক, লাইব্রেরি এবং এমবেডেড কন্টেন্ট বিভাগ দেখতে পাচ্ছেন ততক্ষণ নিচে স্ক্রোল করুন। আপনার তালিকাভুক্ত দুটি হোম API ফ্রেমওয়ার্ক দেখতে হবে।

4. এম্বেড কলামে, GoogleHomeSDK.xcframework এর জন্য Embed & Sign নির্বাচন করুন। অন্য ফ্রেমওয়ার্ক, GoogleHomeTypes.xcframework , Do not Embed হিসাবে রেখে দেওয়া উচিত।

5. তালিকার নীচে, + আইকনে ক্লিক করুন।

6. অনুরোধ করা হলে, SafariServices.framework অনুসন্ধান করুন এবং যোগ করুন ক্লিক করুন। নিশ্চিত করুন যে এম্বেড কলামটি এই এন্ট্রির জন্য এম্বেড করবেন না হিসাবে সেট করা আছে।

   

   

7. লক্ষ্য সম্পাদনা করতে লক্ষ্যের অধীনে MatterAddDeviceExtension ক্লিক করুন।

8. আপনি ফ্রেমওয়ার্ক এবং লাইব্রেরি বিভাগ দেখতে না হওয়া পর্যন্ত নিচে স্ক্রোল করুন। আপনি GoogleHomeSDK.xcframework তালিকাভুক্ত দেখতে হবে।

9. এম্বেড কলামে, এম্বেড করবেন না নির্বাচন করুন।

10. বিকাশকারী এবং OAuth ক্লায়েন্ট আইডি কনফিগার করুন:

    1. নেভিগেশন প্যানে, GoogleHomeAPISampleIOS ফোল্ডারটি সন্ধান করুন এবং সম্পাদনার জন্য Info.plist ফাইলটি খুলুন৷

11. Info.plist ফাইলে, GIDClientID আপনার OAuth ক্লায়েন্ট আইডি ( সেট-আপ OAuth সম্মতি বিভাগটি দেখুন) এবং GIDTeamID-কে OAuth রেজিস্ট্রেশন প্রক্রিয়া চলাকালীন ব্যবহার করা ডেভেলপার অ্যাকাউন্টের Apple ডেভেলপার টিম আইডি দিয়ে পূরণ করুন।

12. অ্যাপ প্রমাণ করার ক্ষমতা যোগ করুন:

    1. এক্সকোড নেভিগেশন ফলকে, প্রকল্প কনফিগারেশন সম্পাদনা করতে GoogleHomeAPISampleIOS প্রকল্প ফাইলটি নির্বাচন করুন।
    2. উপরে সাইনিং এবং ক্যাপাবিলিটিস ট্যাবে ক্লিক করুন এবং টার্গেট বিভাগের অধীনে বাম দিকে লক্ষ্য GoogleHomeAPISampleIOS নির্বাচন করুন।
    3. সাইনিং এবং ক্যাপাবিলিটিস ট্যাবের নিচে, + ক্যাপাবিলিটি ক্লিক করুন এবং অ্যাপ অ্যাটেস্ট অনুসন্ধান করুন।
    4. যোগ করতে App Attest এ ক্লিক করুন। অনুসন্ধানে এই ক্ষমতাটি অনুপস্থিত থাকলে, প্রকল্পটি ইতিমধ্যেই এটি যোগ করে থাকতে পারে।

13. অ্যাপ গ্রুপের ক্ষমতা যোগ করুন।

    

    

    1. GoogleHomeAPISampleIOS প্রজেক্ট > GoogleHomeAPISampleIOS টার্গেটে যান।
    2. স্বাক্ষর এবং ক্ষমতা > + সক্ষমতা ক্লিক করুন।
    3. অ্যাপ গ্রুপের ক্ষমতা নির্বাচন করুন।
    4. অ্যাপ গ্রুপের অধীনে + আইকনে ক্লিক করুন এবং আপনার অ্যাপের জন্য অ্যাপ গ্রুপ শনাক্তকারী যোগ করুন যা আপনি অ্যাপল ডেভেলপার পোর্টালে যোগ করেছেন।
    5. MatterAddDeviceExtension টার্গেট অ্যাপ গ্রুপে যোগ করতে এই ধাপগুলি পুনরাবৃত্তি করুন।

14. বান্ডেল শনাক্তকারী আপডেট করুন

    1. আপনার বিকাশকারী শংসাপত্র এবং প্রভিশনিং প্রোফাইলগুলি ব্যবহার করে হার্ডওয়্যারে নমুনা অ্যাপটি সফলভাবে চালানো এবং স্থাপন করতে, আপনাকে একটি অনন্য বান্ডেল শনাক্তকারী প্রদান করতে হবে৷ এটি আপনার OAuth ক্লায়েন্ট শংসাপত্রের সাথে সম্পর্কিত একই শনাক্তকারী হওয়া উচিত (উপরে দেখুন)।
    2. এক্সকোড নেভিগেশন ফলকে, প্রকল্প কনফিগারেশন সম্পাদনা করতে GoogleHomeAPISampleIOS প্রকল্প ফাইলটি নির্বাচন করুন।
    3. উপরে সাইনিং এবং ক্যাপাবিলিটিস ট্যাবে ক্লিক করুন এবং টার্গেট বিভাগের অধীনে বাম দিকে লক্ষ্য GoogleHomeAPISampleIOS নির্বাচন করুন।
    4. সাইনিং বিভাগে বান্ডেল শনাক্তকারী ক্ষেত্রটি নির্বাচন করুন এবং অ্যাপ্লিকেশনের জন্য অনন্য শনাক্তকারী ইনপুট করুন।
    5. প্রয়োজনীয় এনটাইটেলমেন্ট সহ সেই বান্ডেলের সাথে সম্পর্কিত প্রভিশনিং প্রোফাইল নির্বাচন করুন বা ইনস্টল করুন।
    6. এক্সটেনশনের জন্য বান্ডেল শনাক্তকারী ইনপুট করতে এবং এর নিবন্ধিত প্রভিশনিং প্রোফাইল আমদানি করতে MatterAddDeviceExtension টার্গেটের জন্য এই পদক্ষেপগুলি পুনরাবৃত্তি করুন৷

15. কোডে নিবন্ধিত অ্যাপ গ্রুপ শনাক্তকারী আপডেট করুন।

    1. ডিভাইস কমিশনিংয়ের মতো বৈশিষ্ট্যগুলির জন্য অ্যাপ গ্রুপ শনাক্তকারী ব্যবহার করার জন্য SDK উদাহরণ কনফিগার করার জন্য অ্যাপ্লিকেশনটির প্রয়োজন। HOME_API_TODO_ADD_APP_GROUP স্ট্রিংটি অনুসন্ধান করে Apple ডেভেলপার পোর্টালে নিবন্ধিত অ্যাপ গ্রুপ আইডি ব্যবহার করতে অ্যাপটি আপডেট করুন এবং প্রতিটি উদাহরণ এটির সাথে প্রতিস্থাপন করুন।

    এই কনফিগারেশনগুলি নিম্নলিখিত ফাইলগুলিতে তৈরি করা হয়:

    • SDK শুরু হলে GoogleHomeAPISampleIOS.swift ।
    • RequestHandler.swift
    • CommissioningManager.swift