MapplsFeedbackUIKit for iOS¶

Introduction ¶

FeedbackUI Kit for IOS is a UI kit to use wrapper for Mappls's feedback API. It allows developers to integrate feedback module in their application. Using feedback module user can submit location related feedback to Mappls's server.

Note: Sample for UI view controllers with source code is also provided by Mappls which user can directly use to show feedback screen. Information about how to use UI sample is also provided in this documentation.

If you don’t want to implement own logic and use sample from Mappls Jump to Sample UI Kit section.

Version History ¶

Version	Dated	Description
`3.0.0`	10 Feb 2025	- Authentication and authorization mechanisms have been revised.
---	---	---
`2.0.0`	14 Nov, 2024	- UI screen is changed. - URL property for icon is used to show icon for Report Categories.

Installation ¶

To add a package dependency to your Xcode project, select File > Swift Packages > Add Package Dependency and enter its repository URL

  https://github.com/mappls-api/mappls-feedback-uikit-ios-distribution.git

See Adding Package Dependencies to Your App.

Authorization ¶

MapplsAPICore ¶

It is required to set Mappls keys to use any MAPPL's SDK. Please refer the documenatation here

Usage ¶

MapplsFeedbackUIKitManager is the class which will help to use this UI Control.Access shared instance of that class and call getViewController method to get instance of ViewController and present or push according to requirement.

let navVC = MapplsFeedbackUIKitManager.shared.getViewController(location: "78.120,28.2300",appVersion: Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String, osVersionoptional: UIDevice.current.systemVersion, deviceName: UIDevice.current.name, theme: .night)

self.present(navVC, animated: true, completion: nil)

Push Controller¶

let navVC = MapplsFeedbackUIKitManager.shared.getController(location: "78.120,28.2300",appVersion: Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String, osVersionoptional: UIDevice.current.systemVersion, deviceName: UIDevice.current.name, theme: .auto)
        navVC.modalPresentationStyle = .fullScreen
self.navigationController?.pushViewController(navVC, animated: true)

MapplsFeedbackUIKit implicitly uses functionalities of MapplsFeedBackKitManager module and provides a beautiful user expereience to submit feedback.

Theme ¶

Feedback UI also supports different themes. Avaialable options are Day, Night and Auto. In case of Auto it will behave as per system settings.

Below is code to initialize feedback ui with theme:

let navVC = MapplsFeedbackUIKitManager.shared.getViewController(location: CLLocation(latitude: mapView.centerCoordinate.latitude, longitude: mapView.centerCoordinate.longitude), theme: MapplsFeedbackTheme.auto)

Also different colors of Day and Night theme are configurable by accessing shared instance of class DayThemeColors and NightThemeColors respectively. Available properties to set are as below: