Android WYF migration guide

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.

Note! As a reminder of what you might have used / configured, you may visit the old WYF quickstart code example.

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!

Subscribe to our newsletter


Data controller: SITUM TECHNOLOGIES, S.L.
Contact: Data controller:
Responsible for protection:
Purpose and legal basis: To manage the sending of SITUM newsletters only with consent.
Legitimation: Express consent of the interested party.
Recipients: The data will not be passed on to third parties with the exception of legal obligations.
Retention period: As long as the interested party remains subscribed to the newsletter (a link to unsubscribe will be available in each newsletter sent by Situm).
Rights: The interested party may at any time revoke their consent, as well as exercise their rights of opposition, access, conservation, rectification, limitation, deletion of data and not be subject to a decision based only on automated data processing, by writing to SITUM at the addresses indicated.
Additional Information: You can consult additional and detailed information on Data Protection in our privacy policy.

Please, download your copy here

Thank you for downloading our whitepaper. Please do not hesitate to contact us if you would like to know more about how our solutions can help your business. Download whitepaper

Close window