Skip to content

Сборка API Карт

Jump to bottom
Dmitry Lutsik edited this page Jun 11, 2014 · 33 revisions

Возможности

Полная сборка приложения осуществляется с помощью gulp build. Команда принимает параметры, которые позволяют получить готовое приложение с необходимым набором плагинов.

Конфигурация

  • build/deps.js – список зависимостей модулей
  • .jshintrc – настройки JSHint

Проверка исходного кода с помощью JSHint

gulp lint

В случае ошибки отображается путь к файлу, номер строки, колонки и сообщение, например:

/home/dlutsik/projects/mapsapi-folder/src/DGGeoclicker/src/Controller.js
  line 12  col 21  Expected ':' and instead saw '/'.

✖ 1 problem

Сборка

Базовая команда, результатом которой будет полная сборка API:

gulp build

Результат (файлы игнорируются git):

  • public/js/script.js (исходный js код)
  • public/js/script.min.js (минимизированный js код)
  • public/css/styles.css (исходный css код без хаков для IE8)
  • public/css/styles.full.css (исходный css код c хаками для IE8)
  • public/css/styles.ie.css (исходный css код хаков для IE8)
  • public/css/styles.min.css (минимизированный css код без хаков для IE8)
  • public/css/styles.full.min.css (минимизированный css код c хаками для IE8)
  • public/css/styles.ie.min.css (минимизированный css код хаков для IE8)

Cборка API с указанием необходимых модулей:

gulp build --pkg=Module1,Module2,Module3

где Module1,Module2,Module3 - названия модулей API.

Например:

gulp build --pkg=DGGeoclicker,DGLocation

Cборка API по заранее описанным пакетами:

gulp build --pkg=package_name

где package_name - имя пакета. Список и описание доступных пакетов находится в файле build/packs.js.

Пример:

gulp build --pkg=basic

Cборка API с кастомной темой:

gulp build --skin=skin_name

при разработке плагина можно создать любую новую тему для него, если запрашиваемая тема не будет найдена, для плагина применится дефолтная 'light'. В базовой поставке доступны 2 темы 'light' и 'dark'. Чтобы сделать сборку исходников с темной темой, нужно передать параметр skin:

gulp build --skin=dark

Виды представления графики в сборке API:

gulp build --sprite=false/true

По умолчанию мы собираем style.css с svg иконками закодированными в base64, а style.full.css с иконками объединенными в спрайт. Можно принудительно задать способ представления графики параметром sprite.

Запуск веб-сервиса раздачи API

Запуск

node app

Пример вывода в консоль:

Maps API 2.0 server will run in 4 threads. Spawning the new processes...
PID #15372 started!
PID #15374 started!
PID #15375 started!
PID #15377 started!
Maps API 2.0 server listening on 3000

После запуска приложение доступно по адресу:

http://127.0.0.1:3000/2.0

Конфигурация веб-сервиса описывается в файле config.main.json, в котором заданы настройки по умолчанию, для переопределения параметров по умолчанию необходимо создать аналогичный файл config.local.json и переопределить нужные параметры, например:

{
    "DEFAULT_LANG": "en"
}
Clone this wiki locally