আপনার অ্যান্ড্রয়েড স্টুডিও প্রকল্প সেট আপ করুন

এই পৃষ্ঠায় ব্যাখ্যা করা হয়েছে কীভাবে আপনার ডেভেলপমেন্ট প্রোজেক্টে নেভিগেশন এসডিকে (Navigation SDK) ইন্টিগ্রেট করবেন।

আপনার প্রজেক্টে নেভিগেশন SDK যোগ করুন

ন্যাভিগেশন এসডিকে-টি গুগল ম্যাভেন রিপোজিটরি- তে পাওয়া যায়। আপনি আপনার গ্রেডল build.gradle অথবা ম্যাভেন pom.xml কনফিগারেশন ব্যবহার করে এসডিকে-টি আপনার প্রোজেক্টে যোগ করতে পারেন।

1. আপনার Gradle বা Maven কনফিগারেশনে নিম্নলিখিত ডিপেন্ডেন্সিটি যোগ করুন, যেখানে VERSION_NUMBER প্লেসহোল্ডারটির পরিবর্তে Android-এর জন্য Navigation SDK-এর কাঙ্ক্ষিত সংস্করণটি বসান।

   গ্রেডল

   আপনার মডিউল-স্তরের build.gradle ফাইলে নিম্নলিখিতটি যোগ করুন:

   dependencies {
           ...
           implementation 'com.google.android.libraries.navigation:navigation:VERSION_NUMBER'
   }
   

   ম্যাভেন

   আপনার pom.xml এ নিম্নলিখিতটি যোগ করুন:

   <dependencies>
     ...
     <dependency>
       <groupId>com.google.android.libraries.navigation</groupId>
       <artifactId>navigation</artifactId>
       <version>VERSION_NUMBER</version>
     </dependency>
   </dependencies>
   

2. আপনার যদি এমন কোনো ডিপেন্ডেন্সি থাকে যা ম্যাপস এসডিকে (Maps SDK) ব্যবহার করে, তাহলে ম্যাপস এসডিকে-র উপর নির্ভরশীল প্রতিটি ঘোষিত ডিপেন্ডেন্সি থেকে সেই ডিপেন্ডেন্সিটিকে বাদ দিতে হবে।

   গ্রেডল

   আপনার শীর্ষ-স্তরের build.gradle ফাইলে নিম্নলিখিতটি যোগ করুন:

   allprojects {
           ...
           // Required: you must exclude the Google Play service Maps SDK from
           // your transitive dependencies to make sure there won't be
           // multiple copies of Google Maps SDK in your binary, as the Navigation
           // SDK already bundles the Google Maps SDK.
           configurations {
               implementation {
                   exclude group: 'com.google.android.gms', module: 'play-services-maps'
               }
           }
   }
   

   ম্যাভেন

   আপনার pom.xml এ নিম্নলিখিতটি যোগ করুন:

   <dependencies>
     <dependency>
     <groupId>project.that.brings.in.maps</groupId>
     <artifactId>MapsConsumer</artifactId>
     <version>1.0</version>
       <exclusions>
         <!-- Navigation SDK already bundles Maps SDK. You must exclude it to prevent duplication-->
         <exclusion>  <!-- declare the exclusion here -->
           <groupId>com.google.android.gms</groupId>
           <artifactId>play-services-maps</artifactId>
         </exclusion>
       </exclusions>
     </dependency>
   </dependencies>
   

বিল্ডটি কনফিগার করুন

প্রজেক্টটি তৈরি করার পরে, আপনি নেভিগেশন এসডিকে-এর সফল বিল্ড ও ব্যবহারের জন্য সেটিংস কনফিগার করতে পারেন।

স্থানীয় সম্পত্তি আপডেট করুন

• Gradle Scripts ফোল্ডারে , local.properties ফাইলটি খুলুন এবং android.useDeprecatedNdk=true যোগ করুন।

গ্রেডল বিল্ড স্ক্রিপ্ট আপডেট করুন

