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

TypeScript环境搭建_第1张图片

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

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

TypeScript环境搭建_第2张图片

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

/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 两个源文件,目录结构和源文件内容如下

TypeScript环境搭建_第3张图片

三、配置编译和调试文件

在.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

TypeScript环境搭建_第4张图片

其他相关内容

当前非常流行的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文件
    ]
}

你可能感兴趣的:(TypeScript环境搭建)