jsdk-offical/docs/zh/quick.md

JSDK is the most comprehensive TypeScript framework, like JDK.

JSDK 2.0+是最全面的TS/JS框架，包括了从最底层到最上层的大量特性、框架与工具。<br>
它非常适合做任何JS库的基石，就像JDK在Java中的作用那样。

主要支持以下特性： 
<p class="warn">
注解、反射、切面、组件与依赖注入、线程、定时器、单元测试、事件总线、动画库、二维绘图、应用框架，还提供一组高级UI组件及强大的工具箱。
</p>
基于JSDK来开发你的类库、组件、应用甚至游戏，你的开发工作将得到巨大的助力。

## 下载
从<code>Github</code>上下载: https://github.com/fengboyue/jsdk/releases

或从 <code>npm</code> 上下载:
```shell
npm install jsdk-offical -g
```

## 用法
HTML中先加载JSDK的核心库及全局配置文件：
```html
<script src="{PROJECT-URL}/libs/jsdk/{JSDK-VERSION}/jscore.min.js"></script><!-- ziped: 4kb -->
<script src="{PROJECT-URL}/libs/jsdk/{JSDK-VERSION}/jsdk-config.js"></script><!-- unziped: 5kb -->
```
TS／JS代码中加载需要的类库（或JS文件）再调用其API：
```javascript
/// <reference path="../libs/jsdk/{JSDK-VERSION}/jsdk.d.ts" /> 
JS.imports([
    '$jsunit' //Suppose you need to load jsunit library for unit-test
]).then(()=>{
    TestRunner.addTests([
        ......
    ]);
    TestRunner.run();
});
```
* *JSDK的类库定义请参看“类库管理”章节*

## 基础知识 
JSDK 2.0+是基于 <code>ES6 / TypeScript 2.0+</code> 编写的。

如果你第一次接触JSDK，那么你需要先具备以下基础知识：
> ES6的核心语法及新API，比如：类定义／多行字符串／箭头函数／原生类型的新API/Promise等
>
> TypeScript 2.0+ 语法及编译参数
>
> VSCode开发工具的安装与设置，工程的配置与编译

*备注：*
* *如果你仅在普通JS工程中使用JSDK，则无需学习 TypeScript 和 VSCode*
* *我<b>强烈建议你在TS工程中使用JSDK</b>，这将让JSDK的全部特性都生效*
* *如果你需要在不支持ES6的浏览器上运行JSDK，请先加载 [Babel](https://babeljs.io/docs/en/) 或 [es6-shim](https://github.com/paulmillr/es6-shim)*

## 在线资源
你可以访问以下在线资源了解更多：
<p class="warn">
<a href="https://fengboyue.github.io/jsdk/docs/#/zh/quick" target="_blank">JSDK开发指南</a>
<br>
<a href="https://fengboyue.github.io/jsdk/tests" target="_blank">JSDK自测用例</a>
<br>
<a href="https://fengboyue.github.io/jsdk/examples" target="_blank">JSDK示例</a>
<br>
<a href="https://fengboyue.github.io/jsdk/api" target="_blank">JSDK API文档</a>
</p>

## 启动本地资源
启动本地Http Server，访问上述资源将会更快。
1. 假设你本地JSDK安装目录为<code>{JSDK-INSTALL}</code>。
2. 在你本机运行一个Http Server，设置服务器的Web路径 <code>http://localhost/jsdk/</code> 指向你的<code>{JSDK-INSTALL}</code>。
3. 打开浏览器访问此Web地址。

## 许可协议
JSDK自2.0版开始支持MIT许可协议。
* *JSDK发布包中所引入的其他开源类库受其申明的许可协议保护*

## 更新日志

### v2.7.0 - Milestone
- Update "jscore" for micro kernel.
- Update "jsan" for new tween and frame animations.
- New tool classes such as CssTool, Images, Objects.
- Fix some bugs.

## 旧版本
<a href="https://github.com/fengboyue/jsdk-0.x" target="_blank">
0.X版本的JSDK</a>已不再升级与维护，请使用最新版本。