• build.gradle (Module:app) ফাইলটি খুলুন এবং নেভিগেশন SDK-এর প্রয়োজনীয়তা পূরণের জন্য নিম্নলিখিত নির্দেশিকা ব্যবহার করে সেটিংস আপডেট করুন, সেইসাথে অপটিমাইজেশন অপশনগুলোও সেট করার কথা বিবেচনা করুন।

  নেভিগেশন এসডিকে-এর জন্য প্রয়োজনীয় সেটিংস

  1. minSdkVersion ২৪ বা তার বেশি সেট করুন।
  2. targetSdkVersion কে ৩৬ বা তার বেশি সেট করুন।
  3. একটি dexOptions সেটিং যোগ করুন যা javaMaxHeapSize বৃদ্ধি করে।
  4. অতিরিক্ত লাইব্রেরিগুলোর জন্য অবস্থান নির্ধারণ করুন।
  5. নেভিগেশন এসডিকে-এর জন্য repositories এবং dependencies যোগ করুন।
  6. ডিপেন্ডেন্সিগুলোতে থাকা ভার্সন নম্বরগুলো সর্বশেষ উপলব্ধ ভার্সন দিয়ে প্রতিস্থাপন করুন।

  বিল্ড টাইম কমানোর জন্য ঐচ্ছিক সেটিংস

  • ডিপেন্ডেন্সি থেকে অব্যবহৃত কোড এবং রিসোর্স অপসারণ করতে R8/ProGuard ব্যবহার করে কোড সঙ্কুচিতকরণ এবং রিসোর্স সঙ্কুচিতকরণ সক্ষম করুন। যদি R8/ProGuard ধাপটি চলতে খুব বেশি সময় নেয়, তবে ডেভেলপমেন্টের কাজের জন্য মাল্টিডেক্স সক্ষম করার কথা বিবেচনা করুন।
  • বিল্ডে অন্তর্ভুক্ত ভাষা অনুবাদের সংখ্যা কমান: ডেভেলপমেন্টের সময় একটি ভাষার জন্য resConfigs সেট করুন। চূড়ান্ত বিল্ডের জন্য, আপনি প্রকৃতপক্ষে যে ভাষাগুলো ব্যবহার করেন সেগুলোর জন্য resConfigs সেট করুন। ডিফল্টরূপে, Gradle নেভিগেশন SDK দ্বারা সমর্থিত সমস্ত ভাষার জন্য রিসোর্স স্ট্রিং অন্তর্ভুক্ত করে।

  জাভা৮ সমর্থনের জন্য ডিসুগারিং যোগ করুন

  • আপনি যদি অ্যান্ড্রয়েড গ্রেডল প্লাগইন ৪.০.০ বা তার উচ্চতর সংস্করণ ব্যবহার করে আপনার অ্যাপ তৈরি করেন, তবে প্লাগইনটি বেশ কিছু জাভা ৮ ল্যাঙ্গুয়েজ এপিআই ব্যবহারের জন্য সমর্থন প্রসারিত করে। আরও তথ্যের জন্য জাভা ৮ ডিসুগারিং সাপোর্ট দেখুন। কম্পাইল এবং ডিপেন্ডেন্সি অপশনগুলো কীভাবে ব্যবহার করবেন তা জানতে নিচের উদাহরণ বিল্ড স্ক্রিপ্ট স্নিপেটটি দেখুন।
  • অ্যান্ড্রয়েড সংস্করণ ৭.৩.০ এবং তার উচ্চতর সংস্করণের জন্য, আপনাকে অবশ্যই গ্রেডল ৮.১১.১, অ্যান্ড্রয়েড গ্রেডল প্লাগইন সংস্করণ ৮.১০.০, এবং ডিসুগার লাইব্রেরি com.android.tools:desugar_jdk_libs_nio:2.0.3 ব্যবহার করতে হবে।
  • app মডিউল এবং নেভিগেশন এসডিকে-র উপর সরাসরি নির্ভরশীল যেকোনো মডিউলের জন্য ডিসুগার লাইব্রেরিটি সক্রিয় করতে হবে।

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

apply plugin: 'com.android.application'

ext {
    navSdk = "__NAVSDK_VERSION__"
}

