mapbox / mapbox/mapbox-navigation-android-examples

Migrate examples from `MapboxNavigationProvider` to `MapboxNavigationApp`

Đang mở
#128 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

jira-sync-complete
Ngôn ngữ chính
Kotlin
Star
65
Fork
56
Merge trung bình
1 ngày 4 giờ
Pull request đã merge (30 ngày)
2

Mô tả

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](https://github.com/mapbox/mapbox-navigation-android/blob/main/libnavigation-core/src/main/java/com/mapbox/navigation/core/internal/extensions/MapboxLifecycleExtensions.kt) 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](https://github.com/mapbox/mapbox-navigation-android/blob/d8d04fe75e53063f5e185c3779c04c7b0914f77d/libnavui-dropin/src/main/java/com/mapbox/navigation/dropin/component/location/LocationComponent.kt#L15-L39), or a more complicated example is the [CameraComponent](https://github.com/mapbox/mapbox-navigation-android/blob/d8d04fe75e53063f5e185c3779c04c7b0914f77d/libnavui-dropin/src/main/java/com/mapbox/navigation/dropin/component/camera/CameraComponent.kt#L32-L242). 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](https://github.com/mapbox/mapbox-navigation-android/tree/main/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](https://github.com/mapbox/mapbox-navigation-android-examples/pull/129) branch. Or create new pull requests.

cc: @mapbox/navigation-android

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Hướng nghiên cứu

Bắt đầu với kế hoạch di chuyển và các hoạt động ví dụ được liệt kê, sau đó xem lại tài liệu của MapboxNavigationApp và qa-test-app để tìm các mẫu di chuyển. Nhánh migrate-MapboxNavigationApp và các tài nguyên kiến trúc được liên kết cung cấp thêm ngữ cảnh. Được xem là hoàn tất khi либо đã di chuyển nhất quán các ví dụ được liệt kê, hoặc đã ghi lại quyết định tiếp tục sử dụng trực tiếp MapboxNavigation.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
kotlin
Lĩnh vực
mobile
Loại issue
Tái cấu trúc
Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức độ hoạt động
Đình trệ
Độ rõ ràng
Cần làm rõ
Mức phù hợp với người mới
25/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.