HERE SDK Flutter 参考应用程序
HERE SDK for Flutter (Navigate Edition) 的参考应用程序展示了面向 iOS 和 Android 设备的复杂、已发布项目可能的样子。您可以将其作为您自己的 HERE SDK 项目的灵感来源——部分或全部使用。
概述
通过这个蓝图参考应用程序，您可以了解如何为 HERE SDK 构建用户体验流程——涵盖从搜索 POI、规划和选择路线，到最终开始前往目的地的旅程等主要用例。
- 了解 HERE SDK 4.x 如何通过丰富的 UI 来补充您的应用程序开发。
- 探索如何避免常见陷阱，掌握边缘情况，并从优化的最终用户流程中受益。
- 所有使用 HERE SDK 的代码都使用纯 Dart 实现，遵循成熟的清洁代码标准。
- 此外，参考应用程序还配备了量身定制的图形素材——适用于各种屏幕尺寸，并可用于您自己的项目。
如果您正在寻找较小的代码片段或只想开始将 HERE SDK 集成到更简单的项目中，您可以查看我们的 示例应用程序 选择，其中包括一个精简版的 hello_map_app，该应用程序附带 HERE SDK 的 开发者指南。
此仓库中的参考应用程序侧重于如何在完整的 Flutter 应用程序上下文中实现和使用特定功能——不仅是为了尽可能清晰易懂地展示我们的 API 和 HERE SDK 功能的使用，而且还展示了通用的复杂 Flutter 项目如何以生产质量进行组织和开发。
支持的功能（目前）
开始使用
HERE SDK for Flutter (Navigate Edition) 的参考应用程序需要以下先决条件
- 需要 HERE SDK for Flutter (Navigate Edition), version 4.8.0.0，并且需要从 HERE 平台 下载。目前，Navigate Edition 仅按需提供。请 联系我们 以获得访问权限，包括一套评估凭据。
- 如果尚未完成，请安装 Flutter SDK。我们使用 2.2.3 版本。更新的版本也可能有效，但不保证有效。
此外，您还需要一个您选择的 IDE。这可以是一个文本编辑器，也可以是 IDE，例如带有 Flutter 扩展 的 Visual Studio Code 或 Android Studio。我们使用 Android Studio 4.1.3 进行开发。
注意：如果您想为 iOS 设备编译、构建和运行，您还需要安装 Xcode 和 CocoaPods（1.10.0 或更高版本）。我们使用 Xcode 12.4 进行开发。如果您仅针对 Android 设备，则不需要 Xcode。
添加 HERE SDK 插件
确保您已克隆此仓库，并已下载 HERE SDK for Flutter (Navigate Edition)，请参见上文。
- 解压缩下载的 HERE SDK for Flutter **软件包**。此文件夹包含各种文件，包括各种文档素材。
- 在解压的软件包中，您会找到一个包含 HERE SDK **插件** 的 TAR 文件。
- 解压 TAR 文件，并将文件夹重命名为 'here_sdk'。将其移动到 **plugins** 文件夹内。
构建参考应用程序
-
设置您的 HERE SDK 凭据：参考应用程序不需要硬编码到
AndroidManifest或Plist文件中的凭据。而是从您的本地环境中读取凭据。因此，您需要添加两个 **系统环境变量**，HERESDK_ACCESS_KEY_ID和HERESDK_ACCESS_KEY_SECRET。例如，在 MacOS 终端中执行export HERESDK_ACCESS_KEY_ID="YOUR_ACCESS_KEY_ID"export HERESDK_ACCESS_KEY_SECRET="YOUR_ACCESS_KEY_SECRET"
您可能需要重新启动终端应用程序才能生效。
注意，对于 iOS 构建需要额外的步骤：在存储库的
iOS文件夹中执行 bash 脚本 setup_ios_here_sdk_keys.sh。结果，应在ios/Flutter/GeneratedKeys.xcconfig下创建一个新文件，其中包含您的凭据。 -
转到包含
pubspec.yaml的存储库根文件夹，并运行终端命令flutter pub get来获取所需的依赖项。 -
在您选择的 IDE 中打开项目，并为您的目标平台执行 Flutter 项目。
如何构建 Android 和 iOS 的 Flutter 应用
如果您是 Flutter 新手，这里有一些更详细的步骤。您可能还想首先参考官方 Flutter 网站，特别是 Flutter SDK 文档。
- 为 Android 构建
- 通过执行
flutter build apk来构建 Android APK，或者使用命令flutter run在已连接的设备上构建和运行。
- 通过执行
- 为 iOS 构建
- 在 **ios 文件夹** 中运行
pod install。 - 然后回到存储库根文件夹，输入
flutter build ios来构建 Runner.app。输入flutter run来在已连接的设备上构建和运行。 - 您可以在 Xcode 中打开
/repository root/ios/Runner.xcworkspace项目，并从中执行和调试。 - 注意：您需要拥有有效的 **开发证书** 才能为设备部署签名应用程序。
- 在 **ios 文件夹** 中运行
