A .mapeosettings
file is a tar file, similar to a zip file. You can see the contents of the file by changing the file extension to .tar
and using any application that can extract tar files.
Before loading your preset configuration file into the phone, use mapeo-settings lint
to test your files to make sure they will compile on the phone.
Run the following command if you are using the default template.
npm test...Presets valid
Now, you are ready to load your settings to Mapeo Mobile.
Rename the .mapeosettings
file to .tar
Then expand .tar file by double clicking to open it
Copy that folder onto the phone
/sdcard/Android/data/com.mapeo/files/presets/default/sdcard/Android/data/com.mapeo.qa/files/presets/default
See https://github.com/digidem/mapeo-mobile#usage for latest published documentation
/sdcard/Android/data/com.mapeo.qa/files/styles/default/sdcard/Android/data/com.mapeo/files/styles/default
Plug in the device to your computer using a USB cable.
Set the mode for USB debugging on the phone to 'Transfer Files'.
In the terminal, typing adb devices
should give you the following output:
$ adb devicesList of devices attachedZY223D4VVS device
Now, you'll need to place the presets folder in the appropriate directory on the Android device using adb push
adb push ./mapeo-settings-myproject-v1.0.0/* /sdcard/Android/data/com.mapeo/files/presets/default
Did it work? Test that the files are available on the device by using the shell.
$ adb shell ls /sdcard/Android/data/com.mapeo/files/presets/default
If it worked correctly, you should see the following output
VERSIONiconsicons.jsonicons.pngicons.svgmetadata.jsonpresets.jsonstyle.csstranslations.json
Mapeo Desktop supports importing .mapeosettings
files in the user interface.
After you've created your settings file, you can import it by navigating to File->Import Configuration....
You can also extract the .mapeosettings
file as a tar file into the following directory:
USERDATA/Mapeo/presets/default
USERDATA is the per-user application data directory, which by default points to:
%APPDATA%
on Windows
$XDG_CONFIG_HOME
or ~/.config on Linux
~/Library/Application Support
on macOS
This folder (default
) expects these files directly in under this default folder (i.e. no sub-folder with a different name):
presets.jsonicons.svgetc...
​