আপনার প্রকল্প সেট আপ করুন -- সংস্করণ 4.99 এবং তার আগের

গুরুত্বপূর্ণ: এই নির্দেশিকাটি শুধুমাত্র সেই প্রজেক্টগুলির সাথে সম্পর্কিত যেগুলি Android সংস্করণ 4.99 এবং তার আগের সংস্করণগুলির জন্য নেভিগেশন SDK ব্যবহার করে৷ আপনি যদি আপনার প্রকল্পটি সংস্করণ 5.0 বা তার পরবর্তী সংস্করণে আপডেট করে থাকেন, তবে সাম্প্রতিক প্যাকেজ ইনস্টল, সংস্করণ এবং নির্ভরতার বিবরণের জন্য সেটআপ নির্দেশাবলী অনুসরণ করুন।

এই নির্দেশিকাটি Android এর জন্য নেভিগেশন SDK ব্যবহার করার জন্য বিল্ড কনফিগারেশনের প্রয়োজনীয়তাগুলি তালিকাভুক্ত করে৷ নির্দেশাবলী অনুমান করে যে আপনি একটি Android IDE ইনস্টল করেছেন এবং আপনি Android বিকাশের সাথে পরিচিত৷

সতর্কতা: নেভিগেশন SDK (সংস্করণ 4.0) দিয়ে শুরু করে, API আর Android KitKat বা Lollipop (4.4-5.1) সমর্থন করে না।

নেভিগেশন SDK ব্যবহার করার জন্য ন্যূনতম প্রয়োজনীয়তা

এই প্রয়োজনীয়তাগুলি Android সংস্করণ 4.99 এবং তার আগের ন্যাভিগেশন SDK-তে প্রযোজ্য।

• নেভিগেশন SDK সক্ষম সহ একটি Google ক্লাউড কনসোল প্রকল্প৷ বিধানের জন্য, আপনার Google মানচিত্র প্ল্যাটফর্ম প্রতিনিধিকে জিজ্ঞাসা করুন।

• আপনার অ্যাপকে অবশ্যই API লেভেল 30 বা তার বেশি টার্গেট করতে হবে।

• নেভিগেশন SDK দিয়ে তৈরি একটি অ্যাপ চালানোর জন্য, অ্যান্ড্রয়েড ডিভাইসে অবশ্যই Google Play পরিষেবা ইনস্টল এবং সক্ষম থাকতে হবে।

• অ্যাট্রিবিউশন এবং লাইসেন্সিং টেক্সট অ্যাপে যোগ করতে হবে।

আপনার প্রকল্পগুলি সেট আপ করুন: ক্লাউড কনসোল প্রকল্প এবং অ্যান্ড্রয়েড প্রকল্প৷

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

একটি প্রকল্প সেট আপ করার জন্য আপনার প্রয়োজনীয় তথ্য

• আপনার Google মানচিত্র প্ল্যাটফর্ম প্রতিনিধির নাম।
• আপনার ক্লাউড কনসোল প্রকল্পের একটি নাম।
• আপনার অ্যান্ড্রয়েড অ্যাপ ডেভেলপমেন্ট প্রজেক্টের একটি নাম যার একটি প্যাকেজ নাম রয়েছে যা আপনাকে পরে প্রয়োজন।
• আপনার ডেভেলপমেন্ট মেশিনের জন্য SHA-1 সার্টিফিকেট ফিঙ্গারপ্রিন্ট।

সেট আপ করতে

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

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

নেভিগেশন SDK Maven এর মাধ্যমে বা AAR বান্ডেল হিসাবে উপলব্ধ। আপনি আপনার ডেভেলপমেন্ট প্রজেক্ট তৈরি করার পরে, আপনি নিম্নলিখিত পদ্ধতিগুলির মধ্যে একটি ব্যবহার করে এটিতে SDK সংহত করতে পারেন।

গুরুত্বপূর্ণ: Android এর জন্য নেভিগেশন SDK লিঙ্ক করতে আপনার প্রোজেক্টে Maven নির্ভরতা ব্যবহার করা উচিত। AAR বান্ডেল ডাউনলোড ভবিষ্যতে পাওয়া যাবে না।

