Guide 开发指南

安装运行环境

对于常用的 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 下自己编译

准备编译环境

Windows 下需要安装 VS2017。如果你希望编译兼容 xp 的 fibjs, 还需要在安装时选择安装 Windows XP support for C++

获取代码

fibjs 当前 github 地址为: https://github.com/fibjs/fibjs

在合适的位置执行以下命令:

1 2 3 4
git clone https://github.com/fibjs/fibjs.git cd fibjs git submodule init git submodule update

编译命令及说明

Windows 打开 Developer Command Prompt 终端,进入 fibjs 目录,执行命令:

1
build [options]

options 的选项:

  • clean: 清除编译结果,便于全部重新编译
  • release: 以发布方式编译
  • debug: 以调试方式编译
  • i386: 以 32 位发布方式编译
  • amd64: 以 64 位发布方式编译
  • noxp: 禁用 xp 兼容模式

例如 release 模式编译命令如下:

1
build release

fibjs build 工具支持兼容 xp 模式,编译时需要手动开启:

1
build xp

UNIX 下自己编译

准备编译环境

在 UNIX 下编译需要依赖以下工具:

1 2 3 4
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

Ubuntu 准备环境命令如下:

1
apt install g++ make cmake git

如果要编译 32 位版本,另需要安装 multilib:

1
apt install gcc-multilib g++-multilib

ARM on Ubuntu 准备环境命令如下:

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

如果要在 Ubuntu 上编译 ARM 64 位版本,准备环境命令如下:

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

MIPS on Ubuntu 准备环境如下:

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

如果要在 Ubuntu 上编译 MIPS 64 位版本,准备环境命令如下:

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

PowerPC on Ubuntu 准备环境命令如下:

1
apt install gcc-powerpc-linux-gnu g++-powerpc-linux-gnu

如果要在 Ubuntu 上编译 PowerPC 64 位版本,准备环境命令如下:

1
apt install gcc-powerpc64-linux-gnu g++-powerpc64-linux-gnu

fix:

1 2 3
rm -f /usr/include/asm 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

FreeBSD (8,9) 准备环境命令如下:

1
pkg_add -r cmake libexecinfo git

FreeBSD 10 及以上系统准备环境命令如下:

1
pkg install cmake libexecinfo git

获取代码

fibjs 当前 github 地址为: https://github.com/fibjs/fibjs

在合适的位置执行以下命令:

1 2 3 4
git clone https://github.com/fibjs/fibjs.git cd fibjs git submodule init git submodule update

编译命令及说明

UNIX 环境,在 fibjs 项目根目录,有一个 build 的 shell 脚本,可用于 fibjs 编译。 执行编译命令:

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

options 的选项:

  • 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 版本

例如 release 模式编译命令如下:

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