# 快速开始

安装环境:v10.15.0+ 、npm 6.4.1+

// npm 淘宝镜像设置
npm config set registry https://registry.npm.taobao.org
// 查看 淘宝镜像设置是否成功
npm config get registry
// 全局安装
npm i -g tm-cli
// 查看所有命令
tm

# 命令参数说明

- tm 查看全部命令
- tm -v 查看版本
- tm i 初始化项目模板选择,构建新的项目(以中后台项目为主)
- tm start 开发环境 默认打开 http://localhost:9090。可选参数 -e 可添加自定义  process.env.APP_ENV 的值,可作为区分应用环境。同时 process.env 中默认内置了版本号的标记和构建时间戳的标记
- tm build  部署构建打包,生成dist目录。可选参数 -e 同上 项目初始化浏览器控制台会打印 process.env 中的配置信息比如版本、构建时间
- tm mock 简单快速构建本地静态服务器和api服务
- tm npm-x 小程序低版本npm组件管理

查看对应命令详细使用帮助 比如 tm mock --help 则可以查看mock下所有参数说明

# 创建新项目

  1. cd 到目标文件下执行 tm i 初始化项目选择模板
    • element-kylin-admin (接入kylin项目,需要向前端部门申请授权,否则无法下载)
    • tpl-admin-vue (非kylin项目)
  2. 如果安装依赖失败,请手动执行安装依赖 npm i
  3. npm start 启动项目, 浏览器会自动打开访问地址 http://127.0.0.1:9090 (注意看控制台最终显示的端口为准)

# 默认配置tm.config.js

  • 简单-开发环境配置方式 (0.2.0-beta.10+)
module.exports ={
     "devServer":{
        //"port": 9090,
        "proxy": {
          '/api': {
              "target": "http://10.0.75.1:8900",
              "pathRewrite": {
                  // '^/api': '',
                  '^/api': '_api',// 配合本地 tm mock 命令配置
              },
              "changeOrigin": true // target是域名的话,需要这个参数,
              // "secure": false,  // 使用的是https,会有安全校验,所以设置secure为false
          }
        },
      },
}

  • 详细-开发环境配置方式
module.exports = {
    // tm-build
    "buildConfig":{
        // 开发环境
        "dev":{
            // webpack 内的键名 必须 和webpack 原始 api 配置参数要求一致否则会报错
            "webpack":{
                // webpack-server-dev 配置 跨域代理
                "devServer":{
                    // "port": 9090,
                    // "proxy": {
                    //   '/api': {
                    //       "target": 'http://areaboss-qa2.xsts.xyz',
                    //       "pathRewrite": {
                    //           '^/api': ''
                    //       },
                    //       "changeOrigin": true // target是域名的话,需要这个参数,
                    //       // "secure": false,          // 使用的是https,会有安全校验,所以设置secure为false
                    //   }
                    // },
                },
                // 自定义添加webpack插件
                // "plugins":[],
            }
        },
        // 打包自定义配置
        "build": {
            //"appScene":"",// 适用场景: WMS(中后台项目)、H5、""(空则为普通开发插件打包)
            // "webpack":{
                // "output":{
                //   "publicPath": '/', // CDN 静态公共路径
                // },
                // "optimization":{}
            // }
        }
    }
}