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 模拟工具。