Io 程式設計/初學者指南/入門

入門

Posix 系統

Io 主要是在基於 Unix 的系統上開發的，最著名的是 MacOS X。因此，在這些系統上構建和使用 Io 最容易。Io 已成功編譯在 MacOS X、Linux 和各種 BSD 上，並且應該可以在符合 Posix 標準且具有 C99 相容編譯器的任何系統上順利編譯。

下載原始碼

首先，您需要下載原始碼。建議從 git 倉庫獲取程式碼

$ git clone https://github.com/stevedekorte/io.git

或者，您可以在以下網站找到下載：http://iobin.suspended-chord.info/

編譯

現在您已經下載了 Io，讓我們構建它！為此，請更改到新建立的目錄並建立一個目錄以執行構建

您需要 cmake

$ cd io
$ mkdir build && cd build

從這個目錄，我們想要執行 CMake，它將以與 autotools 為其他專案相同的方式識別環境並生成 makefile

$ cmake ..

這將檢查您擁有哪些庫，以及您沒有哪些庫，並根據您擁有的依賴項確定哪些附加元件可以構建。如果您在非標準位置安裝了庫（例如，zlib 在 /opt/zlib 或 ~/zlib/ 中），那麼您需要執行 CMake 的圖形配置工具之一併告訴它它們的位置，然後再次配置它。ccmake 幾乎總是可用的，cmake-gui 可用於 OS X、Windows 和一些 Linux 發行版等主要平臺

$ cmake-gui ..

要構建 IoVM 和任何可以從您計算機上的原始檔和庫檔案構建的附加元件，只需執行make！

$ make

如果您在編譯時遇到問題，您可能沒有所有必要的依賴項。確保您已安裝作業系統編譯工具（這通常是 GCC），因為一些 Linux 版本如果沒有明確告知，在設定系統時就不會提供這些工具。

安裝

等待一會兒（在 MacBook 上大約需要一分鐘），它應該成功編譯所有內容；然後您可以將其安裝到您的系統中，如下所示

$ make install

或者

$ sudo make install

這將把二進位制檔案io 和io_static 放入安裝路徑（通常為二進位制檔案/usr/local/bin，庫檔案/usr/local/lib；兩者都可以透過使用 CMake 配置工具更改安裝路徑來更改），以及libbaselib.dylib、libgarbagecollector.dylib、libcoroutine.dylib 和libiovmall.dylib。

注意：Io 使用的 CMake 指令碼目前不會安裝用於嵌入的標頭檔案，這必須手動完成。

Linux

安裝後，您可能需要配置 Linux 上的 ld。將以下行新增到 /etc/ld.so.conf

include /usr/local/lib

然後重新配置 ld（，或將當前目錄與新構建的 Io 環境新增到路徑中）

sudo ldconfig

已確認適用於 Ubuntu 10.10。請注意，您的使用者可能沒有編輯 /etc/ld.so.conf 的許可權 - 在這種情況下，sudo gedit /etc/ld.so.conf 可能會起作用。更多替代方案和討論這裡。

Debian，非預設安裝目錄，缺少 cmake

此配方（編寫於 20101018）涵蓋了在 Debian 5.0.6 上的安裝，以及處理非預設安裝目錄的指南，以及如果您的作業系統沒有最新版本的 cmake 該怎麼辦。$MYIROOT 被假定為安裝樹的根目錄（例如，在您的主目錄中 - 但透過新增適當的su(do) 命令，這將適用於/usr/local 和類似的非預設系統範圍的安裝樹）。

Debian 5.0.6 沒有足夠新的版本的 cmake 來滿足當前版本的 Io（需要 2.8，Debian 有 2.6）。以下命令檢索並安裝 cmake-2.8.2（apt-get 命令確保安裝任何構建先決條件）

  $ sudo apt-get build-dep cmake
  $ sudo apt-get install libssl-dev
  $ cd /tmp
  $ wget http://www.cmake.org/files/v2.8/cmake-2.8.2.tar.gz
  $ tar xzf cmake-2.8.2.tar.gz
  $ cd cmake-2.8.2
  $ ./configure --prefix=$MYIROOT
  $ make
  $ make install

整理

  $ cd /tmp
  $ rm -fr cmake-*</shell>

Next, for Io you can more-or-less iterate through the generic Linux instructions:

<syntaxhighlight lang="shell">
  $ git clone git://github.com/stevedekorte/io.git
  $ cd io/build
  $ ccmake ..
  [hit 'c' to configure, change CMAKE_INSTALL_PREFIX to
   the value of $MYIROOT, then hit 'g' to generate and quit]
  $ make
  $ make install

整理

  $ cd /tmp
  $ rm -fr io

如果您無法使用上面描述的 ldconfig 命令，則非標準安裝位置將需要 LD_LIBRARY_PATH 來包含安裝 Io 的 libbasekit.so 等庫所在的 lib 目錄。

啟動！

Io 現在已安裝，可以使用以下命令啟動

io

如果您只鍵入io，您將進入互動式直譯器。要退出互動式直譯器，請按 Ctrl-D 或鍵入exit。·

注意

如果您在io 後鍵入內容，它將被解釋為檔名，即使它類似於--help 或--version，這些應該被解釋為選項。

收尾工作

現在我們可以測試安裝以檢視是否一切按預期工作。

$ make test

或者，您可以自由清理構建目錄

$ make clean

Windows 系統

Io 的預編譯二進位制檔案存在於Io 下載頁面，並且目前是建議在該平臺上使用 Io 的方法。在撰寫本文時，自己編譯它並不容易，並且需要使用像 MSYS 或 Cygwin 這樣的 Unix 模擬工具。