Automated file import

Why?

Android 11 and above restrict the access to the internal file system and to the application folder. In order to import settings like preferences, vehicle profiles, tours, favorites or addresses, we provide an easy approach.

What?

You can place all your settings into a folder in the root of the file system named "PTV Navigator" (like the app name you see on you Android desktop, including all spaces and case sensitive!). PTV Navigator then imports specific settings from this folder upon startup. The imported files will be deleted after import from the "PTV Navigator" directory.

Depending on the Android version of your smartphone, the user might give permissions manually when importing settings for the first time. On devices with Android 10 and below, usually no permissions are requested. With Android 11 and 12 devices, the user has to click a simple switch from an Android system dialog, which PTV Navigator will show. With Android 13 and above, the user has to select the permission switch of PTV Navigator app from an Android system dialog list, which PTV Navigator will show the first time it will find settings to import.

Settings to import

Preferences

Place a file named "preferences_import.json" into the "PTV Navigator" directory. For a detailed description of the file format, have a look at the "Preferences" chapter.

Tours

You can place your tours either as .json files in the "PTV Navigator/tours" directory or as .bcr files in the "PTV Navigator/bcrs" directory. All tours in .bcr file format will be converted automatically to tours in .json file format, the .bcr files will be deleted after conversion.

Vehicle profiles

Profiles get imported form the "PTV Navigator/profiles" directory. Only profile files with .json suffix will be imported.

Favorites

Place a file containing your favorite destinations named "favorites.json" into the "PTV Navigator" directory.

External app button icon

Place a PNG image for an external app button with the name "extapp_icon.png" in the folder "PTV Navigator" to import it. Also be sure to import an appropriate preferences file with the class and the package name set to the external app that should be called (keynames "external_app_class" and "external_app_package").