使用Theia——构建你自己的IDE

  • 时间:
  • 浏览:0

上一篇:Theia架构

构建你自己的IDE

  本指南将教你咋样构建你自己的Theia应用。

必要条件

  你都要安装node 10版本(译者:事实上最新的node稳定版即可):

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.5/install.sh | bash
nvm install 10

  以及yarn:

  还都要确保已安装python 2.x,可通过python --version来检查。

安装

  首先请创建有一有另一个空目录,而且切换到某种目录下:

  在某种目录下创建package.json

{
  "private": true,
  "dependencies": {
    "typescript": "latest",
    "@theia/typescript": "next",
    "@theia/navigator": "next",
    "@theia/terminal": "next",
    "@theia/outline-view": "next",
    "@theia/preferences": "next",
    "@theia/messages": "next",
    "@theia/git": "next",
    "@theia/file-search": "next",
    "@theia/markers": "next",
    "@theia/preview": "next",
    "@theia/callhierarchy": "next",
    "@theia/merge-conflicts": "next",
    "@theia/search-in-workspace": "next",
    "@theia/json": "next",
    "@theia/textmate-grammars": "next",
    "@theia/mini-browser": "next"
  },
  "devDependencies": {
    "@theia/cli": "next"
  }
}

  简而言之,Theia应用进程和扩展包全部都是Node.js包。每有一有另一个包都包饱含一有另一个package.json文件,里边列出了包的一点元数据,如name、version、运行时和构建时的依赖关系等。

  亲戚亲戚朋友来看看某种包的内容:

  • nameversion被省略了,肯能亲戚亲戚朋友不打算将它作为有一有另一个依赖项来使用。并肩它被标记为private,肯能不打算将它发布为有一有另一个独立的Node.js包。
  • 亲戚亲戚朋友在dependencies中列出了所有运行时依赖的扩展包,如@theia/navigator
    • 一点扩展包都要额外的工具来进行安装,类事,@theia/python都要Python Language Server来安装。此时你都要参考相应的文档。
    • 都都还可以在这里查看所有已发布的扩展包。
  • 亲戚亲戚朋友将@theis/cli列为构建时的依赖项,它提供了构建和运行应用进程的脚本。

构建

  首先,安装所有的依赖项。

  而且,使用Theia CLI来构建应用进程。

  yarn在亲戚亲戚朋友应用进程的上下文中查找由@theia/cli提供的theia可执行文件,而且使用theia执行build命令。这肯能都要一点时间,肯能默认情况下应用进程会在production模式下进行构建,即它会进行模糊处理和最小化处理。

运行

  构建完成完后 ,亲戚亲戚朋友就都都还可以启动应用进程:

  给你在命令的第有一有另一个参数中指定有一有另一个workspace路径,--hostname--port选项用来指定部署的主机名和端口号。类事下面的命令在指定的位置和端口号上打开/workspace

yarn theia start /my-workspace --hostname 0.0.0.0 --port 100100

  在终端中,你应该看过Theia应用进程肯能启动并监听:

   打开浏览器并输入里边显示的地址,你就都都还可以打开应用进程了。

故障排除

通过代理构建本地依赖项

  肯能你通过代理运行yarn命令,在构建本地依赖项时有肯能会遇到一点难题(如onigurma),类事下面的某种错误:

[4/4] Building fresh packages...
[1/9]  XXXXX
[2/9]  XXXXX
[3/9]  XXXXX
[4/9]  XXXXX
error /theiaide/node_modules/XXXXX: Command failed.
Exit code: 1
Command: node-gyp rebuild
Arguments:
Directory: /theiaide/node_modules/XXXXX
Output:
gyp info it worked if it ends with ok
gyp info using node-gyp@3.8.0
gyp info using node@8.15.0 | linux | x64
gyp http GET https://nodejs.org/download/release/v8.15.0/node-v8.15.0-headers.tar.gz
gyp WARN install got an error, rolling back install
gyp ERR! configure error
gyp ERR! stack Error: read ECONNRESET
gyp ERR! stack at TLSWrap.onread (net.js:622:25)
gyp ERR! System Linux 3.10.0-862.11.6.el7.x86_64
gyp ERR! command "/usr/bin/node" "/usr/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js" "rebuild"
gyp ERR! cwd /theiaide/node_modules/XXXXX
gyp ERR! node -v v8.15.0

  这是肯能node-gyp在system/NPM的代理设置中不工作。肯能遇到某种情况,都都还可以通过错误堆栈中提供的链接下载node-headers文件(如里边例子中的https://nodejs.org/download/release/v8.15.0/node-v8.15.0-headers.tar.gz),而且使用下面的命令进行构建:

npm_config_tarball=/path/to/node-v8.15.0-headers.tar.gz yarn install

原文地址:https://theia-ide.org/docs/composing_applications/