TypeScript环境搭建

• 阅读目录**

  • [环境搭建]

  • [第一部分、简介]

  • [第二部分、环境准备]

  • [第三部分、使用Visual Studio Code进行开发]

  • [其他相关内容]

  [环境搭建]

  本篇将简单介绍一下TypeScript，并记录开发环境的搭建、使用Visual Studio Code进行一个简单的Demo开发过程。

  第一部分、简介

  TypeScript是一种由微软开发的自由和开源的编程语言。是JavaScript的一个超集。它在保留JavaScript语言本身特性的基础上添加了大量静态语言具有的一些特性，包括但不限于以下几点：

  • • 可选的静态类型

    • 枚举、接口和类

    • 命名空间

    • 模块

    • Lambda表达式

    • 编译时类型检查

  在2013年6月微软正式发布了0.9版。之后在不断更新的过程中逐渐支持ECMAScript 2015（ES6）标准。

  通过利用静态语言的特性和新标准，使JavaScript开发变得越来越简单。同时也很好的符合当前前端开发的模块化、工程化的开发方式和潮流。

  第二部分、环境准备

  一、安装Node.js

  安装文件下载地址：Node.js Downloads。TypeScript源码需要进行编译以后才能运行，Node.js提供了编译环境。

  二、安装TypeScript编译工具

  安装好Node.js后，打开cmd窗口，输入以下命令

  npm install -g typescript

  使用npm包管理工具下载TypeScript包并在全局环境下安装，安装成功后就可以通过 tsc 命令编译TypeScript源码。

  可以通过 tsc -v 命令查看当前TypeScript版本。当前最新版本是：1.8

  

  第三部分、使用Visual Studio Code进行开发

  以下目录结构是一个简单的Demo的结构

  

  主要包括但不限于以下几个目录和文件

  /ts：TypeScript源码文件存放的文件夹

  /js：编译之后生成的JavaScript文件存放的文件夹

  tsconfig.json：TypeScript编译配置文件

  另外.vscode是VS Code开发工具特有的文件夹，主要用来存放调试时需要用到的配置文件。

  一、tsconfig.json

  {
   "compilerOptions": {
   "target": "es5",
   "noImplicitAny": false,
   "module": "commonjs",
   "removeComments": true,
   "sourceMap": false,
   "outDir": "js"
   },
   "include":[
   "ts"
   ],
   "exclude": [
   "js"
   ]
  }

  有几个重要的属性需要解释一下：

  • • target：编译之后生成的JavaScript文件需要遵循的标准。有三个候选项：es3、es5、es2015。

    • noImplicitAny：为false时，如果编译器无法根据变量的使用来判断类型时，将用any类型代替。为true时，将进行强类型检查，无法推断类型时，提示错误。

    • module：遵循的JavaScript模块规范。主要的候选项有：commonjs、AMD和es2015。为了后面与node.js保持一致，我们这里选用commonjs。

    • removeComments：编译生成的JavaScript文件是否移除注释。

    • sourceMap：编译时是否生成对应的source map文件。这个文件主要用于前端调试。当前端js文件被压缩引用后，出错时可借助同名的source map文件查找源文件中错误位置。

    • outDir：编译输出JavaScript文件存放的文件夹。

    • include、exclude：编译时需要包含/剔除的文件夹。

  二、添加Demo源文件

  在ts文件夹添加 app.ts 和 demo.ts 两个源文件，目录结构和源文件内容如下

  

  三、配置编译和调试文件

  在.vscode里添加tasks.json文件

  {
   // See https://go.microsoft.com/fwlink/?LinkId=733558
   // for the documentation about the tasks.json format
   "version": "0.1.0",
   "command": "tsc",
   "isShellCommand": true,
   "args": ["-p", "."],
   "showOutput": "always",
   "problemMatcher": "$tsc"
  }

  切换到调试模式，点击配置按钮，选择Node.js环境。因为接下来的Demo演示都将在Node.js环境下进行。

  

  修改生成的launch.json文件内容，指定启动入口文件的路径

  {
   "version": "0.2.0",
   "configurations": [
   {
   "name": "启动",
   "type": "node",
   "request": "launch",
   "program": "${workspaceRoot}/js/app.js",
   "stopOnEntry": false,
   "args": [],
   "cwd": "${workspaceRoot}",
   "preLaunchTask": null,
   "runtimeExecutable": null,
   "runtimeArgs": [
   "--nolazy"
   ],
   "env": {
   "NODE_ENV": "development"
   },
   "externalConsole": false,
   "sourceMaps": false,
   "outDir": null
   },
   {
   // ......
   },
   {
   // ......
   }
   ]
  }

  以上配置完成后，使用 Ctrl+Shift+B 启动编译，如果VS Code的OUTPUT窗口没有任何异常信息显示，则表示编译成功。在js文件夹里将会生成编译后的JavaScript文件

  demo.js

  var Demo = (function () {
  function Demo(a, b) {
  this.a = a;
  this.b = b;
  }
  Demo.prototype.sum = function () {
  return this.a + this.b;
  };
  return Demo;
  }());
  exports.Demo = Demo;

  app.js

  "use strict";
  var demo_1 = require('./models/demo');
  var demo = new demo_1.Demo(1, 2);
  console.log(demo.sum());

  对比TypeScript源码文件和生成之后的JavaScript文件，结构发生了较大变化。

  启动调试，查看调试控制台，输出了正确的计算结果：3

  

  其他相关内容

  当前非常流行的JavaScript模块规范主要遵循以下两种：

  • • CommonJS：同步模式加载模块，主要应用在服务端。Node.js模块化就遵循此规范。使用方式： require(‘模块名’) 。

    • AMD：异步模式加载模块，主要应用在浏览器端。RequireJS遵循此标准。使用方式： define([‘模块名1’, …], function(‘模块参数1’, ….) { })

