We have introduced a new WYF module that uses the MapView. This enhancement brings numerous advantages, such as providing a consistent user experience across multiple platforms and also improved usability.
It is important to mention that certain functionalities previously available may not be present in this new version. Rest assured, we are actively working on further development and enhancements for the module.
In order to use the new module, certain changes are required.
Remove the old library #
First of all, remove the old Situm WYF import:
// build.gradle of your app
...
dependencies {
//And remove this
implementation ('es.situm:situm-wayfinding:X.Y.Z-alpha@aar') {
transitive = true
}
}
Remove unnecessary settings #
There are some settings that you will need to remove:
- Extending Theme.AppCompat.Light is not needed now. You can use any theme that you want.
- Google Maps has been replaced by Mapbox. You no longer need to provide a Google Maps API Key as it was stated here: please remove it from your AndroidManifest.xml.
- Remove the imports that start with es.situm.wayfinding and all the use of those classes.
- Configuring the themes.xml file in order to make the Search Bar work is no longer needed. Remove this configuration.
Remove old imports and class usages #
Now, you’re ready to remove all usages of the old Situm WYF library.
First, remove the imports that start with es.situm.wayfinding. At this point, Android Studio will complain about all the classes that can no longer be found: remove all their usages as well. Some of these classes are SitumMapsLibrary, LibrarySettings, etc.
Finally, remove from your layouts/activity_main.xml (or similar file) all views that you created for the old Situm WYF.
Use the new Situm WYF #
We have written a complete example on how to build your first application using the new Situm WYF module. Make sure you follow it!
