安裝運作環境

對於常用的UNIX 作業系統，例如Mac OS X, Linux 和FreeBSD，建議在終端機使用下面的指令直接安裝:

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

在Mac OS X 下，也可以選擇使用Homebrew 來安裝最新版的fibjs:

1
brew install fibjs

你也可以選擇自行下載合適的版本，用於安裝或自行分發。Windows 下方也需要自行下載安裝。

如果你想隨時擁有開發中的最新特性，或者你可能需要自行開發自己的分支，也可以自己編譯最新的版本。

Windows 下自己編譯

準備編譯環境

Windows 下需安裝VS2019 或以上版本，注意：安裝時需選擇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 位元發布方式編譯
• arm64: 交叉編譯ARM64 版本

例如release 模式編譯指令如下:

1
build

UNIX 下自己編譯

準備編譯環境

Mac OS X 下，除需要安裝Xcode 及命令列工具外，以brew 為例，準備環境指令如下:

1
brew install cmake git ccache

Ubuntu 準備環境指令如下:

1
apt install clang g++ make cmake git ccache libx11-dev

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

Fedora 準備環境命令如下:

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

如果要編譯32 位元版本，準備環境指令如下:

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

Alpine 準備環境指令如下:

1
apk add clang g++ linux-headers make cmake git libx11-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
bash build [options] [-jn] [-v] [-h]

options 的選項:

• clean: 清除編譯結果，以便全部重新編譯
• release: 以發布方式編譯，預設選項
• debug: 以調試方式編譯
• linux: 使用預先安裝的docker 環境編譯Linux 版本
• alpine: 使用預先安裝的docker 環境編譯alpine 版本
• android: 使用預先安裝的docker 環境編譯android 版本
• iphone: 使用預先安裝的docker 環境編譯iphone 版本
• i386: 以32 位元發布方式編譯
• amd64: 以64 位元發布方式編譯
• arm: 交叉編譯ARM 版本
• arm64: 交叉編譯ARM64 版本
• mips64: 交叉編譯MIPS64 版本
• ppc64: 交叉編譯PowerPC64 版本
• loong64: 交叉編譯LoongArch64 版本

例如release 模式編譯指令如下:

1
bash build

測試全部用例

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】