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
git clone https://github.com/fibjs/fibjs.git --recursive

如果clone 的時候忘記了添加--recursive,也可以進入fibjs 目錄手動更新

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

編譯命令及說明

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 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 libx11-dev

如果要編譯32 位版本,另需要安裝multilib:

1
apt install g++-multilib

ARM on Ubuntu 準備環境命令如下:

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

如果要在Ubuntu 上編譯ARM 64 位版本,準備環境命令如下:

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

如果要在Ubuntu 上編譯ARM v6 位版本,準備環境命令如下:

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

MIPS on Ubuntu 準備環境如下:

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

如果要在Ubuntu 上編譯MIPS 64 位版本,準備環境命令如下:

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

fix:

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

獲取代碼

fibjs當前github地址為: https://github.com/fibjs/fibjs

在工作目錄下執行以下命令:

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

如果clone 的時候忘記了添加--recursive,也可以進入fibjs 目錄手動更新

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

編譯命令及說明

UNIX 環境,在fibjs 項目根目錄,有一個build 的shell 腳本,可用於fibjs 編譯。執行編譯命令:

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

options 的選項:

  • clean: 清除編譯結果,便於全部重新編譯
  • release: 以發布方式編譯
  • debug: 以調試方式編譯
  • i386: 以32 位發布方式編譯
  • amd64: 以64 位發布方式編譯
  • arm: 交叉編譯32 位ARM 版本
  • armv6: 交叉編譯32 位ARM v6 版本
  • 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