android {
    compileSdk 33
    buildToolsVersion='28.0.3'

    defaultConfig {
        applicationId "<your id>"
        // Navigation SDK supports SDK 23 and later.
        minSdkVersion 23
        targetSdkVersion 34
        versionCode 1
        versionName "1.0"
        // Set this to the languages you actually use, otherwise you'll include resource strings
        // for all languages supported by the Navigation SDK.
        resConfigs "en"
        multiDexEnabled true
    }

    dexOptions {
        // This increases the amount of memory available to the dexer. This is required to build
        // apps using the Navigation SDK.
        javaMaxHeapSize "4g"
    }
    buildTypes {
        // Run ProGuard. Note that the Navigation SDK includes its own ProGuard configuration.
        // The configuration is included transitively by depending on the Navigation SDK.
        // If the ProGuard step takes too long, consider enabling multidex for development work
        // instead.
        all {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
    compileOptions {
        // Flag to enable support for the new language APIs
        coreLibraryDesugaringEnabled true
        // Sets Java compatibility to Java 8
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

repositories {
    // Navigation SDK for Android and other libraries are hosted on Google's Maven repository.
    google()
}

dependencies {
    // Include the Google Navigation SDK.
    // Note: remember to exclude Google Play service Maps SDK from your transitive
    // dependencies to avoid duplicate copies of the Google Maps SDK.
    api "com.google.android.libraries.navigation:navigation:${navSdk}"

    // Declare other dependencies for your app here.

    annotationProcessor "androidx.annotation:annotation:1.7.0"
    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs_nio:2.0.3'
}

আপনার অ্যাপে এপিআই কী যোগ করুন

এই বিভাগে বর্ণনা করা হয়েছে কীভাবে আপনার API কী সংরক্ষণ করবেন, যাতে আপনার অ্যাপ এটিকে নিরাপদে ব্যবহার করতে পারে। আপনার API কী ভার্সন কন্ট্রোল সিস্টেমে চেক ইন করা উচিত নয়, তাই আমরা এটিকে secrets.properties ফাইলে সংরক্ষণ করার পরামর্শ দিই, যা আপনার প্রোজেক্টের রুট ডিরেক্টরিতে অবস্থিত। secrets.properties ফাইল সম্পর্কে আরও তথ্যের জন্য, Gradle properties files দেখুন।

এই কাজটি সহজ করার জন্য, আমরা আপনাকে অ্যান্ড্রয়েডের জন্য সিক্রেটস গ্রেডল প্লাগইন ব্যবহার করার পরামর্শ দিই।

অ্যান্ড্রয়েডের জন্য সিক্রেটস গ্রেডল প্লাগইন ইনস্টল করতে এবং আপনার এপিআই কী সংরক্ষণ করতে:

1. অ্যান্ড্রয়েড স্টুডিওতে, আপনার রুট-লেভেলের build.gradle ফাইলটি খুলুন এবং buildscript অধীনে dependencies এলিমেন্টে নিম্নলিখিত কোডটি যোগ করুন।

   গ্রুভি

   buildscript {
       dependencies {
           // ...
           classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1"
       }
   }

   কোটলিন

   buildscript {
       dependencies {
           // ...
           classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.1")
       }
   }

2. আপনার অ্যাপ-লেভেলের build.gradle ফাইলটি খুলুন এবং plugins এলিমেন্টে নিম্নলিখিত কোডটি যোগ করুন।

   গ্রুভি

   plugins {
       id 'com.android.application'
       // ...
       id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
   }

   কোটলিন

   plugins {
       id("com.android.application")
       // ...
       id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
   }

3. আপনি যদি অ্যান্ড্রয়েড স্টুডিও ব্যবহার করেন, তাহলে আপনার প্রজেক্টটি গ্রেডলের সাথে সিঙ্ক করুন ।
4. আপনার প্রজেক্ট লেভেল ডিরেক্টরিতে থাকা local.properties ফাইলটি খুলুন এবং নিচের কোডটি যোগ করুন। YOUR_API_KEY এর জায়গায় আপনার API কী বসান।

   MAPS_API_KEY=YOUR_API_KEY

5. আপনি আপনার AndroidManifest.xml ফাইলে API কী যোগ করতে পারেন অথবা প্রোগ্রাম্যাটিকভাবে API কী প্রদান করতে পারেন।
   • আপনার API কী AndroidManifest.xml এ যোগ করুন:

     <meta-data
         android:name="com.google.android.geo.API_KEY"
         android:value="${MAPS_API_KEY}" />
             

     দ্রষ্টব্য: এপিআই কী-এর জন্য com.google.android.geo.API_KEY হলো প্রস্তাবিত মেটাডেটা নাম। এই নামের একটি কী অ্যান্ড্রয়েড প্ল্যাটফর্মে একাধিক গুগল ম্যাপস-ভিত্তিক এপিআই-তে প্রমাণীকরণের জন্য ব্যবহার করা যেতে পারে, যার মধ্যে অ্যান্ড্রয়েডের জন্য নেভিগেশন এসডিকে অন্তর্ভুক্ত। পূর্ববর্তী সংস্করণের সাথে সামঞ্জস্যের জন্য, এপিআইটি com.google.android.maps.v2.API_KEY নামটি সমর্থন করে। এই পুরোনো নামটি শুধুমাত্র অ্যান্ড্রয়েড ম্যাপস এপিআই v2-তে প্রমাণীকরণের অনুমতি দেয়। একটি অ্যাপ্লিকেশন এপিআই কী মেটাডেটা নামগুলোর মধ্যে শুধুমাত্র একটি নির্দিষ্ট করতে পারে। যদি উভয়ই নির্দিষ্ট করা হয়, তাহলে এপিআই একটি ব্যতিক্রমী ত্রুটি (exception) দেখায়।

   • প্রোগ্রামের মাধ্যমে এপিআই কী প্রদান করুন:

     Secrets Gradle Plugin-টি BuildConfig ক্লাসে কী-টি উপলব্ধ করে। আপনার অ্যাপের ইনিশিয়ালাইজেশনের সময় (উদাহরণস্বরূপ, আপনার Application.onCreate() মেথডে), নিম্নলিখিতভাবে মেথডটি কল করুন:

     কোটলিন

     1. নিম্নলিখিত ইম্পোর্ট স্টেটমেন্টগুলো যোগ করুন:

        import com.google.android.libraries.navigation.NavigationApi

     2. আপনার Application.onCreate() মেথডে নিম্নলিখিতটি যোগ করুন:

        NavigationApi.setApiKey(BuildConfig.MAPS_API_KEY)

     জাভা

     1. নিম্নলিখিত ইম্পোর্ট স্টেটমেন্টগুলো যোগ করুন:

        import com.google.android.libraries.navigation.NavigationApi;

     2. আপনার Application.onCreate() মেথডে নিম্নলিখিতটি যোগ করুন:

        NavigationApi.setApiKey(BuildConfig.MAPS_API_KEY);

     দ্রষ্টব্য: setApiKey() ব্যবহার করার সময় নিম্নলিখিত বিষয়গুলো মনে রাখবেন:

     • একটি নন-নাল ও নন-এম্পটি এপিআই কী প্রদান করুন।
     • আপনার অ্যাপ্লিকেশনের জীবনকালে setApiKey() শুধুমাত্র একবার কল করুন। একাধিকবার কল করা হলে পদ্ধতিটি একটি IllegalStateException থ্রো করে।
     • Navigator মতো অন্য যেকোনো নেভিগেশন SDK কম্পোনেন্ট ইনিশিয়ালাইজ করার আগে setApiKey() কল করুন।
     • এই মেথডের সাথে আপনি যে কী প্রদান করেন, তা আপনার AndroidManifest.xml এ থাকা যেকোনো API কী-কে ওভাররাইড করে।
     • নেভিগেশন এসডিকে সংস্করণ ৭.৬ বা তার উচ্চতর সংস্করণ ব্যবহার করুন।

আপনার অ্যাপে প্রয়োজনীয় অ্যাট্রিবিউশন অন্তর্ভুক্ত করুন।

আপনি যদি আপনার অ্যাপে অ্যান্ড্রয়েডের জন্য নেভিগেশন এসডিকে ব্যবহার করেন, তাহলে আপনাকে অবশ্যই আপনার অ্যাপের আইনি বিজ্ঞপ্তি বিভাগের অংশ হিসেবে অ্যাট্রিবিউশন টেক্সট এবং ওপেন সোর্স লাইসেন্স অন্তর্ভুক্ত করতে হবে।

আপনি Navigation SDK for Android zip ফাইলটিতে প্রয়োজনীয় অ্যাট্রিবিউশন টেক্সট এবং ওপেন সোর্স লাইসেন্সগুলো খুঁজে পাবেন:

• NOTICE.txt
• LICENSES.txt