Руководство по разработке руководства

Установка и рабочая среда

Для часто используемых операционных систем UNIX, таких как Mac OS X, Linux и FreeBSD, рекомендуется использовать следующую команду для установки непосредственно в терминал:

1
curl -s http://fibjs.org/download/installer.sh | sh

В Mac OS X вы также можете использовать Homebrew для установки последней версии fibjs:

1
brew install fibjs

Вы также можете загрузить соответствующую версию для установки или распространения. Вам также необходимо скачать и установить его самостоятельно под Windows.

Если вы хотите в любое время использовать новейшие функции в разработке или вам может потребоваться разработать собственную ветку, вы также можете самостоятельно скомпилировать последнюю версию.

Компилировать на Windows

Подготовьте среду компиляции

VS2017 должен быть установлен под Windows. Если вы хотите скомпилировать fibjs, совместимый с xp, вам также необходимо установить Windows XP support for C++ во время установки.

Получить код

Текущий адрес github для fibjs: https://github.com/fibjs/fibjs

Выполните следующую команду в рабочем каталоге:

1
git clone https://github.com/fibjs/fibjs.git --recursive

Если вы забыли добавить --recursive при клонировании, вы также можете войти в каталог fibjs для обновления вручную

1 2
cd fibjs git submodule update --init --recursive

Компилировать команды и инструкции

Windows Откройте терминал Developer Command Prompt , введите каталог fibjs и выполните команду:

1
build [options]

параметры:

  • clean : очистить результат компиляции, что удобно для перекомпиляции всех
  • release : компилировать в режиме релиза
  • debug : компилировать в режиме отладки
  • i386 : скомпилирован в 32-битном дистрибутиве
  • amd64 : скомпилировано в 64-битной версии
  • noxp : отключить режим совместимости с xp

Например, команда компиляции режима выпуска выглядит следующим образом:

1
build release

Инструмент сборки fibjs поддерживает xp-совместимый режим, который необходимо запускать вручную при компиляции:

1
build xp

Скомпилируйте себя под UNIX

Подготовьте среду компиляции

Компиляция под UNIX требует следующих инструментов:

1 2 3 4 5
CLANG 3.8 or newer GCC 4.8 or newer CMake 2.6 or newer GNU Make 3.81 or newer libexecinfo (FreeBSD and OpenBSD only)

В Mac OS X, в дополнение к необходимости установить Xcode и инструменты командной строки, возьмем brew в качестве примера, команды среды подготовки следующие:

1
brew install cmake git ccache

Команды среды подготовки Ubuntu:

1
apt install clang g++ make cmake git ccache

Если вы хотите скомпилировать 32-битную версию, вам также нужно установить multilib:

1
apt install g++-multilib

ARM в Ubuntu готовят следующие команды среды:

1
apt install g++-arm-linux-gnueabihf

Если вы хотите скомпилировать 64-битную версию ARM в Ubuntu, команда подготовки среды выглядит следующим образом:

1
apt install g++-aarch64-linux-gnu

Среда подготовки MIPS в Ubuntu выглядит следующим образом:

1
apt install g++-mips-linux-gnu

Если вы хотите скомпилировать 64-битную версию MIPS в Ubuntu, команда подготовки среды выглядит следующим образом:

1
apt install g++-mips64-linux-gnuabi64

исправить:

1 2 3 4 5 6
rm -f /usr/include/asm rm -f /usr/include/i386-linux-gnu rm -f /usr/include/x86_64-linux-gnux32 ln -s x86_64-linux-gnu /usr/include/i386-linux-gnu ln -s x86_64-linux-gnu /usr/include/x86_64-linux-gnux32

Команды среды подготовки Fedora:

1
yum install gcc-c++ libstdc++-static make cmake git

Если вы хотите скомпилировать 32-битную версию, подготовьте команду среды следующим образом:

1
yum install glibc-devel.i686 libstdc++-static.i686

Alpine готовит команды среды следующим образом:

1
apk add g++ linux-headers make cmake git libexecinfo-dev

FreeBSD (8,9) готовит команду среды следующим образом:

1
pkg_add -r cmake libexecinfo git

FreeBSD 10 и более поздние команды среды подготовки системы:

1
pkg install cmake libexecinfo git

Получить код

Текущий адрес github для fibjs: https://github.com/fibjs/fibjs

Выполните следующую команду в рабочем каталоге:

1
git clone https://github.com/fibjs/fibjs.git --recursive

Если вы забыли добавить --recursive при клонировании, вы также можете войти в каталог fibjs для обновления вручную

1 2
cd fibjs git submodule update --init --recursive

Компилировать команды и инструкции

В среде UNIX в корневом каталоге проекта fibjs есть сценарий оболочки сборки, который можно использовать для компиляции fibjs. Выполнить команду компиляции:

1
sh build [options] [-jn] [-v] [-h]

параметры:

  • clean : очистить результат компиляции, что удобно для перекомпиляции всех
  • release : компилировать в режиме релиза
  • debug : компилировать в режиме отладки
  • i386 : скомпилирован в 32-битном дистрибутиве
  • amd64 : скомпилировано в 64-битной версии
  • arm : кросс-компиляция 32-битной версии ARM
  • arm64 : кросс-компиляция 64-битной версии ARM
  • mips : кросс-компиляция 32-битной версии MIPS
  • mips64 : кросс-компиляция 64-битной версии MIPS
  • ppc : кросс-компиляция 32-битной версии PowerPC
  • ppc64 : кросс-компиляция 64-битной версии PowerPC

Например, команда компиляции режима выпуска выглядит следующим образом:

1
sh build release

Протестируйте все варианты использования

1
bin/{$OS}_{$arch}_release/fibjs test

Например:

1
bin/Linux_amd64_release/fibjs test

Вы можете начать выполнять все тестовые случаи fibjs. Содержимое {$ OS} проверяется самостоятельно.

Когда вы видите результаты, аналогичные приведенным ниже, все тестовые примеры работают нормально:

1 2 3 4 5 6 7 8 9 10 11 12 13
....... db √ escape √ formatMySQL sqlite √ empty sql √ create table √ intert √ select √ callback √ binary (835ms) √ 312 tests completed (6727ms)

Установить в систему

Вы можете использовать следующую команду для установки вновь скомпилированных fibjs в систему для простоты использования:

1
bin/{$OS}_{$arch}_release/install.sh

Начать программирование

До сих пор у вас есть исполняемая версия fibjs, вы можете начать получать удовольствие от разработки fibjs.

【【 hello, world