Theia开发环境搭建

官方Github地址 Developing文档

本文档根据官方GitHub开发文档的内容来搭建Theia开发环境，并记录在此过程中遇到的问题

环境信息（windows）

• 本人搭建时的环境信息
  • windows 10家庭版
  • node V12.18.0 (node -v查看版本)
  • python 2.7.15
  • git version 2.27.0
  • yarn 1.22.10
  • 安装windows-build-tools，同时会安装python2.7，安装时保证网络良好，或者自己下载后制定离线包位置即可，具体参见链接中github详细说明
    以管理员身份在PowerShell中运行如下命令：
    npm --add-python-to-path install --global --production windows-build-tools
    或者
    yarn global add windows-build-tools
    
    备注：
  • 由于桌面端IDE依赖的第三方包有node原生模块(C/C++写的node插件)，编译这些插件时需要用到windows-build-tools
  • 安装过程中可能会遇到的问题
  • 确保已安装node-gpy，一般node中默认带的有该依赖包；如果没有,则自行安装下：
    npm install -g node-gyp
• 官网对环境信息的说明
  • Node.js >= 12.14.1 && < 13，官网建议使用electron支持的最小版本12.14.1，我没有尝试不在所列范围内的版本，当然你可以自行尝试
  • 如果你需要在IDE中使用Git-extension，git version需要 >= 2.11.0
  • yarn 1.7.0
  • windows下建议使用scoop搭建环境，我没有使用此方法

指定部分包为国内源

我在安装的过程中，遇到两个包总是安装失败，如下所示：
npm config set electron_mirror https://npm.taobao.org/mirrors/electron/
npm config set PUPPETEER_DOWNLOAD_HOST https://npm.taobao.org/mirrors

编译浏览器端IDE

git clone https://github.com/eclipse-theia/theia.git && cd theia && yarn && yarn --cwd examples\browser start

• 从github克隆代码
• 改变工作目录到工程根目录
• 根据package.json安装依赖包
• 改变工作目录到examples/browser，且执行yarn start命令，编译启动应用
• 访问IDE- http://localhost:3000/

编译桌面端IDE

• 如果还没有下载代码，则执行如下命令：
  git clone https://github.com/eclipse-theia/theia \ && cd theia \ && yarn \ && yarn run rebuild:electron \ && cd examples/electron \ && yarn run start

1. 从github克隆代码
2. 改变工作目录到theia工程根目录
3. 根据package.json安装依赖包
4. 执行rebuild命令，此命令会使用electorn-rebuild模块中依赖的node-gyp来编译node原生模块，以保证与electorn中node版本一致，执行以后可以看到工程下面会生成.browser_modules目录，里面存放的就是rebuild之前的使用本机node编译的二进制插件
5. 改变工作目录到examples/electron，且执行yarn start命令，编译启动桌面端IDE
   备注：
   • 如果之前编译过broswer工程，则只需要执行4、5两步即可
   • 如果编译过桌面端IDE后，想再次执行broswer，则需要先更改工作目录到theia工程根目录，然后执行yarn run rebuild:browser，将之前的rebuild的原生模块还原，其实就是简单的copy替换
   • 所有的命令都在工程的packeage.json中的scripts属性下

本篇结束