Mapeo Support Materials
Español
Español
  • Introducción
  • Visión general
    • Acerca de Mapeo
      • Herramientas de Mapeo
      • Base de datos de pares y sincronización de Mapeo
      • ¿Cómo se está usando Mapeo?
    • ¿Mapeo es adecuado para mí?
    • FAQs
  • Guía de inicio rápido
    • Empezando...
    • Mapeo Mobile
    • Mapeo Desktop
  • Guía de referencia completa
    • Bienvenid@ – Introducción
    • 🗒️Elementos esenciales para un proyecto de Mapeo exitoso
      • Planeando un proyecto de Mapeo
        • Cuál es el objetivo del proyecto?
        • Qué resultados (productos/materiales) quieres?
        • Qué información recolectar?
          • Tipos de datos dentro de Mapeo
        • Quién debe participar y cómo?
        • Cuáles son los parámetros?
      • Evaluación de riesgos y seguridad
      • Creando protocolos de usuario
    • ✔️Mapeo funcionará de inmediato para mí?
      • Configuración por defecto
      • Mapa de fondo por defecto
    • ⚙️Opciones de personalización
      • Traducir Mapeo y configuraciones predeterminadas
      • Configuraciones personalizadas
        • Creando configuraciones personalizadas
          • Planeando la configuración y la estructura de datos
            • Categorías
            • Iconos
            • Campos de detalles
          • Codificar la configuración
            • Adding icon files
              • Crear y exportar archivos SVG usando Adobe Illustrator
              • Crear y exportar archivos SVG usando Inkscape
            • Creating details fields
            • Creating categories
            • Defining geometry defaults
            • Adding a project key
            • Adding project name and version
            • Building configuration file
              • Via the command line
              • Using GitHub Actions
          • Probando e iterando
      • Mapas de fondo personalizados
        • Creando mapas de fondo personalizados
    • 📱Mapeo Mobile: instalación y ajustes
      • Instalar Mapeo Mobile
      • Elegir los ajustes de Mapeo Mobile
      • Importar configuraciones a Mapeo Mobile
      • Añadir mapas de fondo personalizados a Mapeo Mobile
      • Actualizar Mapeo Mobile
    • 📱Mapeo Mobile: uso
      • Activar el GPS y ver la posición actual
      • Crear observaciones
      • Ver observaciones
      • Editar y borrar observaciones
      • Compartir datos externamente
      • Sincronizar datos a través Wi-Fi
    • 💻Mapeo Desktop: instalación y ajustes
      • Instalar Mapeo Desktop
      • Escoger el idioma de Mapeo Desktop
      • Importar configuraciones a Mapeo Desktop
      • Añadir mapas de fondo personalizados a Mapeo Desktop
      • Actualizar Mapeo Desktop
    • 💻Mapeo Desktop: uso
      • Mapeo Desktop para gestionar datos de Mapeo Mobile (modo Observaciones)
        • Sincronizar datos
          • Sincronizar a través de Wi-Fi
          • Sincronizar con un archivo
        • Ver observaciones
        • Editar y borrar observaciones
        • Exportar datos y compartir externamente
      • Mapeo Desktop para la creación de datos territoriales (modo Territorio)
        • Navegar por el mapa
        • Crear y editar datos territoriales
        • Cambiar mapas de fondo en el modo Territorio
        • Importar y usar datos geoespaciales externos
        • Exportar y sincronizar datos
      • Sincronizar datos con Mapeo Desktop
    • 💡Capacitaciones en Mapeo
      • Definir objetivos y formato
      • Estructurar una capacitación
        • Buenas prácticas para planificar una capacitación
        • Estructuración de la agenda, contenidos y actividades
          • Sugerencias para las diferentes secciones de un evento de capacitación
          • Consejos y actividades sugeridas para capacitar en las funciones clave de Mapeo
          • Materiales y recursos disponibles para el evento de capacitación
      • Preparación de equipos y suministros para una capacitación
        • Equipos y suministros recomendados
        • Preparación técnica antes de realizar la formación presencial
    • 🔧Solución de problemas
      • No puedo iniciar Mapeo
      • Mapeo se cierra automáticamente
      • Tengo problemas con el GPS en Mapeo
        • No se activa el GPS en Mapeo
        • Mi señal de GPS es muy débil
      • Tengo problemas con la cámara en Mapeo
        • Me aparece una pantalla negra cuando uso la cámara
      • Quiero actualizar los permisos de Mapeo Mobile
      • Tengo problemas de sincronización
        • Quiero conectarme a una red Wi-Fi
        • Quiero crear redes Wi-Fi locales
          • Con un router portátil
          • Con un celular
        • El dispositivo con el que quiero sincronizar no aparece en mi pantalla Sincronizar
        • Me aparece un error cuando intento sincronizar con otro dispositivo
        • No puedo sincronizar con el archivo de sincronización
        • La persona con la que quiero sincronizar ha eliminado datos valiosos
      • Quiero compartir archivos entre dispositivos
      • Quiero guardar e imprimir materiales de referencia de Mapeo
    • Glosario y hojas de referencia rápida
      • Glosario de términos relacionados con Mapeo
      • Descripción general de la pantalla del modo Territorio de Mapeo Desktop
  • Para desarrolladores
    • La arquitectura de Mapeo
    • Repositorios de Mapeo
  • Apoyo
  • Referencias adicionales
  • Digital Democracy website
