Places SDK for Android 版本

请选择平台: Android iOS JavaScript

Google Maps Platform 团队会定期更新 SDK,以加入新功能、修复 bug 并提升性能。本页面介绍如何管理移动 SDK 的依赖项。

  • 对于任务关键型应用,请链接到您所使用的主要版本的最新次要版本 (X.*),并每年升级到新的主要版本。

    如果您全年发布应用的新版本,则可以使用 Places SDK for Android 的较新次要版本。您无需更新应用,因为新的次要版本可向后兼容。

    优势

    • 如果您发现 Places SDK for Android 中存在问题,我们会根据移动设备支持政策在主要版本首次发布后的 12 个月内,以向后兼容的方式进行修复。您无需紧急升级到不兼容的 SDK 版本即可从修复中受益。incompatible
    • 如果您已基于最新版本构建应用,可轻松采用最新的改进和功能。
    • 与处理主要版本的多次发布引入的向后不兼容性更改相比,如果每年对 SDK 的最新主要版本进行增量更新,调整、重写和测试应用所需的工作量会更少。

  • 对于非关键型应用,请链接到任何修复版本。收到该修复版本的弃用通知后,您需要在 12 个月内向用户提供更新后的应用代码。

    优势

    • 降低维护频率。
    • 应用的新版本对搭载旧版移动操作系统的用户设备的支持时间更长(直到您需要升级到新的 SDK 版本时)。

如果 Project Owner 拥有受监管的电子邮件地址,则会在出现对自己的每个项目产生影响的更改时收到系统的主动通知。请及时了解重大更新、弃用和其他更改。

安装

在应用级 build.gradle 文件中,请务必指定版本,而不是前缀范围 (+) 或 latest,否则可能会导致不可预测且不可重复的 build。Places SDK for Android 遵循语义化版本控制,并且新的主要版本可能包含破坏性更改。支持的最低 API 级别为 21。

dependencies {
    // If updating kotlin-bom version number above, also edit project-level build.gradle definition of $kotlin_version variable
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
    implementation 'com.google.android.libraries.places:places:3.3.0'
}

维护和升级

Android Studio 会自动检查是否有更新的版本,并在有更新版本的依赖项时发出警告。为了尽可能减少技术债务,请尽快更新到最新版本。如果您要更新到新的主要版本,请查看版本说明,了解向后不兼容性更改以及代码更新方法。

除了可以轮询更新的版本之外,Google Cloud 项目所有者还会收到电子邮件,通过邮件得知可能会影响其项目的向后不兼容性更改。如需获取有关向后不兼容性更改的主动通知,请为您的每个项目分配所有者角色,并提供受监管的电子邮件地址。

如果您要从 Places SDK for Android 3.2.0 或更低版本升级

迁移到新 SDK 时无需进行迁移。您只需执行以下操作:

  1. 对应用中使用的 API 密钥启用 Places API(新)。如需了解详情,请参阅使用 API 密钥
  2. 在模块级 build.gradle 文件的 dependencies 部分中,更新 places 依赖项并添加 kotlin-bom 依赖项:

      dependencies {
          implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
          implementation 'com.google.android.libraries.places:places:3.3.0'
      }

    如需详细了解 kotlin-bom 依赖项,请参阅在传递依赖项中使用最新的 kotlin-stdlib 版本

  3. 更新现有应用,调用新的 Places.initializeWithNewPlacesApiEnabled() 方法来初始化您的应用。如需了解详情,请参阅初始化 Places API 客户端

现有应用仍可继续使用,但您现在可以充分利用所有新的 SDK 功能。