Google মানচিত্র প্ল্যাটফর্ম টিম নিয়মিত নতুন বৈশিষ্ট্য, বাগ ফিক্স এবং কর্মক্ষমতা উন্নতি সহ SDK আপডেট করে। এই পৃষ্ঠাটি কীভাবে মোবাইল SDK-তে আপনার নির্ভরতা পরিচালনা করতে হয় তার নির্দেশিকা প্রদান করে।
কোন সংস্করণ লিঙ্ক?
মিশন-সমালোচনামূলক অ্যাপগুলির জন্য , আপনি যে প্রধান সংস্করণটি ব্যবহার করছেন তার সর্বশেষ ডট রিলিজের সাথে লিঙ্ক করুন (X.*), এবং নতুন প্রধান সংস্করণে বার্ষিক আপগ্রেড করুন৷
আপনি সারা বছর ধরে আপনার অ্যাপ্লিকেশনের নতুন সংস্করণ প্রকাশ করার সাথে সাথে আপনি iOS এর জন্য মানচিত্র SDK-এর নতুন ডট সংস্করণগুলি ব্যবহার করা শুরু করতে পারেন৷ এর জন্য আপনার অ্যাপ্লিকেশনে আপডেটের প্রয়োজন হবে না কারণ নতুন ডট সংস্করণগুলি পশ্চাদপদ সামঞ্জস্যপূর্ণ।
সুবিধা:
- আপনি iOS-এর জন্য Maps SDK-এ সমস্যাগুলি আবিষ্কার করলে, মোবাইল সমর্থন নীতি অনুসারে প্রধান সংস্করণের প্রাথমিক প্রকাশের 12 মাসের জন্য একটি পশ্চাদমুখী-সামঞ্জস্যপূর্ণ উপায়ে সমাধানগুলি প্রদান করা হবে৷ সংশোধনগুলি থেকে উপকৃত হওয়ার জন্য আপনাকে অবিলম্বে একটি বেমানান SDK সংস্করণে আপগ্রেড করার প্রয়োজন হবে না৷
- আপনার অ্যাপটি ইতিমধ্যেই সর্বশেষ সংস্করণে নির্মিত হলে সর্বশেষ উন্নতি এবং বৈশিষ্ট্যগুলি গ্রহণ করা সহজ৷
- SDK-এর নতুন প্রধান সংস্করণে বার্ষিক ক্রমবর্ধমান আপডেটগুলি একাধিক প্রধান সংস্করণ রিলিজ জুড়ে প্রবর্তিত পিছনের-অসঙ্গত পরিবর্তনগুলি পরিচালনা করার চেয়ে আপনার অ্যাপ্লিকেশনকে মানিয়ে নিতে, পুনর্লিখন এবং পরীক্ষা করার জন্য কম পরিশ্রমের প্রয়োজন হতে পারে।
অ-সমালোচনামূলক অ্যাপের জন্য , যেকোনো নির্দিষ্ট সংস্করণে লিঙ্ক করুন। আপনি যখন সেই স্থির সংস্করণের জন্য একটি অবমূল্যায়ন বিজ্ঞপ্তি পাবেন, তখন আপনার আপডেট করা অ্যাপ কোডটি আপনার ব্যবহারকারীদের জন্য উপলব্ধ করার জন্য আপনার কাছে 12 মাস সময় থাকবে।
সুবিধা:
- কম ঘন ঘন রক্ষণাবেক্ষণ কাজ.
- আপনার অ্যাপের নতুন সংস্করণগুলি পুরনো মোবাইল অপারেটিং সিস্টেমে চলমান ব্যবহারকারীদের ডিভাইসগুলিকে দীর্ঘ সময়ের জন্য সমর্থন করে (যতক্ষণ না আপনাকে একটি নতুন SDK সংস্করণে আপগ্রেড করতে হবে)।
নিরীক্ষণ করা ইমেল ঠিকানা সহ প্রকল্পের মালিকরা তাদের প্রতিটি প্রকল্পকে প্রভাবিত করে এমন পরিবর্তনগুলি সম্পর্কে সক্রিয় বিজ্ঞপ্তি পান। প্রধান আপডেট, অবচয়, এবং অন্যান্য পরিবর্তন সম্পর্কে অবগত থাকুন ।
ইনস্টলেশন
সুইফট প্যাকেজ ম্যানেজার
iOS এর জন্য Maps SDK সুইফট প্যাকেজ ম্যানেজারের মাধ্যমে ইনস্টল করা যেতে পারে। SDK যোগ করতে, নিশ্চিত করুন যে আপনি iOS নির্ভরতার জন্য বিদ্যমান মানচিত্র SDK মুছে ফেলেছেন।
একটি নতুন বা বিদ্যমান প্রকল্পে SDK যোগ করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- আপনার Xcode
project
বাworkspace
খুলুন, তারপর ফাইল > প্যাকেজ নির্ভরতা যোগ করুন এ যান। - URL হিসেবে https://github.com/googlemaps/ios-maps-sdk লিখুন, প্যাকেজ টানতে এন্টার টিপুন এবং "প্যাকেজ যোগ করুন" এ ক্লিক করুন।
- একটি নির্দিষ্ট
version
ইনস্টল করতে, নির্ভরতা নিয়ম ক্ষেত্রটি সংস্করণ-ভিত্তিক বিকল্পগুলির একটিতে সেট করুন। নতুন প্রকল্পগুলির জন্য, আমরা সর্বশেষ সংস্করণ নির্দিষ্ট করার এবং "সঠিক সংস্করণ" বিকল্পটি ব্যবহার করার পরামর্শ দিই৷ একবার সম্পূর্ণ হলে, "প্যাকেজ যোগ করুন" এ ক্লিক করুন।
একটি বিদ্যমান প্রকল্পের জন্য package
আপডেট করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
আপনি যদি 9.0.0 এর আগে কোনো সংস্করণ থেকে আপগ্রেড করছেন, তাহলে আপনাকে অবশ্যই নিম্নলিখিত নির্ভরতাগুলি সরিয়ে ফেলতে হবে: আপগ্রেড করার পরে
GoogleMapsBase
,GoogleMapsCore
, এবংGoogleMapsM4B
৷GoogleMaps
জন্য নির্ভরতা মুছে ফেলবেন না। আরও তথ্যের জন্য, সংস্করণ 9.0.0 রিলিজ নোট দেখুন।আপনার Xcode প্রকল্প কনফিগারেশন সেটিংস থেকে, ফ্রেমওয়ার্ক, লাইব্রেরি এবং এমবেডেড সামগ্রী খুঁজুন। নিম্নলিখিত কাঠামো অপসারণ করতে বিয়োগ চিহ্ন(-) ব্যবহার করুন:
-
GoogleMapsBase
(শুধুমাত্র 9.0.0 এর আগের সংস্করণ থেকে আপগ্রেডের জন্য) -
GoogleMapsCore
(শুধুমাত্র 9.0.0 এর আগের সংস্করণ থেকে আপগ্রেডের জন্য) -
GoogleMapsM4B
(শুধুমাত্র 9.0.0 এর আগের সংস্করণ থেকে আপগ্রেডের জন্য)
-
- এক্সকোড থেকে, "ফাইল> প্যাকেজ> সর্বশেষ প্যাকেজ সংস্করণে আপডেট" এ যান।
- আপনার ইনস্টলেশন যাচাই করতে, প্যাকেজ এবং এর সংস্করণ যাচাই করতে প্রজেক্ট নেভিগেটরের প্যাকেজ নির্ভরতা বিভাগে যান।
CocoaPods
ব্যবহার করে যোগ করা iOS নির্ভরতাগুলির জন্য বিদ্যমান মানচিত্র SDK সরাতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- আপনার এক্সকোড ওয়ার্কস্পেস বন্ধ করুন। টার্মিনাল খুলুন এবং নিম্নলিখিত কমান্ডটি চালান:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
Podfile
,Podfile.resolved
এবং Xcodeworkspace
সরিয়ে ফেলুন যদি আপনি CocoaPods ছাড়া অন্য কিছুর জন্য ব্যবহার না করেন।
কোকোপডস
আশাবাদী অপারেটর ( ~>
) ব্যবহার না করে সর্বদা আপনার নির্ভরতাগুলিতে একটি সংস্করণ নম্বর নির্দিষ্ট করুন কারণ এটি অপ্রত্যাশিত এবং অপূরণীয় বিল্ডের দিকে নিয়ে যেতে পারে। iOS-এর জন্য মানচিত্র SDK শব্দার্থিক সংস্করণ মেনে চলে এবং নতুন প্রধান সংস্করণ প্রকাশের মধ্যে ব্রেকিং পরিবর্তন অন্তর্ভুক্ত রয়েছে।
পডফাইল সিনট্যাক্স ব্যবহার করে একটি উদাহরণ পডফাইল নির্ভরতা:
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleMaps', '9.2.0' end
রক্ষণাবেক্ষণ এবং আপগ্রেড
সাম্প্রতিক উন্নতিগুলির সাথে তৈরি করতে, নিয়মিত নতুন সংস্করণগুলির জন্য পরীক্ষা করুন এবং আপনার সংস্করণের বৈশিষ্ট্যগুলি আপডেট করুন৷ আপনি যদি একটি নতুন প্রধান সংস্করণে আপডেট করছেন, তাহলে পিছনের-অসঙ্গত পরিবর্তনের জন্য রিলিজ নোটগুলি দেখুন এবং কীভাবে আপনার কোড আপডেট করবেন।
সুইফট প্যাকেজ ম্যানেজার
একটি বিদ্যমান প্রকল্পের জন্য package
আপডেট করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- আপনার ইনস্টলেশন যাচাই করতে, প্যাকেজ এবং এর সংস্করণ যাচাই করতে প্রজেক্ট নেভিগেটরের প্যাকেজ নির্ভরতা বিভাগে যান।
কোকোপডস
একটি টার্মিনাল খুলুন এবং
Podfile
ধারণকারী ডিরেক্টরিতে যান:cd <path-to-project>
- iOS এর জন্য Maps SDK-এর একটি নতুন সংস্করণ উপলব্ধ কিনা তা দেখতে
pod outdated
। - যদি SDK-এর একটি নতুন সংস্করণ পাওয়া যায়, তাহলে এই নতুন সংস্করণের সাথে আপনার
Podfile
আপডেট করুন। কিভাবে আপনারPodfile
এ একটি নির্দিষ্ট সংস্করণ সেট করতে হয় তা জানতে পড সংস্করণ নির্দিষ্ট করা দেখুন। -
pod update
চালান। - আপগ্রেডের ফলে প্রয়োজনীয় কোনো পরিবর্তন করুন। প্রতিটি রিলিজের পরিবর্তনের তালিকার জন্য রিলিজ নোট দেখুন।
- পণ্য > পরিষ্কার এবং তারপর পণ্য > বিল্ড নির্বাচন করে আপনার প্রকল্প পরিষ্কার এবং পুনর্নির্মাণ করুন
ম্যানুয়াল ইনস্টলেশন
SDK ইন্সটল করে সর্বশেষ সোর্স ফাইলের লিঙ্ক পান ।
নতুন সংস্করণগুলির জন্য পোলিং ছাড়াও, Google ক্লাউড প্রকল্পের মালিকরা তাদের প্রকল্পগুলিকে প্রভাবিত করতে পারে এমন অসঙ্গতিপূর্ণ পরিবর্তনগুলি সম্পর্কে ইমেলগুলি পান৷ পিছনের দিকে বেমানান পরিবর্তন সম্পর্কে সক্রিয় বিজ্ঞপ্তি পেতে, আপনার প্রতিটি প্রকল্পের জন্য একটি নিরীক্ষণ করা ইমেল ঠিকানা সহ মালিকের ভূমিকা বরাদ্দ করুন ৷
,Google মানচিত্র প্ল্যাটফর্ম টিম নিয়মিত নতুন বৈশিষ্ট্য, বাগ ফিক্স এবং কর্মক্ষমতা উন্নতি সহ SDK আপডেট করে। এই পৃষ্ঠাটি কীভাবে মোবাইল SDK-তে আপনার নির্ভরতা পরিচালনা করতে হয় তার নির্দেশিকা প্রদান করে।
কোন সংস্করণ লিঙ্ক?
মিশন-সমালোচনামূলক অ্যাপগুলির জন্য , আপনি যে প্রধান সংস্করণটি ব্যবহার করছেন তার সর্বশেষ ডট রিলিজের সাথে লিঙ্ক করুন (X.*), এবং নতুন প্রধান সংস্করণে বার্ষিক আপগ্রেড করুন৷
আপনি সারা বছর ধরে আপনার অ্যাপ্লিকেশনের নতুন সংস্করণ প্রকাশ করার সাথে সাথে আপনি iOS এর জন্য মানচিত্র SDK-এর নতুন ডট সংস্করণগুলি ব্যবহার করা শুরু করতে পারেন৷ এর জন্য আপনার অ্যাপ্লিকেশনে আপডেটের প্রয়োজন হবে না কারণ নতুন ডট সংস্করণগুলি পশ্চাদপদ সামঞ্জস্যপূর্ণ।
সুবিধা:
- আপনি iOS-এর জন্য Maps SDK-এ সমস্যাগুলি আবিষ্কার করলে, মোবাইল সমর্থন নীতি অনুসারে প্রধান সংস্করণের প্রাথমিক প্রকাশের 12 মাসের জন্য একটি পশ্চাদমুখী-সামঞ্জস্যপূর্ণ উপায়ে সমাধানগুলি প্রদান করা হবে৷ সংশোধনগুলি থেকে উপকৃত হওয়ার জন্য আপনাকে অবিলম্বে একটি বেমানান SDK সংস্করণে আপগ্রেড করার প্রয়োজন হবে না৷
- আপনার অ্যাপটি ইতিমধ্যেই সর্বশেষ সংস্করণে নির্মিত হলে সর্বশেষ উন্নতি এবং বৈশিষ্ট্যগুলি গ্রহণ করা সহজ৷
- SDK-এর নতুন প্রধান সংস্করণে বার্ষিক ক্রমবর্ধমান আপডেটগুলি একাধিক প্রধান সংস্করণ রিলিজ জুড়ে প্রবর্তিত পিছনের-অসঙ্গত পরিবর্তনগুলি পরিচালনা করার চেয়ে আপনার অ্যাপ্লিকেশনকে মানিয়ে নিতে, পুনর্লিখন এবং পরীক্ষা করার জন্য কম পরিশ্রমের প্রয়োজন হতে পারে।
অ-সমালোচনামূলক অ্যাপের জন্য , যেকোনো নির্দিষ্ট সংস্করণে লিঙ্ক করুন। আপনি যখন সেই স্থির সংস্করণের জন্য একটি অবমূল্যায়ন বিজ্ঞপ্তি পাবেন, তখন আপনার আপডেট করা অ্যাপ কোডটি আপনার ব্যবহারকারীদের জন্য উপলব্ধ করার জন্য আপনার কাছে 12 মাস সময় থাকবে।
সুবিধা:
- কম ঘন ঘন রক্ষণাবেক্ষণ কাজ.
- আপনার অ্যাপের নতুন সংস্করণগুলি পুরনো মোবাইল অপারেটিং সিস্টেমে চলমান ব্যবহারকারীদের ডিভাইসগুলিকে দীর্ঘ সময়ের জন্য সমর্থন করে (যতক্ষণ না আপনাকে একটি নতুন SDK সংস্করণে আপগ্রেড করতে হবে)।
নিরীক্ষণ করা ইমেল ঠিকানা সহ প্রকল্পের মালিকরা তাদের প্রতিটি প্রকল্পকে প্রভাবিত করে এমন পরিবর্তনগুলি সম্পর্কে সক্রিয় বিজ্ঞপ্তি পান। প্রধান আপডেট, অবচয়, এবং অন্যান্য পরিবর্তন সম্পর্কে অবগত থাকুন ।
ইনস্টলেশন
সুইফট প্যাকেজ ম্যানেজার
iOS এর জন্য Maps SDK সুইফট প্যাকেজ ম্যানেজারের মাধ্যমে ইনস্টল করা যেতে পারে। SDK যোগ করতে, নিশ্চিত করুন যে আপনি iOS নির্ভরতার জন্য বিদ্যমান মানচিত্র SDK মুছে ফেলেছেন।
একটি নতুন বা বিদ্যমান প্রকল্পে SDK যোগ করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- আপনার Xcode
project
বাworkspace
খুলুন, তারপর ফাইল > প্যাকেজ নির্ভরতা যোগ করুন এ যান। - URL হিসেবে https://github.com/googlemaps/ios-maps-sdk লিখুন, প্যাকেজ টানতে এন্টার টিপুন এবং "প্যাকেজ যোগ করুন" এ ক্লিক করুন।
- একটি নির্দিষ্ট
version
ইনস্টল করতে, নির্ভরতা নিয়ম ক্ষেত্রটি সংস্করণ-ভিত্তিক বিকল্পগুলির একটিতে সেট করুন। নতুন প্রকল্পগুলির জন্য, আমরা সর্বশেষ সংস্করণ নির্দিষ্ট করার এবং "সঠিক সংস্করণ" বিকল্পটি ব্যবহার করার পরামর্শ দিই৷ একবার সম্পূর্ণ হলে, "প্যাকেজ যোগ করুন" এ ক্লিক করুন।
একটি বিদ্যমান প্রকল্পের জন্য package
আপডেট করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
আপনি যদি 9.0.0 এর আগে কোনো সংস্করণ থেকে আপগ্রেড করছেন, তাহলে আপনাকে অবশ্যই নিম্নলিখিত নির্ভরতাগুলি সরিয়ে ফেলতে হবে: আপগ্রেড করার পরে
GoogleMapsBase
,GoogleMapsCore
, এবংGoogleMapsM4B
৷GoogleMaps
জন্য নির্ভরতা মুছে ফেলবেন না। আরও তথ্যের জন্য, সংস্করণ 9.0.0 রিলিজ নোট দেখুন।আপনার Xcode প্রকল্প কনফিগারেশন সেটিংস থেকে, ফ্রেমওয়ার্ক, লাইব্রেরি এবং এমবেডেড সামগ্রী খুঁজুন। নিম্নলিখিত কাঠামো অপসারণ করতে বিয়োগ চিহ্ন(-) ব্যবহার করুন:
-
GoogleMapsBase
(শুধুমাত্র 9.0.0 এর আগের সংস্করণ থেকে আপগ্রেডের জন্য) -
GoogleMapsCore
(শুধুমাত্র 9.0.0 এর আগের সংস্করণ থেকে আপগ্রেডের জন্য) -
GoogleMapsM4B
(শুধুমাত্র 9.0.0 এর আগের সংস্করণ থেকে আপগ্রেডের জন্য)
-
- এক্সকোড থেকে, "ফাইল> প্যাকেজ> সর্বশেষ প্যাকেজ সংস্করণে আপডেট" এ যান।
- আপনার ইনস্টলেশন যাচাই করতে, প্যাকেজ এবং এর সংস্করণ যাচাই করতে প্রজেক্ট নেভিগেটরের প্যাকেজ নির্ভরতা বিভাগে যান।
CocoaPods
ব্যবহার করে যোগ করা iOS নির্ভরতাগুলির জন্য বিদ্যমান মানচিত্র SDK সরাতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- আপনার এক্সকোড ওয়ার্কস্পেস বন্ধ করুন। টার্মিনাল খুলুন এবং নিম্নলিখিত কমান্ডটি চালান:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
Podfile
,Podfile.resolved
এবং Xcodeworkspace
সরিয়ে ফেলুন যদি আপনি CocoaPods ছাড়া অন্য কিছুর জন্য ব্যবহার না করেন।
কোকোপডস
আশাবাদী অপারেটর ( ~>
) ব্যবহার না করে সর্বদা আপনার নির্ভরতাগুলিতে একটি সংস্করণ নম্বর নির্দিষ্ট করুন কারণ এটি অপ্রত্যাশিত এবং অপূরণীয় বিল্ডের দিকে নিয়ে যেতে পারে। iOS-এর জন্য মানচিত্র SDK শব্দার্থিক সংস্করণ মেনে চলে এবং নতুন প্রধান সংস্করণ প্রকাশের মধ্যে ব্রেকিং পরিবর্তন অন্তর্ভুক্ত রয়েছে।
পডফাইল সিনট্যাক্স ব্যবহার করে একটি উদাহরণ পডফাইল নির্ভরতা:
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleMaps', '9.2.0' end
রক্ষণাবেক্ষণ এবং আপগ্রেড
সাম্প্রতিক উন্নতিগুলির সাথে তৈরি করতে, নিয়মিত নতুন সংস্করণগুলির জন্য পরীক্ষা করুন এবং আপনার সংস্করণের বৈশিষ্ট্যগুলি আপডেট করুন৷ আপনি যদি একটি নতুন প্রধান সংস্করণে আপডেট করছেন, তাহলে পিছনের-অসঙ্গত পরিবর্তনের জন্য রিলিজ নোটগুলি দেখুন এবং কীভাবে আপনার কোড আপডেট করবেন।
সুইফট প্যাকেজ ম্যানেজার
একটি বিদ্যমান প্রকল্পের জন্য package
আপডেট করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- আপনার ইনস্টলেশন যাচাই করতে, প্যাকেজ এবং এর সংস্করণ যাচাই করতে প্রজেক্ট নেভিগেটরের প্যাকেজ নির্ভরতা বিভাগে যান।
কোকোপডস
একটি টার্মিনাল খুলুন এবং
Podfile
ধারণকারী ডিরেক্টরিতে যান:cd <path-to-project>
- iOS এর জন্য Maps SDK-এর একটি নতুন সংস্করণ উপলব্ধ কিনা তা দেখতে
pod outdated
। - যদি SDK-এর একটি নতুন সংস্করণ পাওয়া যায়, তাহলে এই নতুন সংস্করণের সাথে আপনার
Podfile
আপডেট করুন। কিভাবে আপনারPodfile
এ একটি নির্দিষ্ট সংস্করণ সেট করতে হয় তা জানতে পড সংস্করণ নির্দিষ্ট করা দেখুন। -
pod update
চালান। - আপগ্রেডের ফলে প্রয়োজনীয় কোনো পরিবর্তন করুন। প্রতিটি রিলিজের পরিবর্তনের তালিকার জন্য রিলিজ নোট দেখুন।
- পণ্য > পরিষ্কার এবং তারপর পণ্য > বিল্ড নির্বাচন করে আপনার প্রকল্প পরিষ্কার এবং পুনর্নির্মাণ করুন
ম্যানুয়াল ইনস্টলেশন
SDK ইন্সটল করে সর্বশেষ সোর্স ফাইলের লিঙ্ক পান ।
নতুন সংস্করণগুলির জন্য পোলিং ছাড়াও, Google ক্লাউড প্রকল্পের মালিকরা তাদের প্রকল্পগুলিকে প্রভাবিত করতে পারে এমন অসঙ্গতিপূর্ণ পরিবর্তনগুলি সম্পর্কে ইমেলগুলি পান৷ পিছনের দিকে বেমানান পরিবর্তন সম্পর্কে সক্রিয় বিজ্ঞপ্তি পেতে, আপনার প্রতিটি প্রকল্পের জন্য একটি নিরীক্ষণ করা ইমেল ঠিকানা সহ মালিকের ভূমিকা বরাদ্দ করুন ৷