创建第一个TypeScript文件

• 新建一个目录，在该目录下新建一个文件HelloWorld.ts
• 打开文件在文件内输入如下内容，涉及部分ts的语法就不讲了：

class Test {
    private name:string = "Hello world";

    public constructor () {
        console.log("constructor==========>>>" + this.name);
    }

    public testFun():void {
        console.log("testFun===========>>>" + this.name);
    }
}

function testCallFun():void {
    let t = new Test();
    t.testFun();
}

• 编译ts文件

>tsc HelloWorld.ts

• 这样就将ts文件编译成了js文件，内容如下：

var Test = (function () {
    function Test() {
        this.name = "Hello world";
        console.log("constructor==========>>>" + this.name);
    }
    Test.prototype.testFun = function () {
        console.log("testFun===========>>>" + this.name);
    };
    return Test;
}());
function testCallFun() {
    var t = new Test();
    t.testFun();
}

• 这里将这个js文件放到html页面上进行测试，控制台输出如下：

constructor==========>>>Hello world
testFun===========>>>Hello world

这样一套完整的工作流就完成了，生成的js文件可以用在各种项目中，Egret项目、cocos项目或者Web项目都可以。通过这种方式可以积累自己的类库，方便做项目时快速开发。

工程配置

tsconfig.json

• 如果一个目录下存在一个tsconfig.json文件，那么它意味着这个目录是TypeScript项目的根目录。 tsconfig.json文件中指定了用来编译这个项目的根文件和编译选项。
• 在执行tsc时，编译器会在当前目录向父级目录逐级查找tsconfig.json文件，也可以使用命令行参数–project（或-p）指定一个包含tsconfig.json文件的目录
• 例子:

{
    "compilerOptions": {
        "module": "system",
        "noImplicitAny": true,
        "removeComments": true,
        "preserveConstEnums": true,
        "outFile": "../built/ituuzx/itz.js"
    },
    "include": [
        "**/*.ts"   //include是指编译包含的文件或目录，这是配置的是包括子目录下的所有ts文件
    ]
}