mapbox / mapbox/mapbox-navigation-android-examples

Migrate examples from `MapboxNavigationProvider` to `MapboxNavigationApp`

未关闭
#128 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

jira-sync-complete
主要语言
Kotlin
星标
65
派生
56
平均合并
1 天 4 小时
30 天内合并 PR
2

描述

It will be some time before we upgrade the examples repository to com.mapbox.navigation:android:2.8.0-alpha.2.

Opening so we can start considering the migration, but we're still building tools that make migration easier
For example the extensions are still experimental.

  • ShowAlternativeRoutesActivity
  • ShowManeuversActivity
  • MultipleWayPointsActivity
  • ShowTripProgressActivity
  • ShowCameraTransitionsActivity
  • ShowCurrentLocationActivity
  • ShowJunctionsActivity
  • FetchARouteActivity
  • RenderRouteLineActivity
  • TurnByTurnExperienceActivity
  • MapboxSignboardActivity
  • PlayVoiceInstructionsActivity
  • ShowSpeedLimitActivity
  • ReplayHistoryActivity
  • CustomArrivalActivity
  • ShowBuildingExtrusionsActivity

Migration plan

We want to commit to a migration plan for the examples repository by September 5th because that is the week the 2.8.0 release becomes a release candidate and we will be committed to apis for a stable release.

Note that, not-migrating and using MapboxNavigation directly is also an option. MapboxNavigationApp is built for large apps.

Resources

The architecture is designed for you to build de-coupled classes like the LocationComponent, or a more complicated example is the CameraComponent. There are other approaches that are worth considering.

Some public documentation on the MapboxNavigationApp can be found here https://docs.mapbox.com/android/navigation/guides/androidauto/car-app-lifecycle/

We will also explore migration ideas in the qa-test-app

Ideas are welcome

I'm obviously not the only one using this new library, so feel free to bring in some opinions and ideas. Feel free to open a pull request against this migrate-MapboxNavigationApp branch. Or create new pull requests.

cc: @mapbox/navigation-android

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

调研方向

先从迁移计划和列出的示例活动开始,然后查看 MapboxNavigationApp 文档和 qa-test-app,以了解迁移模式。migrate-MapboxNavigationApp 分支和链接的架构资源提供了额外的上下文。完成的标准是:一致地迁移列出的示例,或记录继续直接使用 MapboxNavigation 的决定。

由索引模型根据 Issue 内容生成。

评估

技术栈
kotlin
领域
mobile
Issue 类型
重构
难度
4/5
预计耗时
3-5 天
活跃度
停滞
描述清晰度
需要澄清
新手友好度
25/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。