tmskit

# 常见问题

# 1. 微信开发者工具报：subPackages[0].root字段需为目录


当用户先打开微信开发者工具，再生成编译后的文件(dist)文件，会遇到此问题。解决方案：重新打开一次微信开发者工具即可

# 2. 项目在接入第三方仓库模块时，没有第三方仓库的下载权限

情况一：在项目根目录下创建tms.private.config.js(私人配置文件)，此文件可以根据模块配置相关git账号信息。 脚手架下载第三方代码时，会优先使用tms.private.config.js配置的账号信息。
ps: tms.config.js也可以存放账号信息，但是推荐放到tms.private.config.js(此文件不提交到仓库中，第三方账号信息不会外漏)

module.exports = {
  gitAccout: {
    // 模块名
    route: {
      // git用户名
      username: 'zhangsan',
      // git 密码
      pass: '***',
    },
  },
};
1
2
3
4
5
6
7
8
9
10
11

ps: sinan项目下载第三方git仓库的账号联系 @odilewang 获取

情况二：如果你在外网情况下且刚开IOA且在启动tmskit run dev时遇到下面错误。此时需要耐心等待5分钟，等待IOA进行数据同步。

# 3. 项目要接入第三方仓库模块，如何设置git账号信息

  1. 在git仓库的项目里添加成员账号

    ps: 如果git仓库是工蜂合作版 (opens new window)。给项目添加tms_account账号成员即可(该账号在工蜂合作版已开通)

  2. 将账号信息补充到tms.private.config.js里，并同步给 @odilewang

    ps: 如果git仓库是工蜂合作版 (opens new window)。tms_account账号密码联系@odilewang获取

# 4. 修改module.config.json、tms.config.js、 tms.private.config.js文件后没有生效

修改配置文件后，需要重新启动tmskit run dev命令

# 5. 如何单模块|全量模块开发？

方案一: 如果你启动了tms.private.config.js(私人开发配置文件)

  modules: {
    // 优先级include>exclude>blockRemote, 即：如果声明了include, 则会忽略exclude和blockRemote的设置。未指定include、exclude则跑全量模块.
    include: [ 'car']       //包含哪些模块, 填写模块磨成
    exclude: ['aggrecarshop'] // 排除哪些模块
    blockRemote: true, // 屏蔽第三方仓库的代码
  },
1
2
3
4
5
6

方案二: 没有启用tms.private.config.js(私人开发配置文件)

  启动多个模块时[,]分割 tmskit run dev -m home,aggre4s
  没有指定-m参数时，默认全量启动
1
2

# 6. tms.private.config.js指定了include的模块，但是没有编译该模块？

  1. 请确保你的模块在tms.config.js的modules.all声明包含了你的模块
  2. 在include指定的模块名称需与module.config.json的moduleName字段对应

# 7. tms.private.config.js指定了exclude的模块，但是没有排查该模块？

检查某个模块的module.config.json的dependencies是不是依赖了你指定的模块。dependencies 优先级大于 exclude字段。(原则是优先保障启动的稳定性)

# 8.dist目录中的含有未编译的ts文件？

  1. 首先，在project.config.json中的setting属性中检查是否含有以下字段

    "useCompilerPlugins": [
   "typescript",
   "less"
]
    1
    2
    3
    4

  2. 若不存在，请在project.config.json中的setting属性中加入以上字段。

# 9.遇到npm包找不到的时候

tmskit run install
1

# 10. 微信开发者工具"死循环"

错误：模拟器长时间没有响应，请确认你的业务逻辑中是否有复杂运算，或者死循环

解决方案：确保tmskit run dev启动完成后，再打开微信开发者工具。

ps: 重新启动微信开发者 或 重新导入项目

# 11. 主包大小超出大小限制

# 12. window系统无法加载文件tmskit.ps1，因为在此系统禁止运行脚本

解决方案一：不使用powershell下执行命令，vscode切换Command Prompt

解决方案二： 找到tmskit.ps1文件，删除该文件

Last Updated: 8/15/2022, 19:19:13