নেভিগেশন SDK v4.5 এবং পরবর্তীতে Maven ব্যবহার করা (প্রস্তাবিত)

নিম্নলিখিতগুলি google() Maven সংগ্রহস্থল ব্যবহার করে, যা আপনার প্রকল্পে নেভিগেশন SDK যোগ করার সবচেয়ে সহজ এবং প্রস্তাবিত উপায়

দ্রষ্টব্য: এই পদ্ধতিটি কিছু লাইব্রেরির সাথে সামঞ্জস্যপূর্ণ নয় যা পূর্বের আর্টিফ্যাক্ট আইডির মাধ্যমে নেভিগেশন SDK-এর উপর নির্ভর করে। এর মধ্যে রয়েছে ড্রাইভার SDK v4.4 বা তার আগের রিলিজ।

1. Android এর জন্য নেভিগেশন SDK-এর পছন্দসই সংস্করণের জন্য VERSION_NUMBER স্থানধারক প্রতিস্থাপন করে আপনার Gradle বা Maven কনফিগারেশনে নিম্নলিখিত নির্ভরতা যোগ করুন।

   গ্রেডল

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

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

   যদি মূল Maven সংগ্রহস্থল থেকে আপগ্রেড করা হয়, তাহলে মনে রাখবেন যে গ্রুপ এবং আর্টিফ্যাক্টের নাম পরিবর্তিত হয়েছে এবং com.google.cloud.artifactregistry.gradle-plugin প্লাগইনটির আর প্রয়োজন নেই।

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

   allprojects {
      ...
      // Required: you must exclude the Google Play service Maps SDK from
      // your transitive dependencies. This is to ensure 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>com.google.android.libraries.navigation</groupId>
       <artifactId>navigation</artifactId>
       <version>VERSION_NUMBER</version>
     </dependency>
   </dependencies>
   

   আপনার যদি মানচিত্র SDK ব্যবহার করে এমন কোনো নির্ভরতা থাকে, তাহলে আপনাকে মানচিত্র SDK-এর উপর নির্ভর করে এমন প্রতিটি ঘোষিত নির্ভরতা থেকে নির্ভরতা বাদ দিতে হবে।

   <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>
   

v4.5 এর আগে নেভিগেশন SDK-এর জন্য Maven ব্যবহার করা, অথবা ড্রাইভার SDK-এর সাথে

ন্যাভিগেশন SDK মূল Maven সংগ্রহস্থলের মাধ্যমে বাকি v4 সংস্করণগুলির মাধ্যমে উপলব্ধ হতে চলেছে৷ এটি উপরের সংস্করণের মতো একই আপডেট সহ একই লাইব্রেরি, এবং ট্রানজিশনের সময় ড্রাইভার SDK এবং অন্যান্য লাইব্রেরির সাথে সামঞ্জস্য প্রদান করে৷ এই নির্ভরতা ব্যবহার করার জন্য কম্পাইল করার সময় gcloud মাধ্যমে আপনার ক্লাউড প্রকল্পে লগ ইন করতে হবে।

1. ভোক্তা SDK ডকুমেন্টেশনের পূর্বশর্ত বিভাগে বর্ণিত Google-এর Maven সংগ্রহস্থল অ্যাক্সেস করতে আপনার পরিবেশ সেট আপ করুন। নেভিগেশন SDK-এ অ্যাক্সেস একটি ওয়ার্কস্পেস গ্রুপের মাধ্যমে নিয়ন্ত্রিত হয়।

2. নেভিগেশন SDK-এর পছন্দসই সংস্করণের জন্য VERSION_NUMBER স্থানধারক প্রতিস্থাপন করে আপনার Gradle বা Maven কনফিগারেশনে নিম্নলিখিত নির্ভরতা যোগ করুন।

   গ্রেডল

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

   dependencies {
     ...
     implementation 'com.google.android.maps:navsdk:VERSION_NUMBER'
   }
   

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

   allprojects {
      ...
      // Required: you must exclude the Google Play service Maps SDK from
      // your transitive dependencies. This is to ensure 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>com.google.android.maps</groupId>
       <artifactId>navsdk</artifactId>
       <version>VERSION_NUMBER</version>
     </dependency>
   </dependencies>
   

   আপনার যদি মানচিত্র SDK ব্যবহার করে এমন কোনো নির্ভরতা থাকে, তাহলে আপনাকে মানচিত্র SDK-এর উপর নির্ভর করে এমন প্রতিটি ঘোষিত নির্ভরতা থেকে নির্ভরতা বাদ দিতে হবে।

   <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>
   

ডাউনলোড করা AAR বান্ডেল ব্যবহার করা (প্রস্তাবিত নয়)

নেভিগেশন SDK একটি AAR বান্ডেল হিসাবেও উপলব্ধ। উন্নয়ন প্রকল্প তৈরি করার পরে, আপনি SDK সংহত করতে পারেন। এই নির্দেশাবলী আপনার IDE এর জন্য Android স্টুডিওর ব্যবহার অনুমান করে।

1. শেয়ার্ড Google ড্রাইভ থেকে নেভিগেশন SDK-এর সর্বশেষ সংস্করণটি ডাউনলোড করুন এবং এটি আনজিপ করুন৷ আপনার অ্যাক্সেস না থাকলে, আপনার প্রতিনিধির সাথে যোগাযোগ করুন।

2. অ্যান্ড্রয়েড স্টুডিওতে , একটি প্রজেক্ট খুলুন এবং SDK ম্যানেজার ব্যবহার করে Google Play পরিষেবা প্যাকেজ যোগ করুন ।

3. জিপ ফাইল ডিরেক্টরি থেকে, libs/google_navigation_navmap.aar আপনার প্রজেক্টের app/libs ডিরেক্টরিতে অনুলিপি করুন।

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

   implementation(name: 'google_navigation_navmap', ext: 'aar')
   

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

   allprojects {
       ...
       // Required: you must exclude the Google Play service Maps SDK from
       // your transitive dependencies. This is to ensure 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'
           }
       }
   }
   

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

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

