<! -- Quick to get started -->

Quick to get started ​

This article will help you start and build this project from scratch.

Vue2 version ​

Environmental Preparation ​

Local environment requires Node.js 14.x, Git ::: Warm Tips for warning🎯

• 14 is recommend for node.js. If you maintain two versions at the same time, use nvm to switch the node version.

• use taobao (https://registry.npmmirror.com/) or npmMirror (https://skimdb.npmjs.com/registry/) for npm image sources. you can use the nrm tool to quickly switch npm sources. :::

nvm use 14

nrm use taobao

• nvm教程💯: https://lisaisai.blog.csdn.net/article/details/145481541?spm=1001.2014.3001.5502。
• nrm教程💯: https://lisaisai.blog.csdn.net/article/details/145481783?spm=1001.2014.3001.5502

Code Pull ​

Pull code from Gitee:

# 克隆代码
git clone https://gitee.com/ITdos/microi.net.git

Pull code from GitCode:

# 克隆代码
git clone https://gitcode.com/microi-net/microi.net.git

Installation and use steps ​

Open Terminal: ​

# 进入前端文件夹
cd X:\microi.net\microi.vue2.full

Install dependencies: ​

nvm use 14
npm install nrm -g
# 📌如果taobao不行用 nrm use npmMirror
nrm use taobao 
npm install

To run the project: ​

npm run dev

Packaged items: ​

npm run build

npm script details ​

{
	"scripts": {
    //本地运行(dev环境)
    "dev": "vue-cli-service serve", 
    //构建打包(dev环境)
    "build": "vue-cli-service build",
    //构建打包(生产环境)
    "build:prod": "vue-cli-service build",
     //构建打包(测试环境)
    "build:stage": "vue-cli-service build --mode staging",
    //本地运行(预览环境)
    "preview": "node build/index.js --preview",
    //svg图片处理
    "svgo": "svgo -f src/icons/svg --config=src/icons/svgo.yml",
    //打包lib
    "lib": "vue-cli-service build --target lib --name microi.net.vue --dest lib index.js"
}

Precautions‼️ ​

If other errors occur in the above steps, you can try the following steps:

1. Deletenode_modules
2. Deletepackage-lock.json
3. Execute#npm cache clean --force
4. Re-execute#npm installInstallation Environment Steps

Other possible issues:

• Error: '/node_modules/monaco-editor@0.33.0 @ monaco-editor/esm/vs/basic-languages/.contribution.js Failed to compile with 1 error in ./node_modules/monaco-editor/esm/vs/basic-languages/_.contribution.js'

• Resolved: From the following 5 variables (in about 30 + lines of code)LazyLanguageLoaderMove inside to above, usevarDeclare it.

  js

  var _languageId;
  var _loadingTriggered;
  var _lazyLoadPromise;
  var _lazyLoadPromiseResolve;
  var _lazyLoadPromiseReject;
  var LazyLanguageLoader = class { ......

  1
  2
  3
  4
  5
  6
  

Switch back-end interface address ​

1.request.jsFile ModificationbaseURLParameters 2.itdos.osclient.jsFile Modification

try {
        //如果是苹果电脑
        if (navigator.platform.toUpperCase().indexOf('MAC') >= 0) {
          return 'https://api.itdos.com'//用于发布到开源gitee
        } else {//如果是非苹果电脑
          return 'https://localhost:7268'//用于发布到开源gitee （在这里修改）
        }
      } catch (error) {
        return 'https://api.itdos.com'
      }

Vue3 version (to be developed) ​

Environmental Preparation ​

Local environment requires Node.js 18.x , Git ::: Warm Tips for warning🎯 Node.js version recommend 18. If you maintain two versions at the same time, use nvm to switch the node version.

use taobao (https://registry.npmmirror.com/) or npmMirror (https://skimdb.npmjs.com/registry/) for npm image sources. you can use the nrm tool to quickly switch npm sources. :::

nvm use 18

nrm use taobao

• nvm教程💯: https://lisaisai.blog.csdn.net/article/details/145481541?spm=1001.2014.3001.5502。
• nrm教程💯: https://lisaisai.blog.csdn.net/article/details/145481783?spm=1001.2014.3001.5502

Tool Configuration ​

This project recommend use VSCode for development, the project has built-in VSCode configuration, including recommend plug-ins and settings.

🌈recommend install the following plug-ins:

• Vue Language Features (Volar) = => Vue3 official plugin
• TypeScript Vue Plugin (Volar) ==> Vue3 official plug-in (TypeScript)
• Vue 3 Snippets ==> Vue3 code hint
• ESLint ==> Code Check
• Stylelint ==> CSS Code Checking & & Formatting
• Prettier - Code formatter ==> Code Formatting
• EditorConfig for VS Code ==> Unify the coding style of different editors
• Code Spell Checker ==> check word spelling errors
• Sass ==> Sass style writing
• DotENV ==> Highlight. env file

.vscode > extensions.json ​

{
	"recommendations": ["vue.volar", "vue.vscode-typescript-vue-plugin", "hollowtree.vue-snippets", "dbaeumer.vscode-eslint", "stylelint.vscode-stylelint", "esbenp.prettier-vscode", "editorconfig.editorconfig", "streetsidesoftware.code-spell-checker", "syler.sass-indented", "mikestead.dotenv"]
}