安裝 Maps SDK for Android 3.1.0 Beta 版

請按照這份指南的指示安裝 Maps SDK for Android 3.1.0 Beta 版；設定完成後，請進一步瞭解如何使用新功能。

安裝 Maps SDK for Android 3.1.0 Beta 版

請按照下列步驟，手動將 Maps SDK for Android 3.1.0 Beta 版用戶端程式庫新增至 Android Studio 專案。

  1. 下載地點介面集靜態資料庫 (如果未使用地點介面集，請略過此步驟)：

  2. 將 AAR 檔案複製到 Android Studio 專案的 app/libs 資料夾中。

    3. 您可透過 Google 的 Maven 存放區存取 Maps SDK for Android 程式庫。如要將 SDK 加入應用程式，請按照下列步驟操作：

  3. 查看頂層 build.gradle 檔案的 buildscript.repositories 區段，確定這裡列出了 Google 的 Maven 存放區：

    buildscript {
    repositories {
        google()
        // ...
    }
}

  4. 在應用程式層級 build.gradle 檔案的 dependencies 區段中新增 Maps SDK for Android，並視情況加入地點介面集靜態資料庫及其必要依附元件：

    dependencies {
  implementation 'com.google.android.libraries.maps:maps:3.1.0-beta'

  // If you are using Places, add all of the dependencies below
  implementation name:'places-maps-sdk-3.1.0-beta', ext:'aar'
  implementation 'com.google.android.gms:play-services-gcm:17.0.0'
  implementation 'com.google.auto.value:auto-value-annotations:1.6.2'
}

  5. 在應用程式層級 build.gradle 檔案的 dependencies 區段中，移除先前版本的實作行 (看起來與以下範例類似)：

    6. implementation 'com.google.android.gms:play-services-maps:17.0.0'

    如果您使用 Google 地圖平台付費方案，則要移除的實作行看起來會像下列其中一行：

    implementation(name:'google-maps-sdk-m4b', ext:'aar')
implementation project(':googlemapssdkm4b_lib')
  6. 同步處理您的 Gradle 專案。

  7. 轉換現有設定。

    • 如果現有的應用程式是透過 Google Play 服務使用 Maps SDK for Android，請將所有 com.google.android.gms.maps 套件的參照改為 com.google.android.libraries.maps 套件 (在 Android Studio 中選取 [Edit] (編輯) > [Replace in Path…] (取代路徑…)。
    • 如果現有的應用程式使用 Google 地圖平台付費方案，請將所有 com.google.android.m4b.maps 套件的參照改成 com.google.android.libraries.maps 套件。此外，從 XML 版面配置屬性的所有參照中移除 m4b_ 前置字元。舉例來說：m4b_mapType 應該會變成 mapType，而 m4b_cameraZoom 會變成 cameraZoom。

  8. 在發布子版本啟用了程式碼縮減和模糊化的情況下，更新 ProGuard 規則以保留 Maps SDK for Android 類別。

    -keep,allowoptimization class com.google.android.libraries.maps.** { *; }

匯入與 Beta 版相容的公用程式庫

如果您使用的是 Google Maps Android API 公用程式庫，請一併更新專案依附元件，好讓與 Beta 版相容的版本能取代現有版本。做法如下：

  1. 在 build.gradle 檔案中匯入與 Beta 版相容的公用程式庫：
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
  2. 將下列內容從 build.gradle 中移除，以移除與 Beta 版不相容的公用程式庫：
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'

執行範例

GitHub 的 Google 範例存放區內含應用程式範例，示範 Maps SDK for Android 3.1.0 Beta 版的用法。