Powered by GitBook
On this page
  • Prepare computer for building the configuration
  • Install nvm
  • Install homebrew (macOS)
  • Install npm
  • Install and use node 12
  • Install Mapeo Settings Builder
  • Is your computer ready?
  • Package Config Assets for MAPEO
  • Prep folder and build
  • What is a .mapeosettings file?
  • Troubleshooting Checklist
  • Versioning
Export as PDF
  1. Guía de referencia completa
  2. Opciones de personalización
  3. Configuraciones personalizadas
  4. Creando configuraciones personalizadas
  5. Codificar la configuración
  6. Building configuration file

Via the command line

PreviousBuilding configuration fileNextUsing GitHub Actions

Last updated 3 years ago

Prepare computer for building the configuration

Mapeo is built with JavaScript programming language. To get started, you'll need to installdevelopment environment. If you already have Node.js installed you can skip this section.

You need to be at least on Node.js version 8 (or higher) for the mapeo-settings-builder to work properly. Head over to page and select installer for your operating system.

Alternatively you can also use NVM (Node Version Manager) to install and manage multiple versions of Node.js on your computer.

Install nvm

touch ~/.bash_profile
curl -o- <https://raw.githubusercontent.com/creationix/nvm/v0.32.1/install.sh> | bash

Then close terminal and open again

Install homebrew (macOS)

Install npm

Install and use node 12

nvm install 12
nvm alias default 12

Install Mapeo Settings Builder

You'll see output on the terminal, but this is OK

npm install -g mapeo-settings-builder

Is your computer ready?

If your computer is ready to create configurations, type

mapeo-settings-builder

You should see output that looks something like

→ Using version x.x.x of mapeo-settings-builder
Usage: mapeo-settings-builder [options] [command]

Options:
  -h, --help                   display help for command

Commands:
  build [options] [sourceDir]  Build config from presets in current working dir
  lint [sourceDir]             Lint preset files for errors
  extract-messages [options]   Extract messages for translation
  generate-key                 Generate a random project key
  help [command]               display help for command

Now you're ready to move to build your configuration!

Package Config Assets for MAPEO

Prep folder and build

Type, 'cd`, then a space, then drag and drop the folder where the prepared assets are and press enter. It will look something like this

cd /Users/jen/Documents/Dd_LOCAL_project-files/Dd-Tools/Mapeo/Presets/CREATION\\ LAB/Strathcona-KX-v1.0.0

You will then be ready to run scripts directly in the folder.

npm install
npm run -s build

This -s tells npm to be silent, so that you only see errors that are meaningful to you.

You will see something like the following output. Errors will be highlighted in RED with hopefully some helpful description so that you can remedy the issue.

→ Using version x.x.x. of mapeo-settings-builder
! Warning: no category json files found in /home/okdistribute/node_modules/mapeo-default-settings/mapeo-default-settings-2.1.0/categories
✓ Built presets and categories (37ms)
✓ Generated svg sprite for iD (544ms)
✓ Generated png sprite for Mapbox (81ms)
✓ Generated png icons for Mapeo Mobile (607ms)
✓ Successfully created file 'build/mapeo-default-settings-v2.1.0.mapeosettings' (total 1299ms)

You'll also see a .mapeosettings file inside of the build directory.

What is a .mapeosettings file?

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 (such as 7zip, mentioned above).

Troubleshooting Checklist

Type the following into the terminal

node -v

You need to be at least on Node version 8 for the mapeo-settings-builder to work properly. If you need help, review the 'Preparing Computer' section and ensure you're on the latest version of mapeo-settings-builder.

npm install -g mapeo-settings-builder@latest

You also may want to delete node_modules and install updated versions of the dependencies.

In Mac or Linux, in the terminal:

npm install

Versioning

If you're having more issues, please or e-mail our support hotline.

It's important to increment the version when releasing new changes to your configuration. When you are ready to release a new version, you can use in the command line to automatically increment your config version and update the CHANGELOG.md file in your repository.

For more on versions with standard-version, see

⚙️
Node.js
Node.js download
http://brew.sh/
https://docs.npmjs.com/cli/install
open an issue on the GitHub repository
standard-version
Use conventional commit messages to increment your configuration version