今天來完成在 Android 專案的 API 金鑰設置 GOGO~~

實作的官方文件 :

• 設定 Android Studio 專案

設定 SDK - 加入 Google Service Library

• gradle(Module 層級)

  加入引用 :

  dependencies {
  
      implementation 'com.google.android.gms:play-services-maps:18.1.0'
      // ...
  }
  

  確認 compileSdk 和 minSdk 設為下列值:

  android {
  
      compileSdk 31
  
      defaultConfig {
          minSdk 19
          // ...
      }
  

將 API 金鑰加進專案

官方文件建議鑰將金鑰儲存在位於專案根目錄的 local.properties 檔案內，為了簡化設定，官方還推薦使用 https://github.com/google/secrets-gradle-plugin 工具，我們也照著文件做吧 :

• build.gradle(Project 層級)

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

• build.gradle(Module 層級)

  id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
  

• 在專案層級目錄中開啟 local.properties 並新增下列程式碼，然後將 YOUR_API_KEY 替換成我們前面的 API 金鑰 :

  MAPS_API_KEY=YOUR_API_KEY
  

• 在 AndroidManifest.xml 檔案加入以下程式碼 :

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

  注意，android:name="com.google.android.geo.API_KEY" 這個是固定的，隨意定義會拋出錯誤。
  *KEY 如果設定錯誤，地圖是會跑不出來的，已經替大家踩過拉~~

設定存取權限

接著到 AndroidManifest.xml 設定使位置存取權限，可用的權限有兩種 :

<!-- 精確 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

<!-- 較不精確 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>

挖~~~到這邊前置作業就差不多拉，前置作業真低多，明天就來在專案內新增地圖吧 !

今日推推