TitleColor

描述

ParkPort 是一款利用地理位置信息引导用户探索塔尔萨公园并收集增强现实印章的智能手机应用程序。

在确定 ParkPort 之前，我们的团队齐聚一堂，确定了我们应用程序的目标，并致力于连接塔尔萨的社区！ Rachel Lewis 和 Garrison Shoemake 热爱探索，Stratton Brooks 是国家公园爱好者，而我们的团队飞盘高尔夫球手 Adam Taylor 在从外州来到 Holberton 后，一直在寻找一种探索塔尔萨的方式。Parkport 应运而生，成为了连接塔尔萨人的桥梁，让他们能一次又一次地去往更多公园，我们非常激动地与您分享我们的 ParkPort 之旅。

使用的工具

安装

系统要求

  • 操作系统： Windows 10 或更高版本（64 位），x86-64 为基础。
  • 磁盘空间： 1.64 GB（不包括 IDE/工具的磁盘空间）。
  • 工具： Flutter 依赖于这些工具能在您的环境中可用。
  • 如果已安装 Git for Windows，请确保您可以从命令提示符或 PowerShell 运行 git 命令。

获取 Flutter SDK

  • 下载以下安装包以获取最新稳定版本的 Flutter SDK
    • 有关其他发布频道和旧版本，请参阅 SDK 版本页面。
  • 解压缩 zip 文件，并将包含的 flutter 文件夹放置在 Flutter SDK 的所需安装位置（例如，C:\src\flutter）。

如果您不想安装固定版本的安装包，可以跳过步骤 1 和 2。而是从 GitHub 上的 Flutter 仓库获取源代码，并根据需要更改分支或标签。例如：

C:\src>git clone https://github.com/flutter/flutter.git -b stable

您现在可以在 Flutter 控制台中运行 Flutter 命令了。

更新您的路径

如果您希望在常规 Windows 控制台中运行 Flutter 命令，请执行以下步骤将 Flutter 添加到 PATH 环境变量中。

  • 在“开始”搜索栏中，输入“env”，然后选择“编辑账户的环境变量”。
  • 在“用户变量”下，检查是否有一个名为“Path”的条目。
    • 如果条目存在，请使用 ; 作为分隔符，将 flutter\bin 的完整路径追加到现有值中。
    • 如果条目不存在，请创建一个名为 Path 的新用户变量，并将 flutter\bin 的完整路径作为其值。

您必须关闭并重新打开任何现有的控制台窗口才能使这些更改生效。

运行 flutter doctor

在包含 Flutter 目录的路径的控制台窗口中（见上文），运行以下命令，查看是否需要完成设置的平台依赖项。

C:\src\flutter>flutter doctor

此命令会检查您的环境并显示 Flutter 安装状态的报告。仔细检查输出，了解您可能需要安装的其他软件或要执行的进一步任务（以粗体文本显示）。

例如：[-] Android toolchain – 为 Android 设备开发 • Android SDK 位于 D:\Android\sdk ✗ Android SDK 缺少命令行工具；请从 https://goo.gl/XxQghQ 下载 • 尝试重新安装或更新您的 Android SDK，请访问 https://docs.flutterdart.cn/setup/ 获取详细说明。

以下各节将介绍如何执行这些任务并完成设置过程。一旦安装了任何缺失的依赖项，您就可以再次运行 flutter doctor 命令来验证您是否已正确设置了所有内容。

设置您的 Android 设备

为了准备在 Android 设备上运行和测试您的 Flutter 应用，您需要一台运行 Android 4.1（API 级别 16）或更高版本的 Android 设备。

  1. 在您的设备上启用开发者选项和USB 调试。详细说明可在 Android 文档中找到。
  2. 仅限 Windows：安装 Google USB 驱动程序。
  3. 使用 USB 数据线将手机连接到计算机。如果设备上弹出提示，请授权您的计算机访问您的设备。
  4. 在终端中，运行 flutter devices 命令以验证 Flutter 是否识别您已连接的 Android 设备。默认情况下，Flutter 使用您的 adb 工具所属的 Android SDK 版本。如果您希望 Flutter 使用不同的 Android SDK 安装，则必须将 ANDROID_SDK_ROOT 环境变量设置为该安装目录。

同意 Android 许可

在使用 Flutter 之前，您必须同意 Android SDK 平台许可。此步骤应在安装上述工具后完成。

  1. 请确保您已安装 Java 8 版本，并且您的 JAVA_HOME 环境变量已设置为 JDK 的文件夹。

    Android Studio 2.2 及更高版本附带 JDK，因此此操作应该已完成。

  2. 打开一个管理员权限的控制台窗口，并运行以下命令开始签署许可。

    $ flutter doctor --android-licenses

  3. 在同意之前，请仔细阅读每个许可的条款。

  4. 完成同意许可后，请再次运行 flutter doctor 以确认您已准备好使用 Flutter。

Windows 设置

对于 Windows 桌面开发，除了 Flutter SDK 外，您还需要以下内容：

  • Visual Studio 2022 安装 Visual Studio 时，您需要安装“使用 C++ 的桌面开发”工作负载，用于构建 Windows 应用，包括其所有默认组件。

克隆仓库

在您的终端中运行以下命令：

git clone https://github.com/tayloradam1999/ParkPort.git

更改目录

运行以下命令切换到您的新 ParkPort 目录：

cd .\ParkPort\

安装依赖项

运行以下代码安装 ParkPort 的依赖项：

flutter pub get

构建到您的 Android 设备

将您连接的 Android 设备设置为 VSCode 中要构建的应用平台，然后运行以下命令，即可拥有您自己的 ParkPort 应用程序！

flutter run

功能

通过 Firebase 进行用户身份验证

Login

Geolocation

Geolocation

个人资料页面

Profile

护照页面

Passport

通知

Notifications

好友列表

Friends

排行榜

Leaderboards

公园详情轮播

Park Details

设置页面

Settings

鸣谢

前端工程师：Adam Taylor (LinkedIn)

后端工程师：Rachel Lewis (LinkedIn)

项目经理 + 地图工程师：Garrison Shoemake (LinkedIn)

XR 工程师：Stratton Brooks (LinkedIn)

GitHub

查看 Github