স্থানীয় বৈশিষ্ট্য আপডেট করুন

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

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

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

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

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

  বিল্ড টাইম কমাতে ঐচ্ছিক সেটিংস

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

নীচে অ্যাপ্লিকেশনটির জন্য গ্রেডল বিল্ড স্ক্রিপ্টের একটি উদাহরণ রয়েছে। নির্ভরতাগুলির আপডেট করা সেটগুলির জন্য নমুনা অ্যাপগুলি পরীক্ষা করুন, কারণ আপনি যে ন্যাভিগেশন SDK সংস্করণটি ব্যবহার করছেন তা এই ডকুমেন্টেশনের কিছুটা এগিয়ে বা পিছনে হতে পারে৷

apply plugin: 'com.android.application'
apply plugin: 'com.google.cloud.artifactregistry.gradle-plugin'

ext {
    androidxVersion = "1.0.0"
    lifecycle_version = "1.1.1"
}

android {
    compileSdkVersion 30
    buildToolsVersion '28.0.3'

    defaultConfig {
        applicationId "<your id>"
        // Navigation SDK supports SDK 23 and later.
        minSdkVersion 23
        targetSdkVersion 30
        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 {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

// This tells Gradle where to look to find additional libraries - in this case, the
// google_navigation_navmap.aar file.
repositories {
    flatDir {
        dirs 'libs'
    }
    google()

    // Required for accessing the Navigation SDK on Google's Maven repository.
    maven {
        url "artifactregistry://us-west2-maven.pkg.dev/gmp-artifacts/transportation"
    }
}

dependencies {
    // Include the Google Navigation SDK
    implementation 'com.google.android.maps:navsdk:4.4.0'

    // The included AAR file under libs can be used instead of the Maven repository.
    // Uncomment the line below and comment out the previous dependency to use
    // the AAR file instead. Ensure that you add the AAR file to the libs directory.
    // implementation(name: 'google_navigation_navmap', ext: 'aar')

    // These dependencies are required for the Navigation SDK to function
    // properly at runtime.
    implementation 'org.chromium.net:cronet-fallback:69.3497.100'
    // Optional for Cronet users:
    // implementation 'org.chromium.net:cronet-api:69.3497.100'
    implementation 'androidx.appcompat:appcompat:${androidxVersion}'
    implementation 'androidx.cardview:cardview:${androidxVersion}'
    implementation 'com.google.android.material:material:${androidxVersion}'
    implementation 'androidx.mediarouter:mediarouter:${androidxVersion}'
    implementation 'androidx.preference:preference:${androidxVersion}'
    implementation 'androidx.recyclerview:recyclerview:${androidxVersion}'
    implementation 'androidx.legacy:legacy-support-v4:${androidxVersion}'
    implementation 'com.github.bumptech.glide:glide:4.9.0'
    implementation 'com.github.bumptech.glide:okhttp-integration:4.9.0'
    implementation 'android.arch.lifecycle:common-java8:$lifecycle_version'
    implementation 'com.android.support:multidex:1.0.3'
    implementation 'com.google.android.datatransport:transport-api:2.2.0'
    implementation 'com.google.android.datatransport:transport-backend-cct:2.2.0'
    implementation 'com.google.android.datatransport:transport-runtime:2.2.0'
    implementation 'joda-time:joda-time:2.9.9'
    annotationProcessor 'androidx.annotation:annotation:1.1.0'
    annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
}

আপনার অ্যাপে API কী যোগ করুন

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

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

দ্রষ্টব্য: সর্বশেষ সিস্টেম প্রয়োজনীয়তা এবং ইনস্টলেশন নির্দেশাবলীর জন্য GitHub-এ Android ডকুমেন্টেশনের জন্য সিক্রেটস গ্রেডল প্লাগইন দেখুন।

আপনার Google মানচিত্র প্রকল্পে Android এর জন্য Secrets Gradle Plugin ইনস্টল করতে:

1. অ্যান্ড্রয়েড স্টুডিওতে, আপনার শীর্ষ-স্তরের build.gradle.kts বা 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.kts বা build.gradle ফাইল খুলুন এবং plugins উপাদানে নিম্নলিখিত কোড যোগ করুন।

   কোটলিন

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

   গ্রোভি

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

3. আপনার মডিউল-স্তরের build.gradle.kts বা build.gradle ফাইলে, নিশ্চিত করুন যে targetSdk এবং compileSdk 34-এ সেট করা আছে।
4. ফাইলটি সংরক্ষণ করুন এবং Gradle এর সাথে আপনার প্রকল্প সিঙ্ক করুন ।
5. আপনার শীর্ষ-স্তরের ডিরেক্টরিতে secrets.properties ফাইলটি খুলুন এবং তারপরে নিম্নলিখিত কোডটি যোগ করুন। আপনার API কী দিয়ে YOUR_API_KEY প্রতিস্থাপন করুন। এই ফাইলে আপনার কী সংরক্ষণ করুন কারণ secrets.properties একটি সংস্করণ নিয়ন্ত্রণ সিস্টেমে চেক করা থেকে বাদ দেওয়া হয়েছে৷
   দ্রষ্টব্য: যদি secrets.properties ফাইলটি বিদ্যমান না থাকে, তাহলে local.properties ফাইলের মতো একই ফোল্ডারে এটি তৈরি করুন।

   NAV_API_KEY=YOUR_API_KEY

6. ফাইলটি সংরক্ষণ করুন।

7. আপনার শীর্ষ-স্তরের ডিরেক্টরিতে local.defaults.properties ফাইল তৈরি করুন, secrets.properties ফাইলের মতো একই ফোল্ডার, এবং তারপরে নিম্নলিখিত কোডটি যোগ করুন।

   দ্রষ্টব্য: দেখানো হিসাবে কোড লিখুন. আপনার API কী দিয়ে DEFAULT_API_KEY প্রতিস্থাপন করবেন না।

   NAV_API_KEY=DEFAULT_API_KEY

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

8. ফাইলটি সংরক্ষণ করুন।
9. আপনার AndroidManifest.xml ফাইলে, com.google.android.geo.API_KEY এ যান এবং android:value attribute আপডেট করুন। যদি <meta-data> ট্যাগটি বিদ্যমান না থাকে, তাহলে এটিকে <application> ট্যাগের একটি চাইল্ড হিসেবে তৈরি করুন।

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

   দ্রষ্টব্য: com.google.android.geo.API_KEY হল API কী-এর জন্য প্রস্তাবিত মেটাডেটা নাম। এই নামের একটি কী Android এর জন্য ন্যাভিগেশন SDK সহ Android প্ল্যাটফর্মে একাধিক Google মানচিত্র-ভিত্তিক API-কে প্রমাণীকরণ করতে ব্যবহার করা যেতে পারে। পিছনের সামঞ্জস্যের জন্য, API com.google.android.maps.v2.API_KEY নামটিকেও সমর্থন করে। এই লিগ্যাসি নামটি শুধুমাত্র Android Maps API v2 তে প্রমাণীকরণের অনুমতি দেয়। একটি অ্যাপ্লিকেশন শুধুমাত্র API কী মেটাডেটা নামের একটি নির্দিষ্ট করতে পারে। উভয় নির্দিষ্ট করা থাকলে, API একটি ব্যতিক্রম নিক্ষেপ করে।

10. অ্যান্ড্রয়েড স্টুডিওতে, আপনার মডিউল-স্তরের build.gradle.kts বা build.gradle ফাইল খুলুন এবং secrets সম্পত্তি সম্পাদনা করুন। secrets সম্পত্তি বিদ্যমান না থাকলে, এটি যোগ করুন।

    secrets.properties এ propertiesFileName সেট করতে প্লাগইনের বৈশিষ্ট্যগুলি সম্পাদনা করুন, defaultPropertiesFileName to local.defaults.properties সেট করুন এবং অন্য কোনো বৈশিষ্ট্য সেট করুন।

    কোটলিন

    secrets {
        // To add your Maps API key to this project:
        // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
        // 2. Add this line, where YOUR_API_KEY is your API key:
        //        MAPS_API_KEY=YOUR_API_KEY
        propertiesFileName = "secrets.properties"
    
        // A properties file containing default secret values. This file can be
        // checked in version control.
        defaultPropertiesFileName = "local.defaults.properties"
    
        // Configure which keys should be ignored by the plugin by providing regular expressions.
        // "sdk.dir" is ignored by default.
        ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore"
        ignoreList.add("sdk.*")       // Ignore all keys matching the regexp "sdk.*"
    }
            

    গ্রোভি

    secrets {
        // To add your Maps API key to this project:
        // 1. If the secrets.properties file does not exist, create it in the same folder as the local.properties file.
        // 2. Add this line, where YOUR_API_KEY is your API key:
        //        MAPS_API_KEY=YOUR_API_KEY
        propertiesFileName = "secrets.properties"
    
        // A properties file containing default secret values. This file can be
        // checked in version control.
        defaultPropertiesFileName = "local.defaults.properties"
    
        // Configure which keys should be ignored by the plugin by providing regular expressions.
        // "sdk.dir" is ignored by default.
        ignoreList.add("keyToIgnore") // Ignore the key "keyToIgnore"
        ignoreList.add("sdk.*")       // Ignore all keys matching the regexp "sdk.*"
    }
            

আপনার অ্যাপে প্রয়োজনীয় গুণাবলী অন্তর্ভুক্ত করুন

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

মূল পয়েন্ট: বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করতে, সেগুলিকে একটি স্বাধীন মেনু আইটেম বা একটি সম্পর্কে মেনুতে একটি আইটেম হিসাবে যুক্ত করুন৷

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

• NOTICE.txt
• LICENSES.txt