Skip to main content

OsmAnd development

🚧 This article is incomplete

This article is incomplete & needs to be reviewed. You can help by creating a pull request.

Overview​

The OsmAnd development plugin is designed for developers and experienced users. It allows you to try new features of the app or to configure OsmAnd for testing: simulate navigation routes, check the screen rendering performance, etc. Plugin is not required for daily use of the application.

Setup​

To activate special features for developers and testers:

  1. Enable OsmAnd development plugin in the Plugins section of the Main menu.
  2. Make the necessary settings in the plugin's Settings menu.

Plugin settings​

NOTE

Development plugin settings are global and apply to all profiles.

Plugin development settings can be reached via:

  • Main menu β†’ Plugins β†’ OsmAnd development β†’ Settings or
  • Main menu β†’ Global Settings β†’ Profile β†’ OsmAnd development plugin settings.

Development Settings Android Development Settings 2 Android

NOTE

The options listed below are only available in the Android version of OsmAnd

Pre-beta features​

  • Transparent status bar - The map becomes visible under the status bar.
  • Heightmap option adds the ability to load Heightmaps and Altitude widgets (they display the altitude of the current geolocation or the elevation of the current map center).
note

Heightmaps available for testing only for some regions.

Troubleshotting​

  • Simulate your position - Simulate your position using a recorded GPX track.
  • Rendering debug info - Display the rendering performance.
  • Logcat buffer - Check and share detailed logs of the app.

Application Testing​

  • Simulate first app start - Sets the flag indicating first app startup, keeps all other settings unchanged.
  • Test voice prompts - Select a voice and test by playing announcements.
  • Show free version banner - Display the free version banner even in the paid version.

Internal Algorithms​

  • Safe mode - Run the app in (slower) safe mode.
  • Safe GPX approximation - Perform the GPX approximation using slower Android instead of native code.

Memory settings​

  • Memory allocated for routing option allows you to determine the amount of memory allocated for calculating long routes.
note

Higher memory allocation may impact the performance of other apps.

Widgets​

  • Widgets FPS
  • Widgets Camera position
  • Center screen
  • Zoom number (Android)

GPX-track simulation​

The development plugin provides an opportunity to simulate movement using a GPX track. For these purposes, do the following:

  • Tap on Simulate your position.
  • Select a route simulation speed.
  • Select a GPX track to simulate the location of the device.
note

The location movement speed during the simulation can be equal to the speed in the file (1), or bigger (x2, x3, x4)

Development Settings Android Development Settings Android